一个端口接入 8 款顶级图像模型，按张计费、失败返还、稳定可用。 把生图基础设施留给我们，把好产品留给你。
第二代绘图模型&4K
精准中文理解输出&4K
OpenAI 图像模型 2.0
招牌的 Nano Banana 系列单价最低、出图最快；其余 6 款按场景按需选用。失败、超时、审核拒绝全部自动返还。
gpt-image-2OpenAI 图像模型 2.0
nano-banana-2第二代绘图模型&4K
nano-banana-pro精准中文理解输出&4K
seedance-2.0标准档 · 唯一支持 1080p / 4K
seedance-2.0-fast加速档 · 速度更快
seedance-2.0-mini轻量档 · 性价比首选
veo-3.1Google Veo 3.1 · 原生音轨 · 高保真
veo-3.1-fast加速档 · 速度优先
kling-v3首尾帧控制 · 最高 4K
gemini-omni-flash多模态参考 · 视频编辑
任务异步处理：generate 提交、query 轮询，也可用 callbackUrl 改为回调推送。所有内容与控制台 /settings/apikeys 接口文档完全同源。
所有接口调用需在请求头中携带 API Key，格式如下：
Authorization: Bearer sk-<your-api-key>
Content-Type: application/json| model | 名称 | 支持场景 |
|---|---|---|
| gpt-image-2 | GPT Image 2.0 | 文生图 / 图生图 |
| nano-banana-2 | Nano Banana 2 | 文生图 / 图生图 |
| nano-banana-pro | Nano Banana Pro | 文生图 / 图生图 |
| seedance-2.0 | Seedance 2.0 | 文生图 |
| seedance-2.0-fast | Seedance 2.0 Fast | 文生图 |
| seedance-2.0-mini | Seedance 2.0 Mini | 文生图 |
| veo-3.1 | VEO 3.1 | 文生图 |
| veo-3.1-fast | VEO 3.1 Fast | 文生图 |
| kling-v3 | Kling V3 | 文生图 |
| gemini-omni-flash | Gemini Omni Flash | 文生图 |
文生图 = 文字描述生成图片，图生图 = 基于输入图片进行编辑或风格转换
/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 -X POST https://www.pixzoo.ai/api/ai/generate/ \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"mediaType": "image",
"model": "nano-banana-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"
}
}若传入 callbackUrl，任务完成（成功或失败）后，系统将向该地址发送一次 POST 请求：
{
"id": "3f2a1b4c-...",
"status": "success",
"outputImages": [
"https://gempix.cn/outputs/xxx.png"
]
}/api/ai/query/查询任务状态与生成结果。建议每 2–5 秒轮询一次，收到 success 或 failed 后停止。| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| taskId | string | ✓ | 由 /api/ai/generate/ 返回的任务 ID |
# 轮询任务结果
curl -X POST https://www.pixzoo.ai/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://gempix.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://gempix.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无权访问该任务（任务属于其他用户）无需跳转，直接在当前页面创建并复制密钥。每个账号最多 10 个 Key，可分别用于不同项目方便撤销。
没找到答案？微信加 banana-cs 工作时间 5 分钟内回复。