Fal.ai 接入教程

Fal.ai 是一个提供多种 AI 模型的平台，涵盖图片生成、视频处理、语音合成等功能。通过 QuickRouter API 国内中转，国内开发者可以直接调用 Fal.ai 的各类模型服务，无需特殊网络配置。

支持的模型

如果你在官网发觉有更多好玩的模型，请联系管理员把模型加入进来

Fal.ai API 接口文档

约定：header 带上 Authorization: Bearer your-key。官网是用 Authorization: key your-key。将官网的 https://queue.fal.run 更换为 api.quickrouter.ai。输入、输出、请求方式跟官网一致。

1. 生成任务

接口

示例

curl --request POST \
--url https://api.quickrouter.ai/fal/flux-1/dev \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "prompt": "Extreme close-up of a single cat eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye and depth."
}'

具体的请求方式请详看各个模型的文档。请注意，请求参数可能在中转中不能正确生效，你可以从 prompt 开始测试，如果你发现了文档中的某个参数无法正常生效，你可以联系客服进行维护。

返回体

{
    "status": "IN_QUEUE",
    "request_id": "551a32da-52b2-4be8-bf2f-bfb7cce2b324",
    "response_url": "https://api.quickrouter.ai/fal/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324",
    "status_url": "https://api.quickrouter.ai/fal/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324/status",
    "cancel_url": "https://api.quickrouter.ai/fal/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324/cancel",
    "queue_position": 0
}

说明：返回体中的 response_url 为下一步请求链接，需要将 queue.fal.run 替换为 api.quickrouter.ai。

2. 获取任务结果

获取结果有时效，请务必保存

接口

示例

curl --request GET \
--url https://api.quickrouter.ai/fal/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324 \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'

返回体.图片

结果在 images

{
    "images": [
        {
            "url": "https://...",
            "width": 1024,
            "height": 768,
            "content_type": "image/png"
        }
    ],
    "timings": {"inference": 1.22},
    "seed": 920212137,
    "has_nsfw_concepts": [false]
}

返回体.视频

结果在 video

{
    "video": {
        "url": "https://...",
        "content_type": "video/mp4",
        "file_name": "output.mp4",
        "file_size": 946834
    }
}

获取结果有时效，请务必保存