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

/fal-ai/flux-1/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:
/fal-ai/flux-1/dev:
post:
summary: /fal-ai/flux-1/dev
deprecated: false
description: 'Tài liệu chính thức: https://fal.ai/models/fal-ai/flux-1/dev'
operationId: fal_ai_fal_ai_flux_1_dev
tags:
- OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Fal.ai
- Fal.ai
parameters: []
requestBody:
content:
application/json:
schema:
type: object
required:
- prompt
properties:
acceleration:
type: string
description: >-
Tốc độ tạo. Tốc độ càng cao thì quá trình dựng càng nhanh.
Giá trị mặc định: "regular" . Hỗ trợ: default, none,
regular, high
enable_safety_checker:
type: boolean
description: >-
Nếu được đặt thành `true`, trình kiểm tra bảo mật sẽ được
bật. Giá trị mặc định: `true`
guidance_scale:
type: number
description: >-
Thang CFG (Classifier Free Guidance - Huong dan khong can bo
phan phan loai) do muc do ban muon mo hinh bam sat cac goi y
khi tim hinh anh phu hop. Gia tri mac dinh: 3.5. Pham vi gia
tri: 1-20
image_size:
type: string
description: >-
Kích thước của hình ảnh được tạo. Mặc định: landscape_4_3,
phạm vi (3:4, 4:3, 16:9, 9:16)
num_images:
type: integer
description: >-
Số lượng hình ảnh được tạo. Giá trị mặc định: 1 Giá trị
trong khoảng: 1-4
num_inference_steps:
type: integer
description: >-
Số bước suy luận cần thực hiện. Giá trị mặc định: 28. Phạm
vi giá trị: 0-50
output_format:
type: string
description: >-
Định dạng của hình ảnh được tạo. Giá trị mặc định: "jpeg".
Các định dạng được hỗ trợ: default, JPEG, png
prompt:
type: string
description: Lời nhắc văn bản
refName: PostFalAiFlux1DevRequest
x-apifox-orders:
- acceleration
- enable_safety_checker
- guidance_scale
- image_size
- num_images
- num_inference_steps
- output_format
- prompt
x-apidog-orders:
- acceleration
- enable_safety_checker
- guidance_scale
- image_size
- num_images
- num_inference_steps
- output_format
- prompt
examples:
fal_aiflux_1dev_single:
value:
acceleration: thông thường
enable_safety_checker: true
guidance_scale: 3.5
image_size: landscape_4_3
num_images: 1
num_inference_steps: 28
output_format: jpeg
prompt: >-
Cảnh cực cận của một mắt hổ duy nhất, nhìn thẳng từ chính
diện. Mống mắt và đồng tử chi tiết. Lấy nét sắc nét vào kết
cấu và màu sắc của mắt. Ánh sáng tự nhiên làm nổi bật độ
long lanh và chiều sâu chân thực của mắt. Từ "FLUX" được vẽ
đè lên trên bằng những nét cọ lớn màu trắng, với kết cấu
hiện rõ.
summary: fal_aiflux_1dev_single
description: /fal-ai/flux-1/dev
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
required:
- status
- request_id
- response_url
- status_url
- cancel_url
- logs
- metrics
- queue_position
properties:
cancel_url:
type: string
description: URL hủy tác vụ
logs:
type: array
items:
type: string
description: Nhật ký chạy
nullable: true
metrics:
type: object
description: Số liệu chạy
x-apidog-orders: []
queue_position:
type: integer
description: Vị trí trong hàng đợi
request_id:
type: string
description: ID truy vết yêu cầu
response_url:
type: string
description: URL truy vấn kết quả
status:
type: string
description: Trạng thái
status_url:
type: string
description: URL truy vấn trạng thái
refName: PostFalAiFlux1DevResponse
x-apifox-orders:
- cancel_url
- logs
- metrics
- queue_position
- request_id
- response_url
- status
- status_url
x-apidog-orders:
- cancel_url
- logs
- metrics
- queue_position
- request_id
- response_url
- status
- status_url
examples:
example:
summary: example
value:
cancel_url: >-
https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2/cancel
logs: []
metrics: {}
queue_position: 0
request_id: 3892f1e8-5fb1-469f-87b0-696d6054c9f2
response_url: >-
https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2
status: IN_QUEUE
status_url: >-
https://queue.fal.run/fal-ai/flux-1/requests/3892f1e8-5fb1-469f-87b0-696d6054c9f2/status
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/Fal.ai
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208900-run
components:
schemas: {}
securitySchemes: {}
servers:
- url: https://api.openaihub.net
description: Prod Env
security: []