Bỏ qua để đến nội dung

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

Xem Markdownllms.txt

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: 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/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
- 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/Tổng hợp bản sao
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208949-run
components:
schemas: {}
securitySchemes: {}
servers:
- url: https://api.openaihub.net
description: Prod Env
security: []