Fal-ai 绘画接口接入指南

Tokenrouter 已集成 Fal-ai 系列顶级生图模型（如 Flux.1 系列）。通过我们的中转服务，您可以直接调用这些高性能模型。

一、支持的模型列表

如果您在 Fal-ai 官网发现其他感兴趣的模型，请联系管理员申请添加。

模型 ID	类型	说明
`fal-ai/flux-1/dev`	绘画	Flux.1 开发版，平衡速度与质量
`fal-ai/flux-1/schnell`	绘画	极速生图版
`fal-ai/flux-pro/kontext`	绘画	专业级画质增强版
`fal-ai/flux-1/dev/image-to-image`	绘画	图生图功能
...	...	更多模型请参考模型广场

二、接入约定与配置

认证方式：在 Header 中带上 Authorization: Bearer YOUR_API_KEY。

注意：Fal-ai 官网原版使用 key 作为前缀，但在 Tokenrouter 中请统一使用 Bearer。

请求域名：将官网地址 https://queue.fal.run 统一更换为：
https://token.ithinkai.cn

参数一致性：输入、输出格式及请求方式（POST/GET）与 Fal-ai 官网文档完全一致。

三、调用步骤

1. 提交生成任务

接口地址：POST https://token.ithinkai.cn/fal-ai/{model_id}

cURL 示例：

返回体示例：

{
  "status": "IN_QUEUE",
  "request_id": "551a32da-52b2-4be8-bf2f-bfb7cce2b324",
  "response_url": "https://queue.fal.run/fal-ai/flux-1/requests/551a32da...",
  "status_url": "https://queue.fal.run/fal-ai/flux-1/requests/551a32da.../status"
}

重要说明：返回体中的 response_url 包含官网域名。在进行下一步查询时，请务必将其中的 https://queue.fal.run 替换为我们的中转地址 https://token.ithinkai.cn。

2. 获取任务结果

任务生成需要时间，请使用上一步获得的 request_id 进行轮询查询。

接口地址：GET https://token.ithinkai.cn/fal-ai/{model_id}/requests/{request_id}

cURL 示例：

结果响应 (图片)：
结果位于 images 数组中。

{
  "images": [
    {
      "url": "https://v3.fal.media/files/.../output.png",
      "width": 1024,
      "height": 768,
      "content_type": "image/png"
    }
  ],
  "seed": 920212137
}

结果响应 (视频)：
结果位于 video 对象中。

{
  "video": {
    "url": "https://v3.fal.media/files/.../output.mp4",
    "content_type": "video/mp4"
  }
}

💡 注意事项

时效性：任务结果在 Fal-ai 服务器上保留时间有限，获取到图片/视频 URL 后，请务必及时下载或保存到您的私有存储中。

参数调试：中转过程中，某些极少数的高级可选参数可能由于上游兼容性无法完全生效。建议先从核心参数 prompt 开始测试。

接入教程

Fal-ai 绘画接口接入指南#

一、支持的模型列表#

二、接入约定与配置#

三、调用步骤#

1. 提交生成任务#

2. 获取任务结果#