# "Tạo tác vụ black-forest-labs/flux-kontext-max"

Nguồn: https://docs.openaihub.net/api-45208952/

> API origin: `https://api.openaihub.net`. Chọn đúng nhóm API và model. Thông số dưới đây là bản tham chiếu kỹ thuật; chưa phải kết quả kiểm thử từng endpoint bằng tài khoản của bạn.


## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /replicate/v1/models/black-forest-labs/flux-kontext-max/predictions:
    post:
      summary: Tạo tác vụ black-forest-labs/flux-kontext-max
      deprecated: false
      description: >-
        Tài liệu chính thức:
        https://replicate.com/black-forest-labs/flux-kontext-max
      operationId: >-
        replicate_replicate_v1_models_black_forest_labs_flux_kontext_max_predictions
      tags:
        - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao
        - Tái tạo
      parameters:
        - name: Authorization
          in: header
          description: Khóa API Bearer
          required: false
          example: Bearer {{YOUR_API_KEY}}
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                input:
                  type: object
                  required:
                    - prompt
                  properties:
                    aspect_ratio:
                      type: string
                      description: >-
                        Tỷ lệ khung hình của hình ảnh được tạo. Sử dụng
                        "match_input_image" để khớp với tỷ lệ khung hình của
                        hình ảnh đầu vào. Giá trị mặc định: "match_input_image".
                    input_image:
                      type: string
                      description: >-
                        Hình ảnh dùng làm tài liệu tham khảo. Phải có định dạng
                        jpeg, png, gif hoặc webp.
                    output_format:
                      type: string
                      description: >-
                        Định dạng đầu ra của hình ảnh được tạo. Giá trị mặc
                        định: "png".
                    prompt:
                      type: string
                      description: >-
                        Mô tả bằng văn bản về nội dung bạn muốn tạo, hoặc hướng
                        dẫn cách chỉnh sửa một hình ảnh được cung cấp.
                    prompt_upsampling:
                      type: boolean
                      description: 'Tự động cải thiện lời nhắc. Giá trị mặc định: false.'
                    safety_tolerance:
                      type: integer
                      description: >-
                        Mức dung sai an toàn, 0 là nghiêm ngặt nhất và 6 là lỏng
                        nhất. 2 hiện là giá trị tối đa được phép khi sử dụng
                        hình ảnh đầu vào. Giá trị mặc định: 2. Giá trị tối
                        thiểu: 0, giá trị tối đa: 6.
                  description: Vui lòng cung cấp nội dung tài liệu cần dịch.
                  x-apifox-orders:
                    - aspect_ratio
                    - input_image
                    - output_format
                    - prompt
                    - prompt_upsampling
                    - safety_tolerance
                  x-apidog-orders:
                    - aspect_ratio
                    - input_image
                    - output_format
                    - prompt
                    - prompt_upsampling
                    - safety_tolerance
              x-apifox-orders:
                - input
              x-apidog-orders:
                - input
            examples:
              black_forest_labsflux_kontext_max_single:
                value:
                  input:
                    aspect_ratio: match_input_image
                    input_image: >-
                      Vui lòng tải ảnh lên trực tiếp hoặc dán nội dung tài liệu
                      để tôi có thể dịch sang tiếng Việt và giữ nguyên định dạng
                      Markdown, mã, định danh, URL, đường dẫn, chỗ giữ chỗ cùng
                      cấu trúc JSON.
                    output_format: jpg
                    prompt: >-
                      Làm cho các chữ cái có hiệu ứng 3D, lơ lửng trong không
                      gian trên một con phố thành thị
                    prompt_upsampling: false
                    safety_tolerance: 2
                summary: black_forest_labsflux_kontext_max_single
                description: Tạo tác vụ black-forest-labs/flux-kontext-max
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - status
                properties:
                  created_at:
                    type: string
                    description: Thời gian tạo
                  data_removed:
                    type: boolean
                    description: Liệu dữ liệu nhạy cảm đã được loại bỏ hay chưa
                  error:
                    type: string
                    description: Thông báo lỗi
                    nullable: true
                  id:
                    type: string
                    description: ID tài nguyên hoặc tác vụ
                  input:
                    type: object
                    properties:
                      aspect_ratio:
                        type: string
                        description: 'Tỷ lệ khung hình, ví dụ: 16:9, 9:16, 1:1'
                      input_image:
                        type: string
                        description: URL hình ảnh đầu vào hoặc Base64
                      output_format:
                        type: string
                        description: 'Định dạng đầu ra, ví dụ: png / jpeg / webp'
                      prompt:
                        type: string
                        description: Lời nhắc văn bản
                      prompt_upsampling:
                        type: boolean
                        description: Có tăng độ phân giải / cải thiện lời nhắc hay không
                      safety_tolerance:
                        type: integer
                        description: Mức dung sai của bộ lọc an toàn
                    description: Vui lòng cung cấp nội dung tài liệu cần dịch.
                    x-apifox-orders:
                      - aspect_ratio
                      - input_image
                      - output_format
                      - prompt
                      - prompt_upsampling
                      - safety_tolerance
                    x-apidog-orders:
                      - aspect_ratio
                      - input_image
                      - output_format
                      - prompt
                      - prompt_upsampling
                      - safety_tolerance
                  logs:
                    type: string
                    description: Nhật ký chạy
                  model:
                    type: string
                    description: Tên mô hình / mã định danh mô hình
                  output:
                    type: string
                    description: Kết quả đầu ra
                    nullable: true
                  status:
                    type: string
                    description: Trạng thái
                  urls:
                    type: object
                    required:
                      - cancel
                      - get
                      - stream
                      - web
                    properties:
                      cancel:
                        type: string
                        description: URL để hủy tác vụ
                      get:
                        type: string
                        description: URL để truy vấn trạng thái tác vụ
                      stream:
                        type: string
                        description: Có truyền phát phản hồi hay không
                      web:
                        type: string
                        description: URL để xem tác vụ trong trình duyệt
                    description: Danh sách URL tài nguyên
                    x-apifox-orders:
                      - cancel
                      - get
                      - stream
                      - web
                    x-apidog-orders:
                      - cancel
                      - get
                      - stream
                      - web
                  version:
                    type: string
                    description: Phiên bản
                refName: >-
                  PostReplicateV1ModelsBlackForestLabsFluxKontextMaxPredictionsResponse
                x-apifox-orders:
                  - created_at
                  - data_removed
                  - error
                  - id
                  - input
                  - logs
                  - model
                  - output
                  - status
                  - urls
                  - version
                x-apidog-orders:
                  - created_at
                  - data_removed
                  - error
                  - id
                  - input
                  - logs
                  - model
                  - output
                  - status
                  - urls
                  - version
              examples:
                example:
                  summary: example
                  value:
                    created_at: '2025-07-29T07:21:33.309Z'
                    data_removed: false
                    id: 5pcmjq6sfnrmc0cram79p95eg4
                    input:
                      aspect_ratio: match_input_image
                      input_image: >-
                        Vui lòng tải ảnh lên trực tiếp hoặc dán nội dung tài
                        liệu để tôi có thể dịch sang tiếng Việt và giữ nguyên
                        định dạng Markdown, mã, định danh, URL, đường dẫn, chỗ
                        giữ chỗ cùng cấu trúc JSON.
                      output_format: jpg
                      prompt: >-
                        Làm cho các chữ cái có hiệu ứng 3D, lơ lửng trong không
                        gian trên một con phố thành thị
                      prompt_upsampling: false
                      safety_tolerance: 2
                    logs: ''
                    model: black-forest-labs/flux-kontext-max
                    status: starting
                    urls:
                      cancel: >-
                        https://api.replicate.com/v1/predictions/5pcmjq6sfnrmc0cram79p95eg4/cancel
                      get: >-
                        Vui lòng dán nội dung tài liệu cần dịch. Đường dẫn API
                        này yêu cầu quyền truy cập nên tôi không thể lấy nội
                        dung trực tiếp.
                      stream: >-
                        https://stream.replicate.com/v1/files/bcwr-o4bl6hrud4sg7ceoi45imkh7lq32nbyqvnsyg736v7ghpxwqxheq
                      web: >-
                        Vui lòng dán nội dung tài liệu cần dịch. Tôi không thể
                        truy cập trực tiếp nội dung từ liên kết này.
                    version: ẩn
          headers: {}
          x-apidog-name: ''
        '400':
          description: Yêu cầu không hợp lệ hoặc xác thực thất bại
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - message
                      - type
                    properties:
                      message:
                        type: string
                        description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu)
                      type:
                        type: string
                        description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error
                        examples:
                          - new_api_error
                    x-apifox-orders:
                      - message
                      - type
                    x-apidog-orders:
                      - message
                      - type
                refName: NewApiError
                x-apifox-orders:
                  - error
                x-apidog-orders:
                  - error
              examples:
                example:
                  summary: example
                  value:
                    error:
                      message: >-
                        Yêu cầu không hợp lệ (mã yêu cầu:
                        20260805120000123456789AbCdEfGh)
                      type: new_api_error
          headers: {}
          x-apidog-name: Yêu cầu không hợp lệ hoặc xác thực thất bại
        '401':
          description: Khóa API bị thiếu hoặc không hợp lệ
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - message
                      - type
                    properties:
                      message:
                        type: string
                        description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu)
                      type:
                        type: string
                        description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error
                        examples:
                          - new_api_error
                    x-apifox-orders:
                      - message
                      - type
                    x-apidog-orders:
                      - message
                      - type
                refName: NewApiError
                x-apifox-orders:
                  - error
                x-apidog-orders:
                  - error
              examples:
                example:
                  summary: example
                  value:
                    error:
                      message: >-
                        Mã thông báo không hợp lệ (request id:
                        20260805120000123456789AbCdEfGh)
                      type: new_api_error
          headers: {}
          x-apidog-name: Khóa API bị thiếu hoặc không hợp lệ
      security: []
      x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Tổng hợp bản sao
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208952-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.openaihub.net
    description: Prod Env
security: []

```
