APIMPAPIMP
ユーザーガイドAI API画像 API動画 API公開 API

nano-banana-pro

nano-banana-pro（Gemini 3 Pro Image Preview）の非同期画像生成タスクを送信します。task_id が返るので、状態取得エンドポイントでポーリングしてください。

POST
/api/generate/submit

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

In: header

Request Body

application/json

model*string

模型名。固定为 nano-banana-pro

input*object
prompt*string
size?string

比例 1:1 / 16:9 / 9:16 / auto，或像素形态 1024x1024

image?string

单张参考图 URL（图生图 / 编辑）

images?array<string>

多张参考图 URL；最多 14 张

Itemsitems <= 14
metadata?object

模型专属参数。

resolution?string

输出分辨率

Value in"0.5K" | "1K" | "2K" | "4K"
n?integer
Range1 <= value <= 4
mask_url?string

编辑模式蒙版 URL（nano-banana-pro 编辑用）

official_fallback?boolean

上游失败时是否回退到官方通道

model_params?object

完全透传到上游的额外字段

[key: string]?any
[key: string]?never

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/api/generate/submit" \  -H "Content-Type: application/json" \  -d '{    "model": "nano-banana-pro",    "input": {      "prompt": "A cyberpunk samurai portrait, neon reflections"    }  }'
{
  "code": 200,
  "data": {
    "task_id": "task_0VDknz6qRwvH5Y5aDAt6mN8pRShzLb6X",
    "status": "not_started",
    "created_time": "2026-06-18T09:21:26",
    "error_message": null
  }
}

{
  "code": 400,
  "error": {
    "message": "input.prompt is required",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}
{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}
{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}
{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}

このガイドはいかがですか？

最終更新