1. Fal-ai
Pi API 文档中心
  • 服务介绍
  • 快速开始
  • 平台介绍
    • API Key 额度查询
    • 在线调试说明
    • 如何新建指定分组的令牌
    • 免费 AI 聊天体验
    • API 分组类型对比指南
    • 分组的特殊性及价格差异
    • 代理接口调用地址
  • 第三方工具接入
    • IDE与编程工具
      • Claude Code 安装使用教程
      • Codex 安装与配置教程
      • Claude DEV 配置教程
      • Cursor 配置教程
      • Gemini CLI 中文使用指南
      • opencode 配置教程
      • OpenClaw 最新版本 自定义中转站配置教程
      • aider 配置教程
      • Cline 配置教程
      • OpenClaw配合CC switch自定义中转站配置
      • OpenClaw Clawdbot 自定义中转站配置教程
    • AI聊天客户端
      • ChatBox 配置教程
      • Cherry Studio 配置教程
      • NextChat 配置教程
      • LobeChat 配置教程
      • CherryStudio 配置 o4 推理级别
      • CherryStudio 调用 Claude MCP
      • RikkaHub 配置教程
      • Cherry Studio 配置 4K 分辨率教程
    • 工作流与自动化
      • Coze 使用中转 API 教程
      • Coze 工作流从输入到获取 URL
      • Dify 添加模型
      • N8N 使用中转 API 教程
      • N8N 获取本地图片生成视频
    • 微信与社交
      • chatgpt-on-wechat 配置教程
    • 学术与翻译
      • 沉浸式翻译配置教程
      • 开源 GPT Academic 配置
      • Zotero GPT 配置教程
      • GPT Academic 配置教程
      • 浏览器插件 ChatGPT Sidebar 配置教程
  • 绘画模型
    • 豆包系列
      • 创建图片
    • Grok Image 系列
      • 创建 Image
      • 编辑 image
    • Midjourney
      • 提交Modal
      • 上传图片
      • 提交Describe任务
      • 执行Action动作
      • 根据任务ID 查询任务状态
      • 获取任务图片的seed
      • 提交Blend任务
      • 根据ID列表查询任务
      • 提交Imagine任务
    • Ideogram
      • ideogram(文生图)
      • Generate 3.0(图片编辑)Edit
      • Describe(描述)
      • Upscale(放大高清)
      • Generate 3.0(替换背景) Replace Background
      • Remix(混合图)
    • FLUX 系列
      • Replicate 官方格式
        • Flux 分辨率
        • Flux 分辨率
      • gpt 兼容格式
        • Flux 创建(OpenAI dall-e-3格式)
        • Flux编辑(OpenAI dall-e-3格式)
    • 千问Qwen 系列
      • qwen-image-edit-2509
      • z-image-turbo
      • qwen-image-max
      • z-image-turbo
    • GPT Image 系列
      • 创建 gpt-image-1.5
      • 编辑 gpt-image-1
      • 蒙版 gpt-image-1.5
      • 创建 gpt-image-1
      • 蒙版 gpt-image-1
      • 编辑 gpt-image-1.5
    • Fal.ai平台
      • /fal-ai/nano-banana 文生图
      • /fal-ai/nano-banana/edit 图片编辑
    • DALL·E 3
      • 创建 DALL·E 3
  • 聚合平台
    • Replicate
      • 创建任务 black-forest-labs/flux-kontext-pro
      • 查询任务
      • 创建任务 black-forest-labs/flux-kontext-dev
      • 创建任务 sujaykhandekar/object-removal
      • 创建任务 flux-kontext-apps/multi-image-kontext-pro
      • 查询任务
      • 创建任务 google/imagen-4
      • 创建任务 lucataco/animate-diff
      • 创建任务 lucataco/remove-bg
      • 查询任务
      • 创建任务 black-forest-labs/flux-fill-pro
      • 创建任务 stability-ai/stable-diffusion
      • 创建任务 black-forest-labs/flux-fill-dev
      • 创建任务 google/imagen-4-fast
      • 创建任务 prunaai/vace-14b
      • 创建任务 recraft-ai/recraft-v3-svg
      • 创建任务 andreasjansson/stable-diffusion-animation
      • 创建任务 black-forest-labs/flux-1.1-pro-ultra
      • 创建任务 black-forest-labs/flux-kontext-dev
      • 创建任务 stability-ai/stable-diffusion-inpainting
      • 创建任务 cjwbw/rembg
      • 创建任务 google/imagen-4-ultra
      • 创建任务 stability-ai/stable-diffusion-img2img
      • 创建任务 ideogram-ai/ideogram-v2-turbo
      • 创建任务 lucataco/flux-schnell-lora
      • 创建任务 flux-kontext-apps/multi-image-kontext-max
      • 创建任务 minimax/video-01-live
      • 创建任务-通过模型version(predictions)
      • 创建任务 riffusion/riffusion
      • 创建任务 black-forest-labs/flux-kontext-max
      • 创建任务 recraft-ai/recraft-v3
      • 查询任务
      • 创建任务 bytedance/seedream-4
      • 创建任务 stability-ai/sdxl
      • 创建任务 lucataco/flux-dev-lora
      • 创建任务 minimax/video-01
      • 查询任务
    • Fal-ai
      • /fal-ai/vidu/reference-to-image
      • 接入教程
      • /fal-ai/imagen4/preview
      • /fal-ai/bytedance/seedream/v4/text-to-image
      • /fal-ai/bytedance/seedream/v4/edit
      • /fal-ai/kling-video/v2.5-turbo/pro/text-to-video
      • 获取请求结果
      • 接入教程
      • /fal-ai/flux-pro/kontext
      • /fal-ai/flux-1/dev
      • /fal-ai/qwen-image-edit-lora
      • /fal-ai/flux-lora
      • 获取请求结果
      • /fal-ai/flux-1/dev/image-to-image
      • /fal-ai/qwen-image-edit-plus
      • /fal-ai/kling-video/v2.5-turbo/pro/text-to-video
      • /fal-ai/flux-pro/kontext/max
      • 获取请求结果
      • /fal-ai/flux-1/schnell/redux
      • /fal-ai/flux-lora/image-to-image
      • 接入教程
      • /fal-ai/flux-pro/kontext/text-to-image
      • /fal-ai/flux-1/dev/redux
      • 获取请求结果
      • /fal-ai/flux-lora/inpainting
      • /fal-ai/flux-pro/kontext/max/multi
      • 获取请求结果
      • /fal-ai/kling-video/v2.5-turbo/pro/image-to-video
      • /fal-ai/wan/v2.2-a14b/image-to-image
      • /fal-ai/qwen-image-edit-lora
      • falai-veo3 视频生成
        • /fal-ai/veo3/requests/{request_id}
        • /fal-ai/veo3/fast/image-to-video
        • /fal-ai/veo3
        • /fal-ai/veo3/image-to-video
        • /fal-ai/veo3/fast
  • 编程接入
    • Node.js
      • Node.js 基础对话
    • PHP
      • PHP 图片编辑示例
    • Python
      • Python 连续对话
      • 语音转文本 API 指南
      • Python LangChain 调用
      • Python 使用 Claude 识别图片
      • Python Realtime 模型调用
      • Python 基础对话
      • 文字转语音 (TTS) API 指南
      • Python 使用 GPT-4o 识别图片
      • Python Function Calling
      • Python 使用 GPT-4o 识别本地图片
      • Python 流式输出(Requests)
      • OpenAI 官方库配置
      • Python 流式输出(SDK)
      • Embeddings 向量化
      • GPT-Image-1 图片生成与编辑
      • 图像生成 API 指南(DALL·E)
      • Python LlamaIndex 配置
  • 音乐模型
    • 文生音乐 Suno
      • 说明
      • 参数
      • 查询接口
        • 查询单个任务
        • 查询单个任务
        • 批量获取任务
        • 场景详情获取
        • 获取wav
        • 批量获取任务
        • Timing:歌词、音频时间线
        • 查询单个任务
      • 任务提交
        • 生成歌曲(歌手风格)
        • 生成歌曲(灵感模式)
        • 生成歌曲(拼接歌曲)
        • 查询上传处理状态
        • 场景一: 灵感模式
        • 请求上传授权
        • 场景二: 自定义.歌词歌名
        • 歌曲拼接
        • 场景三: 纯音乐.自定义
        • 报告上传完毕
        • 生成歌词
        • 生成歌曲(自定义模式)
        • 生成歌曲(上传歌曲二次创作)
        • s3上传示例
        • 生成歌曲(续写模式)
        • 初始化音频文件
    • MINIMAX官方
      • 同步语音合成 V2
      • 查询视频生成任务状态
      • 音色快速复刻
      • 文生图生视频生成任务
      • 音色设计
      • 上传复刻音频
      • 首尾帧生成视频
      • 创建异步语音合成任务 V2
      • 上传示例音频
      • 查询语音生成任务状态
      • 文本合成
      • 检索(用于视频下载,异步音频下载)
  • 视频模型
    • 可灵 Kling 平台
      • Callback协议
      • 文生视频
        • 文生视频
      • 多图参考生视频
        • 多图参考生视频
      • 对口型
        • 对口型
        • 人脸识别
      • 动作控制
        • 查询任务(单个)
        • 查询任务(单个)
        • 查询任务(单个)
        • 查询任务(单个)
        • 查询任务(单个)
        • 查询任务(单个)
        • 动作控制
        • 查询任务(单个)
        • 查询任务(单个)
        • 查询任务(单个)
        • 查询任务(单个)
        • 查询任务(单个)
        • 查询任务(单个)
        • 查询任务(单个)
        • 查询任务(单个)
        • 查询任务(单个)
        • 查询任务(单个)
        • 查询任务(单个)
      • 视频延长
        • 视频延长
      • 文生音效
        • 文生音效
      • 自定义音色
        • 删除自定义音色
        • 查询自定义音色(单个)
        • 自定义音色
        • 查询官方音色
      • 多图参考生图
        • 多图参考生图
      • 视频生音效
        • 视频生音效
      • 图像生成
        • 图像生成
      • 视频特效
        • 视频特效
      • Omni-Video
        • Omni-Video
      • 虚拟试穿
        • 虚拟试穿
      • 数字人
        • 数字人
      • 多模态视频编辑
        • 删减视频选区
        • 多模态视频
        • 初始化待编辑视频
        • 预览已选区视频
        • 增加视频选区
      • 图像识别
        • 图像识别
      • 扩图
        • 扩图
      • 主体
        • 主体
      • Omni-Image
        • Omni-Image
    • sora 视频生成
      • OpenAI官方视频格式
        • openai 编辑视频
        • 创建视频
        • openai 查询任务
        • 创建视频
        • 创建视频
        • openai 下载视频
        • openai 查询任务
        • 创建一个来自上传视频的角色
        • openai 下载视频
        • 创建视频
      • chat格式
        • 连续修改生成视频
        • 创建视频, 带图片
      • 统一视频格式
        • 创建视频 sora-2-pro
        • 创建视频 (带 Character)
        • 创建视频 sora-2
        • 创建视频,带图片 sora-2
        • 创建角色
    • 通义万象 视频生成
      • 生成视频
      • 视频查询
    • 官方VIDU视频生成、图片生成、音频生成
      • 状态码
      • 状态码
      • 创建图片生成任务
      • 状态码
      • 语音合成
      • 创建文生音频任务
      • 语音合成
      • 创建首尾帧生视频任务
      • 创建文生视频任务
      • 创建参考生视频任务
      • 状态码
      • 状态码
      • 状态码
      • 状态码
      • 状态码
      • 状态码
      • 创建图生视频任务
    • luma 视频生成
      • 官方API格式
        • 提交生成视频任务
    • grok 视频生成
      • 视频统一格式
        • 扩展视频
        • 扩展视频
    • 海螺 视频生成
      • 图生视频
      • 视频任务状态查询
      • 首尾帧视频
      • 图生视频
    • Runway 视频生成
      • 提交视频生成任务
      • 提交视频生成任务
      • 查询视频任务(免费)
    • 腾讯AIGC视频生成
      • 特效模板创建任务
      • 创建任务
      • 创建任务
      • 创建任务
    • 豆包 视频生成
      • seedance-1-5-pro
      • 查询视频生成任务列表-默认
      • 查询视频生成任务列表-搜索多个任务 ID
    • veo 视频生成
      • 视频统一格式
        • 创建视频,带图片
        • 创建视频(参考图)
      • OpenAI 视频格式
        • openai 创建视频,带图片
  • 文本生成
    • Anthropic Claude 接口
      • 聊天完成对象
      • 聊天完成对象
      • 聊天完成块对象
      • 聊天完成块对象
      • 原生格式
        • 创建函数调用 (流式)
        • PDF支持 base64格式
        • 联网搜索
        • 创建思考聊天
        • 创建思考聊天
      • chat兼容格式
        • 创建聊天补全 (流式)
        • 创建聊天识图 (非流)
        • 创建聊天识图 (非流)
        • 创建聊天补全 (流式)
        • 创建聊天识图 (流式)
        • 创建聊天识图 (流式)
        • 创建聊天补全 (流式)
    • ChatGpt 接口
      • ChatGPT自动补全(Completions)
        • 完成对象
        • 创建完成
      • ChatGPT聊天(Chat)
        • 创建结构化输出
        • 创建聊天补全 qwen-mt-turbo
        • 列出模型
        • 创建聊天识图 (流式) best64
        • 官方Function calling调用
        • 官方N测试
        • 创建聊天函数调用
        • deepseek-ocr 识别
        • 创建聊天创作图 (非流)
        • 创建聊天补全 deepseek v3.1思考程度 (流式)
        • 控制推理模型努力程度
      • ChatGPT音频(Audio)
        • 创建语音 gpt-4o-mini-tts
        • 音频转文字 whisper-1
        • 创建翻译 (不支持)
        • 音频转文字 gpt-4o-transcribe
        • GPT-4o-audio
      • ChatGPT嵌入(Embeddings)
        • 创建嵌入
        • 嵌入对象
      • Web 搜索
        • web搜索
    • 谷歌Gemini 接口
      • 原生格式
        • 文档理解
        • 图片生成
        • Embeddings
        • 代码执行
        • 视频理解
        • 音频理解
        • 图片理解
        • URL context
        • 文本生成 gemini-3-pro-preview:generateContent
        • 图片生成 gemini-2.5-flash-image 控制宽高比
        • TTS 文本转语音
        • 文本嵌入
        • 文本生成
        • 图片生成 gemini-2.5-flash-image
        • 图片生成 gemini-3-pro-image-preview 控制宽高比 +清晰度
        • gemini-tts文本转语音
        • 函数调用
        • google search
        • 格式化输出
      • chat兼容格式
        • 文本嵌入 [chat兼容格式]
        • 聊天接口 [chat兼容格式]
        • 识图接口 [chat兼容格式]
        • gemini图片创作接口 [chat兼容格式]
    • 聊天Responses
      • 创建函数调用 Copy
      • Responses API与Chat API对比
      • 创建模型响应
      • 创建模型响应(流式返回)
      • 创建模型响应 gpt-5启用思考
      • 创建函数调用
      • 创建模型响应 (控制思考长度)
      • 创建网络搜索
  • 帮助中心
    • HTTP 状态码及其含义
    • AI 返回字段 - 思考相关
Pi API 首页控制台模型广场
Pi API 首页控制台模型广场
  1. Fal-ai

接入教程

Replicate 官方格式调用#

| 如果有需要的模型可以联系客服添加
将官网的 https://api.replicate.com 更换为 {{BASE_URL}}/replicate
输入、输出、请求方式跟官网一致
接入流程
1.
创建任务
提交任务后,获取到任务 ID
2.
获取任务进度
通过任务ID查询任务进度,获取结果
PS:返回的资源连接仅有1个小时有效期
返回体 关键字段说明
项目 类型 说明
input object 输入
output string 或者 []string 内容输出 url
status string 状态 状态 starting processing succeeded failed
1.生成任务.路径方式
以 black-forest-labs/flux-schnell 为例
返回体 id 为下一步查询任务 id
{
  "id": "qpt5jq1fssrmc0cmd5hvy31mdg",
  "model": "black-forest-labs/flux-schnell",
  "version": "dp-4d0bcc010b3049749a251855f12800be",
  "input": {
    "aspect_ratio": "1:1",
    "go_fast": true,
    "megapixels": "1",
    "num_inference_steps": 4,
    "num_outputs": 1,
    "output_format": "jpg",
    "output_quality": 80,
    "prompt": "Japanese cartoon anime style, (1 person) (Gender: Male, Age: 30, Hair: Short black hair, Outfit: Dark blue hunting attire, includes a fitted jacket and trousers.) (A dimly lit room filled with tension,  is questioning Female, 27 years old, long black hair, pink tulle dress., who stands nervously in her pink dress, the sound of rain pattering against the window.)"
  },
  "logs": "",
  "output": null,
  "data_removed": false,
  "error": null,
  "status": "starting",
  "created_at": "2025-01-15T09:54:55.566Z",
  "urls": {
    "cancel": "https://api.replicate.com/v1/predictions/qpt5jq1fssrmc0cmd5hvy31mdg/cancel",
    "get": "https://api.replicate.com/v1/predictions/qpt5jq1fssrmc0cmd5hvy31mdg",
    "stream": "https://stream.replicate.com/v1/files/bcwr-gvuc2rokjozhlaxh6dcvk6tvhh2ymt4egnnpxvmtqql57angyfsq"
  }
}
2.生成任务.version 方式
以 lucataco/flux-schnell-lora 为例子
参考文档 https://replicate.com/lucataco/flux-schnell-lora?input=http
通过参考文档 得到 version 为 2a6b576af31790b470f0a8442e1e9791213fa13799cbb65a9fc1436e96389574
返回体格式上面格式一致
获取任务
通过上面的生产任何获取到 任务 id
结果在关键字段 output 上
注意 返回结果及其链接文件都有时效性
get {{BASE_URL}}/replicate/v1/predictions/{id}
返回体
{
  "id": "ctdwaehfz1rm80cmd5nsjd8114",
  "model": "black-forest-labs/flux-schnell",
  "version": "dp-4d0bcc010b3049749a251855f12800be",
  "input": {
    "aspect_ratio": "1:1",
    "go_fast": true,
    "megapixels": "1",
    "num_inference_steps": 4,
    "num_outputs": 1,
    "output_format": "jpg",
    "output_quality": 80,
    "prompt": "Japanese cartoon anime style, (1 person) (Gender: Male, Age: 30, Hair: Short black hair, Outfit: Dark blue hunting attire, includes a fitted jacket and trousers.) (A dimly lit room filled with tension,  is questioning Female, 27 years old, long black hair, pink tulle dress., who stands nervously in her pink dress, the sound of rain pattering against the window.)"
  },
  "logs": "Using seed: 62182\nrunning quantized prediction\nUsing seed: 62182\n  0%|          | 0/4 [00:00<?, ?it/s]\n 75%|███████▌  | 3/4 [00:00<00:00, 15.38it/s]\n100%|██████████| 4/4 [00:00<00:00, 13.43it/s]\nTotal safe images: 1 out of 1\n",
  "output": [
    "https://replicate.delivery/xezq/RoEhEdyl8PoIGFFPg46TU4Svj24i1NDVYmzehJfqLuX9nTFUA/out-0.jpg"
  ],
  "data_removed": false,
  "error": null,
  "status": "succeeded",
  "created_at": "2025-01-15T10:03:39.896Z",
  "started_at": "2025-01-15T10:03:40.584470194Z",
  "completed_at": "2025-01-15T10:03:41.142386377Z",
  "urls": {
    "cancel": "https://api.replicate.com/v1/predictions/ctdwaehfz1rm80cmd5nsjd8114/cancel",
    "get": "https://api.replicate.com/v1/predictions/ctdwaehfz1rm80cmd5nsjd8114",
    "stream": "https://stream.replicate.com/v1/files/bcwr-q57vie7wuzg3wxv2hvpajgmzqzmxe67kqddednevutmrpdcft6xq"
  },
  "metrics": {
    "image_count": 1,
    "predict_time": 0.557916184
  }
}
修改于 2026-03-31 14:05:36
上一页
/fal-ai/vidu/reference-to-image
下一页
/fal-ai/imagen4/preview
Built with