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

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

> 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-dev/predictions:
    post:
      summary: Tạo tác vụ black-forest-labs/flux-kontext-dev
      deprecated: false
      description: >-
        Tài liệu chính thức:
        https://replicate.com/black-forest-labs/flux-kontext-dev
      operationId: >-
        replicate_replicate_v1_models_black_forest_labs_flux_kontext_dev_predictions
      tags:
        - >-
          OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/FLUX/Vui lòng cung cấp nội
          dung tài liệu kỹ thuật cần dịch.
        - 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
                    - input_image
                  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".
                    go_fast:
                      type: boolean
                      description: >-
                        Giúp mô hình chạy nhanh hơn, chất lượng đầu ra có thể
                        giảm nhẹ đối với các lời nhắc khó hơn. Giá trị mặc định:
                        true.
                    guidance:
                      type: number
                      description: >-
                        Các từ gợi ý điều chỉnh cường độ. Giá trị mặc định: 2.5.
                        Giá trị tối thiểu: 0, giá trị tối đa: 10
                    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.
                    num_inference_steps:
                      type: integer
                      description: >-
                        Số bước suy luận, mặc định: 28. Giá trị tối thiểu: 4,
                        giá trị tối đa: 50.
                    output_format:
                      type: string
                      description: 'Định dạng ảnh đầu ra. Mặc định: "webp".'
                    output_quality:
                      type: integer
                      description: >-
                        Chất lượng lưu hình ảnh đầu ra, từ 0 đến 100. 100 là
                        chất lượng tốt nhất, 0 là chất lượng thấp nhất. Không
                        liên quan đến đầu ra .png. Giá trị mặc định: 80. Giá trị
                        nhỏ nhất: 0, giá trị lớn nhất: 100.
                    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.
                  description: Vui lòng cung cấp nội dung tài liệu cần dịch.
                  x-apifox-orders:
                    - aspect_ratio
                    - go_fast
                    - guidance
                    - input_image
                    - num_inference_steps
                    - output_format
                    - output_quality
                    - prompt
                  x-apidog-orders:
                    - aspect_ratio
                    - go_fast
                    - guidance
                    - input_image
                    - num_inference_steps
                    - output_format
                    - output_quality
                    - prompt
              x-apifox-orders:
                - input
              x-apidog-orders:
                - input
            examples:
              black_forest_labsflux_kontext_dev_single:
                value:
                  input:
                    aspect_ratio: match_input_image
                    go_fast: true
                    guidance: 2.5
                    input_image: >-
                      https://replicate.delivery/pbxt/N5YURZv4ifaW2bMwU7hmrwzgtxf99DTQXpBeobLt1O7dEc3h/pexels-jmark-253096.jpg
                    num_inference_steps: 30
                    output_format: jpg
                    output_quality: 80
                    prompt: Đổi màu xe thành màu đỏ, bật đèn pha
                summary: black_forest_labsflux_kontext_dev_single
                description: Tạo tác vụ black-forest-labs/flux-kontext-dev
      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: >-
                  PostReplicateV1ModelsBlackForestLabsFluxKontextDevPredictionsResponse
                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:12:42.163Z'
                    data_removed: false
                    id: tpdf40dypdrma0cram394vvzkg
                    input:
                      aspect_ratio: match_input_image
                      go_fast: true
                      guidance: 2.5
                      input_image: >-
                        https://replicate.delivery/pbxt/N5YURZv4ifaW2bMwU7hmrwzgtxf99DTQXpBeobLt1O7dEc3h/pexels-jmark-253096.jpg
                      num_inference_steps: 30
                      output_format: jpg
                      output_quality: 80
                      prompt: Đổi màu xe thành màu đỏ, bật đèn pha
                    logs: ''
                    model: black-forest-labs/flux-kontext-dev
                    status: starting
                    urls:
                      cancel: >-
                        https://api.replicate.com/v1/predictions/tpdf40dypdrma0cram394vvzkg/cancel
                      get: >-
                        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 URL này.
                      stream: >-
                        Vui lòng dán nội dung tài liệu cần dịch vào đây; tôi
                        không thể truy cập trực tiếp URL được cung cấp.
                      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 đã cung cấp.
                    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/FLUX/Vui lòng cung cấp nội dung
        tài liệu kỹ thuật cần dịch.
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208892-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.openaihub.net
    description: Prod Env
security: []

```
