New: Nano Banana 2.1Try the model
API Stock

API Stock 与 PiAPI

PiAPI 替代方案

比较 PiAPI 与 API Stock 的图片生成、预付计费和结果交付。表中包含 Nano Banana 及 Nano Banana Pro 的两种分辨率。

API Stock 与 PiAPI 对比

何时选择 API Stock

对于已支持的 PiAPI 模型,如果偏好 Bearer 验证及扁平请求体,而非单独的 model 和 task_type,可选择 API Stock。

何时继续使用 PiAPI

PiAPI 的部分任务类型和自有账号托管流程在此没有直接对应方案。请逐项检查;模型名称相同不代表支持全部任务类型。

PiAPI API 文档

横向滚动以查看表格的所有列。

API 迁移:从 PiAPI 到 API Stock
集成细节PiAPIAPI Stock
请求POST /api/v1/taskPOST /api/v1/generation/create
身份验证X-API-KeyAuthorization: Bearer
模型标识符model: gemini / task_type: gemini-2.5-flash-imagenano-banana

这里只比较下方示例模型,并非服务商的全部端点。模型同名不代表参数、审核规则或输出完全一致。

价格对比:PiAPI 与 API Stock

选取双方共有的模型,按相同计费单位比较。我方价格来自当前目录;对方价格为附有核查日期和来源链接的记录。

价格对比:PiAPI 与 API Stock
Nano Banana每张图片 · 文本生成图片API Stock$0.015PiAPI$0.03低 50%
Nano Banana Pro1K · 每张图片 · 文本生成图片API Stock$0.04PiAPI$0.105低 61.9%
Nano Banana Pro4K · 每张图片 · 文本生成图片API Stock$0.05PiAPI$0.18低 72.2%

文本生成单张图片,不含参考图片。此处为公开基础价格;订阅、批量折扣、其他分辨率和编辑可能影响最终费用。

工作量费用示例

Nano Banana

按上述配置生成 1,000 张图片

API Stock
$15
PiAPI
$30

Nano Banana Pro · 1K

按上述配置生成 1,000 张图片

API Stock
$40
PiAPI
$105

按上表计算的示例总价,不含批量折扣、订阅或付费附加选项。不代表相同延迟或完全一致的输出。

定价

从 PiAPI 迁移

将 X-API-Key 改为 Authorization: Bearer,将 model、task_type 和 input 转换为公开模型 id 及文档参数。将 task_id 改为 taskId,并适配状态和 webhook 解析。

  1. 1

    创建账号、充值预付余额并生成 API 密钥。

  2. 2

    向 /api/v1/generation/create 发送 POST,填写公开模型 id 和文档中的参数。每个任务生成一个结果。

  3. 3

    读取 taskId。轮询 GET /api/v1/task/status/TASK_ID,或创建时设置 webhook。

PiAPI

bash
curl --fail-with-body 'https://api.piapi.ai/api/v1/task' \
-H "X-API-Key: $PIAPI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "gemini",
"task_type": "gemini-2.5-flash-image",
"input": {
"prompt": "A ceramic mug on a wooden table, soft morning light",
"aspect_ratio": "1:1"
}
}'

API Stock

bash
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": "nano-banana",
"prompt": "A ceramic mug on a wooden table, soft morning light"
}'
完整示例:创建任务并获取文件

在服务器上使用 Node 22+ 或 Bun,并设置 API_KEY。示例只创建一个付费任务,随后轮询而不重复创建。链接有效期有限,请将文件存入自己的存储。

javascript
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": "nano-banana",
"prompt": "A ceramic mug on a wooden table, soft morning light"
}),
});
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 密钥保存在服务器端。迁移生产流量前,先测试一个请求的参数、状态处理和输出。

常见问题

如何从 PiAPI 迁移?

将 X-API-Key 改为 Authorization: Bearer,将 model、task_type 和 input 转换为公开模型 id 及文档参数。将 task_id 改为 taskId,并适配状态和 webhook 解析。

API Stock 总比 PiAPI 便宜吗?

并非如此。请比较表中具体模型、配置和计费单位。价格可能上涨或下降;迁移生产流量前请核查双方目录。

能迁移所有 PiAPI 工作流吗?

PiAPI 的部分任务类型和自有账号托管流程在此没有直接对应方案。请逐项检查;模型名称相同不代表支持全部任务类型。

失败或未完成的请求如何处理?

媒体任务按已配置路由重试,有可用备用服务商时才会切换。生成最终失败会退款。正在处理的任务应继续轮询,不要重复创建。文件链接过期不代表生成失败。

如何充值余额?

可用的付款方式、币种和最低充值金额会在付款前显示在您的账户中。无需订阅,模型使用费用从预付余额中扣除。

在 API Stock 尝试第一个请求

选择模型,确认参数和价格,再创建 API 密钥。迁移流量前先测试一个请求。