在线服务 · 99.9% 可用 · 平均 312ms
图片 API 站
一毛一张图
一个端口接入 8 款顶级图像模型，按张计费、失败返还、国内直连。 把生图基础设施留给我们，把好产品留给你。
99.9%
近 30 天可用率
312ms
平均首字节
8款
模型一键切换
Nano Banana 2
★ 主推new第二代绘图模型&4K
2 - 7
积分 / 张
文生图 / 图生图支持加速档
Nano Banana Pro
精准中文理解输出&4K
2 - 8
积分 / 张
文生图 / 图生图支持加速档
GPT Image 2.0
newOpenAI 图像模型 2.0
1 - 45
积分 / 张
文生图 / 图生图支持加速档9 档画质×分辨率
模块一 · 价目表
按积分计费，没有月费
招牌的 Nano Banana 系列单价最低、出图最快；其余 6 款按场景按需选用。失败、超时、审核拒绝全部自动返还。
模型简介单价能力
- GPT Image 2.0NEW
gpt-image-2-iOpenAI 图像模型 2.0
1 - 45积分 / 张文生图 / 图生图加速档9 档画质 - Nano Banana 2★ 招牌NEW
nanobanana-2第二代绘图模型&4K
2 - 7积分 / 张文生图 / 图生图加速档联网 - Nano Banana Pro★ 招牌
nano-banana-pro精准中文理解输出&4K
2 - 8积分 / 张文生图 / 图生图加速档联网 - Z Image Turbo
z-image-turbo文生图
1积分 / 张文生图 - Seedream 5.0NEW
seedream-5.0响应更精准，效果更智能
2积分 / 张文生图 / 图生图 - Wan2.5 Text to Image
wan2.5-text-to-image文生图
2积分 / 张文生图 - Qwen Image
qwen-image-edit-plus图生图
2积分 / 张图生图 - GPT Image 1.5
gpt-image-1.5文生图 / 图生图
8积分 / 张文生图 / 图生图
失败不扣积分。同一 prompt 触发审核失败、超时、网络问题，全部返还。充值额度永不过期 · 支持开发票
模块二 · 接入指南
接口使用说明
任务异步处理：generate 提交、query 轮询，也可用 callbackUrl 改为回调推送。所有内容与控制台 /settings/apikeys 接口文档完全同源。
调用流程
- 1.调用 /api/ai/generate/ 提交生成任务，获得 taskId
- 2.轮询 /api/ai/query/，直到 status 变为 success 或 failed（建议间隔 2–5 秒）
- 3.从响应的 outputImages 字段获取结果图片地址
鉴权
所有接口调用需在请求头中携带 API Key，格式如下：
Authorization: Bearer sk-<your-api-key>
Content-Type: application/json可用模型
请求时 provider 字段需与模型对应。
| model | 名称 | 支持场景 |
|---|---|---|
| gpt-image-2-i | GPT Image 2.0 | 文生图 / 图生图 |
| nanobanana-2 | Nano Banana 2 | 文生图 / 图生图 |
| nano-banana-pro | Nano Banana Pro | 文生图 / 图生图 |
| z-image-turbo | Z Image Turbo | 文生图 |
| seedream-5.0 | Seedream 5.0 | 文生图 / 图生图 |
| wan2.5-text-to-image | Wan2.5 Text to Image | 文生图 |
| qwen-image-edit-plus | Qwen Image | 图生图 |
| gpt-image-1.5 | GPT Image 1.5 | 文生图 / 图生图 |
文生图 = 文字描述生成图片，图生图 = 基于输入图片进行编辑或风格转换
POST
/api/ai/generate/提交 AI 生图任务。接口立即返回 taskId，任务异步处理，通过 /api/ai/query/ 轮询结果。请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| mediaType | string | ✓ | 固定填 "image" |
| model | string | ✓ | 模型标识符，见上方可用模型列表 |
| prompt | string | ✓ | 生成提示词 |
| scene | string | 默认 text-to-image；图生图传 image-to-image | |
| options.aspectRatio | string | 宽高比，如 "1:1"、"16:9"、"9:16" | |
| options.resolution | string | 分辨率档位，如 "1K"、"2K"、"4K" | |
| options.speed_mode | string | "seed"（加速）或 "noseed"（非加速），仅部分模型支持 | |
| options.image_urls | string[] | 输入图片 URL 数组，image-to-image 场景下使用 | |
| callbackUrl | string | 任务完成后回调的 HTTPS 地址（可选）。任务完成或失败时，系统将向该地址发送 POST 请求，附带任务结果 |
请求示例（curl）
# 提交一个生图任务
curl -X POST https://www.nano-banana.cn/api/ai/generate/ \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"mediaType": "image",
"model": "nanobanana-2",
"prompt": "a cute panda eating bamboo",
"scene": "text-to-image",
"callbackUrl": "https://your-server.com/callback",
"options": { "aspectRatio": "1:1" }
}'
# 响应
# { "code": 0, "message": "ok", "data": { "id": "3f2a1b4c-...", "status": "queuing" } }响应示例
{
"code": 0,
"message": "ok",
"data": {
"id": "3f2a1b4c-...",
"status": "queuing"
}
}回调通知（Callback）
若传入 callbackUrl，任务完成（成功或失败）后，系统将向该地址发送一次 POST 请求：
回调 Payload 示例
{
"id": "3f2a1b4c-...",
"status": "success",
"outputImages": [
"https://r2.nano-banana.cn/outputs/xxx.png"
]
}POST
/api/ai/query/查询任务状态与生成结果。建议每 2–5 秒轮询一次，收到 success 或 failed 后停止。请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| taskId | string | ✓ | 由 /api/ai/generate/ 返回的任务 ID |
请求示例（curl）
# 轮询任务结果
curl -X POST https://www.nano-banana.cn/api/ai/query/ \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{ "taskId": "3f2a1b4c-..." }'
# 处理中响应
# { "code": 0, "data": { "id": "...", "status": "processing", "outputImages": null } }
# 成功响应
# { "code": 0, "data": { "id": "...", "status": "success", "outputImages": ["https://r2.nano-banana.cn/outputs/xxx.png"] } }处理中响应
{
"code": 0,
"message": "ok",
"data": {
"id": "3f2a1b4c-...",
"status": "processing",
"outputImages": null
}
}成功响应
{
"code": 0,
"message": "ok",
"data": {
"id": "3f2a1b4c-...",
"status": "success",
"outputImages": [
"https://r2.nano-banana.cn/outputs/xxx.png"
]
}
}任务状态说明
| status | 说明 |
|---|---|
| queuing | 已入队，等待处理 |
| pending | 已提交至 AI 提供商，等待响应 |
| processing | AI 提供商处理中 |
| success | 生成成功，可从 outputImages 获取图片地址 |
| failed | 生成失败，已自动退还消耗的积分 |
错误响应
请求失败时 code 为 -1，message 描述错误原因：
{
"code": -1,
"message": "insufficient credits"
}no authAPI Key 无效或未传入insufficient credits积分不足task not found任务不存在no permission无权访问该任务（任务属于其他用户）
模块三 · 你的密钥
一键创建 API Key
无需跳转，直接在当前页面创建并复制密钥。每个账号最多 10 个 Key，可分别用于不同项目方便撤销。
模块四 · 常见问题
开发者常问的 12 件事
没找到答案？微信加 banana-cs 工作时间 5 分钟内回复。