Fal.ai 对接教程

Fal.ai 是一个带来多种 AI 模型的平台，包含图像生成、视频处理、语音生成等功能。通过 TimRouter API 国内中转，国内研发人员能够直接请求 Fal.ai 的各类模型服务，无需特殊网络设定。

兼容的模型

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

Fal.ai API 接口说明文档

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

1. 产出作业

接口

范例

curl --request POST \
--url https://api.timrouter.com/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.timrouter.com/fal/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324",
    "status_url": "https://api.timrouter.com/fal/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324/status",
    "cancel_url": "https://api.timrouter.com/fal/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324/cancel",
    "queue_position": 0
}

描述：返回体中的 response_url 为下一步请求链接，须要将 queue.fal.run 替换为 api.timrouter.com。

2. 取得任务结果

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

接口

范例

curl --request GET \
--url https://api.timrouter.com/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
    }
}

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