Fal.ai 聚合平台接入概览

本站提供 Fal.ai 模型的聚合调用入口。Fal.ai 官方模型页、青云TOP API 的公开路径和当前 API Key 的可用模型是三份不同清单；本文先说明协议，再按图片、编辑和视频动作进入具体页面。

调用前确认

  • 使用 Authorization: Bearer YOUR_API_KEY，客户端只提交青云TOP API Key，不提交 Fal Token。
  • 先调用 GET /v1/models，确认当前 API Key、分组和渠道返回的完整模型 ID；官方模型存在不等于当前账号已开放。
  • 目录中的路径是青云TOP API 路径，不是让客户端直接访问 fal.ai 或 fal.media。素材 URL 由客户端提供时，应使用服务端可访问、未过期且符合模型限制的地址。

Fal.ai 协议和任务生命周期

Fal.ai 官方支持同步、Queue 异步、流式和 webhook 等能力。本站这些聚合页面以提交任务、保存 request_id、查询 status_url/结果和下载产物为主；页面没有声明的 stream 或 webhook 字段不能自行推断为已开放。HTTP 2xx 只表示请求被接受，业务成功要等到成功终态。

  1. 使用页面显示的 POST 路径提交 JSON Body。
  2. 保存响应中的 request_id、status_url 和 response_url。
  3. 按查询页轮询到 completed/succeeded，失败或取消时记录 error。
  4. 立即下载结果 URL 并保存到自己的对象存储；临时 URL 不应长期写入数据库或直接暴露给终端用户。

当前目录的动作范围

能力入口示例说明
图片生成/fal-ai/flux-1/dev、/fal-ai/imagen4/preview文生图、尺寸、输出格式和安全检查由具体页面约束。
图片编辑/参考/fal-ai/flux-1/dev/image-to-image、/fal-ai/qwen-image-edit-plus图片 URL、数组顺序、蒙版和强度不能跨模型复用。
视频生成/fal-ai/veo3、/fal-ai/kling-video/v2.5-turbo/pro/text-to-video时长、比例、分辨率和音频开关按动作分别填写。
查询结果/fal-ai/{model_name}/requests/{request_id}只传路径参数，不能把创建 Body 复制到查询请求。

官方参考

官方资料用于核对上游模型能力；是否能通过青云TOP API 调用，以当前 GET /v1/models、分组权限和实际服务端响应为准。