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

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

> 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-pro/predictions:
    post:
      summary: Tạo tác vụ black-forest-labs/flux-kontext-pro
      deprecated: false
      description: >-
        Tài liệu chính thức:
        https://replicate.com/black-forest-labs/flux-kontext-pro
      operationId: >-
        replicate_replicate_v1_models_black_forest_labs_flux_kontext_pro_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",
                        hỗ trợ 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4,
                        21:9, 9:21, 2:1, 1:2.
                    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
                  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_pro_single:
                value:
                  input:
                    aspect_ratio: match_input_image
                    input_image: >-
                      Vui lòng tải ảnh trực tiếp lên để tôi có thể đọc và dịch
                      nội dung, đồng thời giữ nguyên Markdown, mã, định danh,
                      URL, đường dẫn, chỗ giữ chỗ, cấu trúc JSON và định dạng.
                    output_format: jpg
                    prompt: Hãy biến hình này thành phim hoạt hình thập niên 90.
                    prompt_upsampling: false
                    safety_tolerance: 2
                summary: black_forest_labsflux_kontext_pro_single
                description: Tạo tác vụ black-forest-labs/flux-kontext-pro
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                required:
                  - input
                properties:
                  input:
                    type: object
                    required:
                      - prompt
                    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
                x-apifox-orders:
                  - input
                x-apidog-orders:
                  - input
              examples:
                '1':
                  summary: '1'
                  value:
                    created_at: '2025-07-29T06:51:12.591Z'
                    data_removed: false
                    id: b1qw7g8h9xrma0crakst3xbj8m
                    input:
                      aspect_ratio: match_input_image
                      input_image: >-
                        Vui lòng tải ảnh trực tiếp lên để tôi có thể đọc và dịch
                        nội dung, đồng thời giữ nguyên Markdown, mã, định danh,
                        URL, đường dẫn, chỗ giữ chỗ, cấu trúc JSON và định dạng.
                      output_format: jpg
                      prompt: Hãy biến hình này thành phim hoạt hình thập niên 90.
                      prompt_upsampling: false
                      safety_tolerance: 2
                    logs: ''
                    model: black-forest-labs/flux-kontext-pro
                    status: starting
                    urls:
                      cancel: >-
                        https://api.replicate.com/v1/predictions/b1qw7g8h9xrma0crakst3xbj8m/cancel
                      get: >-
                        https://api.replicate.com/v1/predictions/b1qw7g8h9xrma0crakst3xbj8m
                      stream: >-
                        Không thể truy cập nội dung tài liệu từ URL được cung
                        cấp. Vui lòng gửi trực tiếp nội dung cần dịch.
                      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ừ URL này:


                        https://replicate.com/p/b1qw7g8h9xrma0crakst3xbj8m
                    version: ẩn
                '2':
                  summary: '2'
                  value:
                    created_at: '2025-07-12T07:27:54.577Z'
                    data_removed: false
                    id: w44zs9cet5rmc0cqzp49gpkhf8
                    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-dev
                    status: starting
                    urls:
                      cancel: >-
                        https://api.replicate.com/v1/predictions/w44zs9cet5rmc0cqzp49gpkhf8/cancel
                      get: >-
                        Vui lòng truy xuất nội dung tại
                        https://api.replicate.com/v1/predictions/w44zs9cet5rmc0cqzp49gpkhf8
                        rồi dịch tài liệu kỹ thuật đó sang tiếng Việt. Giữ
                        nguyên Markdown, mã, định danh, URL, đường dẫn, chỗ dành
                        sẵn, cấu trúc JSON và định dạng. Chỉ trả về văn bản đã
                        dịch và không để lại ký tự Hán.
                      stream: >-
                        Vui lòng dán nội dung tài liệu vào đây để tôi có thể
                        dịch sang tiếng Việt và giữ nguyên Markdown, mã nguồn,
                        định danh, URL, đường dẫn, chỗ dành sẵn, cấu trúc JSON
                        cùng định dạng.
                      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-45208951-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.openaihub.net
    description: Prod Env
security: []

```
