API
快速了解 fal.ai API
根据 fal.ai 的公开文档（核查日期：2026年10月22日），了解请求、结果和价格查询的工作方式，并与 CheaperGen 的 API 对比。
| 功能项 | CheaperGen | fal.ai |
|---|---|---|
| API、MCP 和创作工作台 | CheaperGenREST API、面向 AI 智能体的远程 MCP 服务器和网页创作工作台——一个密钥，一个余额 | fal.aiREST API、每个模型页面上的 Playground 和 Sandbox、远程 MCP 服务器（OAuth）、以及 Python、JavaScript、Swift、Kotlin 和 Dart SDK[1][2] |
| API 风格 | CheaperGen异步处理：提交任务后轮询生成状态，或接收签名 Webhook | fal.ai队列式异步调用，支持轮询或签名 Webhook；也支持同步、流式传输和 WebSocket 实时调用[3][4] |
| 运行前查询价格 | CheaperGen运行前可免费查询任意输入的价格（POST /quote，无需密钥） | fal.ai定价和成本估算 API[2] |
迁移指南
分四步从 fal.ai 迁移
两个平台使用相同的请求格式。只需更改 URL、身份验证请求头和少数字段名称。
- 01
创建密钥
登录，在控制台创建 API 密钥并充值额度。
- 02
更改端点
向
/api/v1/run/{endpoint}发送 POST 请求，并使用Authorization: Bearer。 - 03
映射输入字段
请求体中的字段为平铺结构。每个模型的 API 页面都提供 JSON Schema。
- 04
读取结果
轮询
GET /api/v1/generations/{id}，或传入webhook_url。
之前 · fal.ai
POST queue.fal.run/bytedance/seedance-2.0/text-to-video
curl -X POST https://queue.fal.run/bytedance/seedance-2.0/text-to-video \
-H "Authorization: Key $FAL_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A paper boat drifting down a rain-soaked street at dusk",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": "5",
"generate_audio": true
}'
# then poll the status_url it returns; the result is at response_url来源：fal.ai/docs/documentation/model-apis/inference/queue，核查日期：2026年10月22日。
之后 · CheaperGen · Seedance 2.0
POST /api/v1/run/bytedance/seedance-2.0/text-to-video
curl -X POST https://cheapergen.com/api/v1/run/bytedance/seedance-2.0/text-to-video \
-H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A paper boat drifting down a rain-soaked street at dusk",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5,
"generate_audio": true
}'| 概念 | fal.ai | CheaperGen |
|---|---|---|
| 提交 | fal.aiPOST queue.fal.run/{model_id} | CheaperGenPOST /api/v1/run/{endpoint} |
| 模型 | fal.aibytedance/seedance-2.0/text-to-video | CheaperGenbytedance/seedance-2.0/text-to-video |
| Auth | fal.aiAuthorization: Key <FAL_KEY> | CheaperGenAuthorization: Bearer cg_live_… |
| 时长 | fal.ai"duration": "5" (string) | CheaperGen"duration": 5 (number) |
| 任务 ID | fal.airequest_id | CheaperGenid |
| Result | fal.aistatus_url，然后是 response_url | CheaperGenGET /api/v1/generations/{id} |
| Finished | fal.aistatus: COMPLETED | CheaperGenstatus: succeeded | failed | canceled |
| 输出 | fal.aivideo.url | CheaperGenoutput.video.url |
| Webhook | fal.ai?fal_webhook=https://… (query) | CheaperGen"webhook_url": "https://…" (body) |
常见问题
Fal API 常见问题
fal.ai 的文档说明 `POST queue.fal.run/{model_id}` 使用 `Authorization: Key <FAL_KEY>`，然后用 `status_url，然后是 response_url` 获取结果。在 CheaperGen 上，使用 `POST /api/v1/run/{endpoint}` 和 `Authorization: Bearer` 发送请求，然后通过 `GET /api/v1/generations/{id}` 或 Webhook 获取结果。上方的迁移指南列出了各字段的对应关系。
支持：?fal_webhook=https://… (query)。CheaperGen 会在请求正文中接收 `webhook_url`，并使用 HMAC-SHA256 对每次推送进行签名（通过 `CheaperGen-Signature` 请求头）。详见 Webhook。
大体可以：修改 URL、身份验证请求头和少数字段名称即可。上方的迁移指南展示了双方使用相同请求的方式。 每个模型的 API 页面都提供其 JSON Schema。
根据其公开文档：队列式异步调用，支持轮询或签名 Webhook；也支持同步、流式传输和 WebSocket 实时调用。CheaperGen 的 API 为异步调用——提交后轮询，或接收 Webhook；在 MCP 服务器上，生成过程最多可等待 50 秒以获取结果。
对于 36 与 CheaperGen 都提供且我们价格更低的模型，比 fal.ai 低至 81%。fal.ai 价格 页面列出了所有档位。
相关页面
了解更多关于 Fal AI 的信息
来源——fal.ai 公开页面，核查日期：2026年10月21日（价格）和 2026年10月22日 (7)
- [1] fal.ai/docs/documentation/setting-up/mcp
- [2] fal.ai/docs/llms.txt
- [3] fal.ai/docs/documentation/model-apis/overview
- [4] fal.ai/docs/documentation/model-apis/inference/webhooks
- [5] fal.ai/models/bytedance/seedance-2.0/text-to-video
- [6] fal.ai/models/fal-ai/kling-video/v3/standard/text-to-video
- [7] fal.ai/models/fal-ai/veo3.1
fal.ai 及其徽标是其所有者的商标，仅用于标识本页所比较的平台。CheaperGen 与 fal.ai 无关联，也未获其认可。fal.ai 的价格和功能信息来自其公开页面（价格 2026年10月21日，功能 2026年10月22日），此后可能已有变化。模型名称和商标归各自所有者所有。