云雾API 接口对接
首页立即登录立即注册令牌管理余额管理
首页立即登录立即注册令牌管理余额管理
  1. Fal.ai 官方格式
  • 引言
  • 在线调试说明
  • 发出请求
  • 中转站基本介绍
    • API 快速开始指南
    • 联系客服
    • 分组详细表格
    • 分组的特殊性及价格差异
    • 如何新建指定分组的令牌
    • 代理接口调用地址
    • API Key 额度查询服务
    • 免费AI聊天项目导航
  • Chat模型
    • ChatGpt 接口
      • ChatGPT音频(Audio)
        • GPT-4o-audio
        • 音频转文字 whisper-1
        • 音频转文字 gpt-4o-transcribe
        • 创建语音
        • 创建翻译 (不支持)
      • ChatGPT聊天(Chat)
        • 聊天完成对象
        • 聊天完成块对象
        • 创建聊天补全 (流式)
        • 创建聊天补全 (非流)
        • 创建聊天识图 (流式)
        • 创建聊天识图 (流式) best64
        • 创建聊天识图 (非流)
        • 创建聊天创作图 (非流)
        • 官方Function calling调用
        • 官方N测试
        • 列出模型
        • 创建聊天函数调用 (只能非流)
        • 创建结构化输出
        • 控制推理模型努力程度
      • chatgpt-responses格式
        • chat 聊天
        • chat 聊天+网络搜索
        • deep-research 深度搜索 (巨贵,一次几十刀,慎用)
      • ChatGPT自动补全(Completions)
        • 完成对象
        • 创建完成
      • ChatGPT嵌入(Embeddings)
        • 嵌入对象
        • 创建嵌入
      • Web 搜索
        • web搜索
    • Anthropic Claude 接口
      • 聊天完成对象
      • 聊天完成块对象
      • 创建聊天补全 (流式) [原生格式]
      • 创建聊天补全 (流式)
      • 创建聊天补全 (非流)
      • 创建聊天识图 (流式)
      • 创建聊天识图 (非流)
      • 创建函数调用
    • 谷歌Gemini
      • 原生格式
        • 聊天接口 [原生格式]
        • 聊天接口-流 [原生格式]
        • 图片创作[原生格式]
        • 图片编辑 [原生格式]
        • 图片理解 [原生格式]
        • 格式化输出 [原生格式]
        • 文档理解 [原生格式]
        • 视频理解-base64 [原生格式]
        • 聊天接口 - 阅读网页 [原生格式] 开发中
        • 视频理解-url [原生格式] 开发中
        • Imagen 3 生成图片 [原生格式] 开发中
      • chat兼容格式
        • gemini图片创作接口 [chat兼容格式]
        • 聊天接口 [chat兼容格式]
        • 识图接口 [chat兼容格式]
        • 聊天+读取文件接口 [chat兼容格式]
  • 文生图模型
    • README
    • 图像对象
    • MJ绘画
      • 上传图片
      • 提交Imagine任务
      • 根据任务ID 查询任务状态
      • 根据ID列表查询任务
      • 获取任务图片的seed
      • 执行Action动作
      • 提交Blend任务
      • 提交Describe任务
      • 提交Shorten任务
      • 提交Modal
      • 提交swap_face任务
    • ideogram 绘画
      • Generate 3.0(文生图)Generate
      • Generate 3.0(图片编辑)Edit
      • Generate 3.0(图片重制)Remix
      • Generate 3.0(图片重构)Reframe
      • Generate 3.0(替换背景) Replace Background
      • ideogram(文生图)
      • Remix(混合图)
      • Upscale(放大高清)
      • Describe(描述)
    • ChatGPT模型 gpt-image-1
      • 创建 gpt-image-1
      • 编辑 gpt-image-1
      • 蒙版 gpt-image-1
      • 创建 DALL·E 3
    • FLUX 模型
      • gpt 兼容格式
        • Flux 创建(OpenAI dall-e-3格式)
        • Flux编辑(OpenAI dall-e-3格式)
      • Replicate 官方格式
        • 接入教程
        • Flux 分辨率
        • 创建任务
        • 查询任务
      • Fal.ai 官方格式
        • 接入教程
        • 获取请求结果
          GET
        • FLUX.1 Kontext [Multi](实验性多图编辑)
          POST
    • Stable-Diffusion
      POST
    • ideogram
      POST
  • 文生视频模型
    • veo 视频生成
      • 视频统一格式
        • 创建视频
        • 查询任务
        • 创建视频,带图片
    • luma 视频生成
      • 官方API格式
        • 提交生成视频任务
        • 扩展视频
      • 查询任务
        • 查询单个任务
        • 批量获取任务
    • Kling 快手可灵
      • Callback协议
      • 图像生成
      • 文生视频
      • 图生视频
      • 查询任务(免费)
    • Runway 视频生成
      • 提交视频生成任务
      • 查询视频任务(免费)
      • 提交视频生成任务-chat格式
  • rerank 重排序模型
    • 重排序
  • GPTs 相关
    • gpt-4-all(分析图片)
    • gpt-4-all(生成图片)
    • GPTs对话
  • 文生音乐 Suno
    • 说明
    • 参数
    • 任务提交
      • 生成歌曲(灵感模式)
      • 生成歌曲(自定义模式)
      • 生成歌曲(续写模式)
      • 生成歌曲(歌手风格)
      • 生成歌曲(上传歌曲二次创作)
      • 生成歌曲(拼接歌曲)
      • 生成歌词
      • 歌曲拼接
    • 查询接口
      • 批量获取任务
      • 查询单个任务
  • 系统API
    • 获取令牌列表
    • 新增令牌
    • 获取令牌支持模型
    • 获取账号信息
  • Python配置方式
    • python openai官方库(使用AutoGPT,langchain等)
    • python 连续对话
    • python 使用 语音转文本
    • python 使用文本转语音
    • python 使用Embeddings 向量化
    • python 调用DALL·E
    • python简单调用 openai function-calling demo
    • python 简单langchain 调用openai demo
    • python llama_index 配置
    • Python使用gpt-4o识别图片-本地图片
    • python 库流式输出
    • gpt realtime模型调用
    • python request 请求 流式输出demo
    • python 使用gpt-image-1 创建编辑图片
    • Python基础对话
    • Python使用gpt-4o识别图片
    • Python使用Claude识别图片
  • nodejs 配置方式
    • nodejs 基础对话
  • php配置方式
    • php使用图片编辑demo
  • 各种插件/软件使用教程
    • Claude Code 安装使用教程
    • CherryStudio调用cluade MCP
    • Cherry Studio配置教程
    • CherryStudio配置o4推理级别
    • dify添加模型
    • cline 配置教程
    • aider 配置教程
    • Cursor 配置教程
    • lobechat 设置教程
    • ChatBox(推荐使用)
    • 开源gpt_academic
    • nextchat 设置教程
    • zotero gpt 配置方法
    • CLAUDE DEV 配置教程
    • 沉浸式翻译 设置gpt翻译
    • 浏览器插件ChatGPT Sidebar
    • chatgpt-on-wechat 配置教程
    • chatgpt GPT Academic 学术优化配置gpt教程
  • 帮助中心
    • AI返回字段: 思考相关
    • HTTP状态码及其含义
  1. Fal.ai 官方格式

接入教程

支持的模型#

如果你在官网发觉有更多好玩的模型,请联系管理员把模型加入进来
模型说明
fal-ai/flux-1/dev画图
fal-ai/flux-1/dev/image-to-image画图
fal-ai/flux-1/dev/redux画图
fal-ai/flux-1/schnell画图
fal-ai/flux-1/schnell/redux画图
fal-ai/flux-pro/kontext画图
fal-ai/flux-pro/kontext/max画图
fal-ai/flux-pro/kontext/max/multi画图
fal-ai/flux-pro/kontext/max/text-to-image画图
fal-ai/flux-pro/kontext/multi画图
fal-ai/flux-pro/kontext/text-to-image画图

Fal-ai API 接口文档#

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

1. 生成任务#

接口#

POST {{BASE_URL}}/fal-ai/{{model}}

示例#

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

返回体#

{
  "status": "IN_QUEUE",
  "request_id": "551a32da-52b2-4be8-bf2f-bfb7cce2b324",
  "response_url": "https://queue.fal.run/fal-ai/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324",
  "status_url": "https://queue.fal.run/fal-ai/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324/status",
  "cancel_url": "https://queue.fal.run/fal-ai/flux-1/requests/551a32da-52b2-4be8-bf2f-bfb7cce2b324/cancel",
  "queue_position": 0
}
说明
返回体中的 response_url 为下一步请求链接,需要将 https://queue.fal.run 替换为 你的中转地址。

2. 获取任务结果#

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

接口#

GET {BASE_URL}/fal-ai/{modelname}/requests/{request_id}

示例#


返回体.图片#

结果在 images
{
  "images": [
    {
      "url": "https://v3.fal.media/files/rabbit/aQEmU4lEKKIIr9cDOChUB.png",
      "width": 1024,
      "height": 768,
      "content_type": "image/png"
    }
  ],
  "timings": {
    "inference": 1.2249955059960485
  },
  "seed": 920212137,
  "has_nsfw_concepts": [false],
  "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 shine and depth. The word \"openai-hk\" is painted over it in big, white brush strokes with visible texture."
}

返回体.视频#

结果在 video
{
  "video": {
    "url": "https://v3.fal.media/files/lion/eSsTNfWQRXfWGim1B8ZL5_output.mp4",
    "content_type": "video/mp4",
    "file_name": "output.mp4",
    "file_size": 946834
  }
}

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

修改于 2025-07-12 07:55:58
上一页
查询任务
下一页
获取请求结果
Built with