Các mô hình được hỗ trợ#
Nếu bạn phát hiện có thêm mô hình thú vị trên trang chính thức, hãy liên hệ quản trị viên để thêm mô hình vào
Mô hình | Mô tả |
---|
fal-ai/flux-1/dev | Vẽ hình ảnh |
fal-ai/flux-1/dev/image-to-image | Vẽ hình ảnh |
fal-ai/flux-1/dev/redux | Vẽ hình ảnh |
fal-ai/flux-1/schnell | Vẽ hình ảnh |
fal-ai/flux-1/schnell/redux | Vẽ hình ảnh |
fal-ai/flux-pro/kontext | Vẽ hình ảnh |
fal-ai/flux-pro/kontext/max | Vẽ hình ảnh |
fal-ai/flux-pro/kontext/max/multi | Vẽ hình ảnh |
fal-ai/flux-pro/kontext/max/text-to-image | Vẽ hình ảnh |
fal-ai/flux-pro/kontext/multi | Vẽ hình ảnh |
fal-ai/flux-pro/kontext/text-to-image | Vẽ hình ảnh |
Tài liệu API của Fal-ai#
Quy ước
Gửi Authorization: Bearer your-key
trong phần header
Trang chủ sử dụng Authorization: key your-key
Thay https://queue.fal.run
bằng tên miền proxy của bạn
Phương thức gửi/nhận, định dạng vẫn giống như tài liệu chính thức
1. Tạo task#
Endpoint#
POST {{BASE_URL}}/fal-ai/{{model}}
Ví dụ#
Cách gửi cụ thể xin tham khảo tài liệu của từng mô hình. Lưu ý rằng một số tham số có thể không hoạt động chính xác khi dùng qua proxy, bạn có thể bắt đầu thử từ prompt
. Nếu phát hiện tham số nào trong tài liệu không hoạt động, hãy liên hệ bộ phận hỗ trợ.
Phản hồi khi tạo task#
{
"status": "IN_QUEUE",
"request_id": "551a32da-52b2-4be8-bf2f-bfb7cce2b324",
"response_url": "https://queue.fal.run/fal-ai/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324",
"status_url": "https://queue.fal.run/fal-ai/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324/status",
"cancel_url": "https://queue.fal.run/fal-ai/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324/cancel",
"queue_position": 0
}
Giải thích
Đường dẫn response_url
trong phản hồi sẽ dùng để truy vấn kết quả. Nhớ thay https://queue.fal.run
bằng địa chỉ proxy của bạn.
2. Lấy kết quả task#
Kết quả có thời hạn, hãy nhớ lưu lại
Endpoint#
GET {BASE_URL}/fal-ai/{modelname}/requests/{request_id}
Ví dụ#
Phản hồi (hình ảnh)#
Kết quả nằm trong trường images
:{
"images": [
{
"url": "https://v3.fal.media/files/rabbit/aQEmU4lEKKIIr9cDOChUB.png",
"width": 1024,
"height": 768,
"content_type": "image/png"
}
],
"timings": {
"inference": 1.2249955059960485
},
"seed": 920212137,
"has_nsfw_concepts": [false],
"prompt": "Cận cảnh mắt mèo, nhìn trực diện. Con ngươi và mống mắt chi tiết rõ nét, ánh sáng tự nhiên phản chiếu độ sâu và độ bóng thực tế. Dòng chữ \"openai-hk\" được vẽ lên bằng nét cọ trắng dày, có kết cấu rõ rệt."
}
Phản hồi (video)#
Kết quả nằm trong trường video
:{
"video": {
"url": "https://v3.fal.media/files/lion/eSsTNfWQRXfWGim1B8ZL5_output.mp4",
"content_type": "video/mp4",
"file_name": "output.mp4",
"file_size": 946834
}
}
Kết quả có thời hạn, hãy nhớ tải về hoặc lưu lại sớm.
Modified at 2025-07-27 12:32:17