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 或文件 |
