API Stock 与 Replicate 对比
何时选择 API Stock
如果需要目录模型的生成结果,并希望避免管理模型部署和硬件,可选择 API Stock。
何时继续使用 Replicate
自定义模型部署、训练和目录之外的社区模型可继续使用 Replicate。API Stock 提供精选模型的生成 API,不替代整个模型托管平台。
Replicate API 文档横向滚动以查看表格的所有列。
| 集成细节 | Replicate | API Stock |
|---|---|---|
| 请求 | POST /v1/models/bytedance/seedream-4.5/predictions | POST /api/v1/generation/create |
| 身份验证 | Authorization: Bearer | Authorization: Bearer |
| 模型标识符 | bytedance/seedream-4.5 | seedream-4-5 |
这里只比较下方示例模型,并非服务商的全部端点。模型同名不代表参数、审核规则或输出完全一致。
价格对比:Replicate 与 API Stock
选取双方共有的模型,按相同计费单位比较。我方价格来自当前目录;对方价格为附有核查日期和来源链接的记录。
| 模型 | API Stock | Replicate | 我方价格差异 |
|---|---|---|---|
| Seedream 4.52K · 每张图片 · 文本生成图片 | API Stock$0.036 | Replicate$0.04 | 低 10% |
| Nano Banana每张图片 · 文本生成图片 | API Stock$0.015 | Replicate$0.039 | 低 61.5% |
文本生成单张图片,不含参考图片。此处为公开基础价格;订阅、批量折扣、其他分辨率和编辑可能影响最终费用。
工作量费用示例
Seedream 4.5 · 2K
按上述配置生成 1,000 张图片
- API Stock
- $36
- Replicate
- $40
Nano Banana
按上述配置生成 1,000 张图片
- API Stock
- $15
- Replicate
- $39
按上表计算的示例总价,不含批量折扣、订阅或付费附加选项。不代表相同延迟或完全一致的输出。
从 Replicate 迁移
将 replicate.run 或 prediction 创建改为 POST /api/v1/generation/create。使用公开目录 id,将 input 展平为文档参数,并通过轮询或 webhook 获取任务结果。
1
创建账号、充值预付余额并生成 API 密钥。
2
向 /api/v1/generation/create 发送 POST,填写公开模型 id 和文档中的参数。每个任务生成一个结果。
3
读取 taskId。轮询 GET /api/v1/task/status/TASK_ID,或创建时设置 webhook。
Replicate
curl --fail-with-body 'https://api.replicate.com/v1/models/bytedance/seedream-4.5/predictions' \-H "Authorization: Bearer $REPLICATE_API_TOKEN" \-H 'Content-Type: application/json' \-d '{"input": {"prompt": "A ceramic mug on a wooden table, soft morning light","size": "2K","max_images": 1}}'
API Stock
curl --fail-with-body 'https://api.api-stock.com/api/v1/generation/create' \-H "Authorization: Bearer $API_KEY" \-H 'Content-Type: application/json' \-d '{"model": "seedream-4-5","prompt": "A ceramic mug on a wooden table, soft morning light","resolution": "2K","size": "1:1"}'
完整示例:创建任务并获取文件
在服务器上使用 Node 22+ 或 Bun,并设置 API_KEY。示例只创建一个付费任务,随后轮询而不重复创建。链接有效期有限,请将文件存入自己的存储。
import { writeFile } from "node:fs/promises";const baseURL = "https://api.api-stock.com/api/v1";const apiKey = process.env.API_KEY;if (!apiKey) throw new Error("Set API_KEY on the server");async function request(path, options = {}) {const response = await fetch(baseURL + path, {...options,headers: {Authorization: `Bearer ${apiKey}`,"Content-Type": "application/json",},signal: AbortSignal.timeout(30_000),});if (!response.ok) throw new Error(await response.text());return response.json();}const { taskId } = await request("/generation/create", {method: "POST",body: JSON.stringify({"model": "seedream-4-5","prompt": "A ceramic mug on a wooden table, soft morning light","resolution": "2K","size": "1:1"}),});if (!taskId) throw new Error("Missing taskId");const deadline = Date.now() + 10 * 60_000;let fileUrl;while (Date.now() < deadline) {const { data } = await request(`/task/status/${encodeURIComponent(taskId)}`);if (data.status === "finished") {fileUrl = data.files?.[0]?.fileUrl;if (!fileUrl) throw new Error("Task finished without a file");break;}if (data.status === "failed" || data.status === "expired") {throw new Error(data.errorMessage || data.status);}await new Promise((resolve) => setTimeout(resolve, 2000));}if (!fileUrl) throw new Error(`Still processing: save taskId ${taskId} and resume polling`);const file = await fetch(fileUrl, { signal: AbortSignal.timeout(60_000) });if (!file.ok) throw new Error(`Download failed: ${file.status}`);const mime = file.headers.get("content-type")?.split(";")[0];const extension = { "image/png": "png", "image/jpeg": "jpg", "image/webp": "webp" }[mime] || "bin";await writeFile(`generated-image.${extension}`, new Uint8Array(await file.arrayBuffer()));
将 API 密钥保存在服务器端。迁移生产流量前,先测试一个请求的参数、状态处理和输出。
常见问题
如何从 Replicate 迁移?
将 replicate.run 或 prediction 创建改为 POST /api/v1/generation/create。使用公开目录 id,将 input 展平为文档参数,并通过轮询或 webhook 获取任务结果。
API Stock 总比 Replicate 便宜吗?
并非如此。请比较表中具体模型、配置和计费单位。价格可能上涨或下降;迁移生产流量前请核查双方目录。
能迁移所有 Replicate 工作流吗?
自定义模型部署、训练和目录之外的社区模型可继续使用 Replicate。API Stock 提供精选模型的生成 API,不替代整个模型托管平台。
失败或未完成的请求如何处理?
媒体任务按已配置路由重试,有可用备用服务商时才会切换。生成最终失败会退款。正在处理的任务应继续轮询,不要重复创建。文件链接过期不代表生成失败。
如何充值余额?
可用的付款方式、币种和最低充值金额会在付款前显示在您的账户中。无需订阅,模型使用费用从预付余额中扣除。
在 API Stock 尝试第一个请求
选择模型,确认参数和价格,再创建 API 密钥。迁移流量前先测试一个请求。