Replicate / fal.ai 配置
Replicate 和 fal.ai 更像“模型 API 平台”。它们可以调用图片、音频、视频等模型，但不是所有模型都用同一套参数。新手要先选具体模型，再看该模型页面给出的输入字段。
官方信息 下载和文档以官方站点为准
和普通中转站有什么不同
| 平台 | 你要先准备什么 | 注意点 |
|---|---|---|
| Replicate | API Token、模型页面、输入参数 | 官方 Node SDK 通常从 REPLICATE_API_TOKEN 读取 Token；不同模型的 input 字段不同。 |
| fal.ai | FAL_KEY、模型 ID、输入参数 | 官方 JS 客户端通常从 FAL_KEY 读取 Key；也要看具体模型页面字段。 |
| 普通聊天中转 | Key、Base URL、模型名 | 主要是文字/多模态聊天，不等于支持全部图片视频模型 |
先读懂具体模型页面
| 页面字段 | 是什么意思 | 怎么填 |
|---|---|---|
| 模型 ID / 版本 | 要调用哪一个具体模型 | Replicate 常见格式是模型页面给出的 owner/model 或 owner/model:version；fal.ai 按模型页 ID 填 |
| Input schema | 这个模型需要哪些输入字段 | 逐项按模型页填写，不要把另一个模型的字段搬过来 |
| Output | 返回结果长什么样 | 可能是图片 URL、视频 URL、数组或任务对象，调用后要按返回格式取结果 |
| 示例代码 | 官方给当前模型生成的调用示例 | 优先从模型页复制当前示例，再替换自己的 Key 和输入内容 |
请求示例
下面两种平台的写法不要混用。你用哪个平台，就切到对应 Tab，只替换自己的 Key、模型 ID 和 input 字段。
Replicate 创建预测任务示例
import Replicate from "replicate"; const replicate = new Replicate({ auth: process.env.REPLICATE_API_TOKEN }); const output = await replicate.run("模型页面上的 owner/model:version", { input: { prompt: "一段干净的产品展示视频", duration: 5 } }); console.log(output);fal.ai 调用模型示例
import { fal } from "@fal-ai/client"; fal.config({ credentials: process.env.FAL_KEY }); const result = await fal.subscribe("模型页面上的模型 ID", { input: { prompt: "一张写实风格的产品海报", image_size: "square_hd" }, logs: true }); console.log(result.data);字段怎么核对
这类平台最关键的是“具体模型页面”。不要只复制平台 Key，还要照着模型页面填写 input 字段。
| 报错或现象 | 常见原因 | 处理方式 |
|---|---|---|
| 模型找不到 | 模型 ID、版本号或命名空间写错 | 回模型页面复制完整调用名称 |
| input 字段报错 | 字段名、类型或必填项不符合当前模型要求 | 对照模型页 input schema，少一项补一项 |
| 返回结果为空 | 任务还没完成，或输出字段不是你读取的那个位置 | 先打印完整返回结果，再按 output 结构取 URL 或文件 |