图片 API 站
一毛一张图

Upload Parameters

Uploads use multipart/form-data. Let the client set Content-Type and its boundary automatically; do not use application/json or manually set multipart/form-data without a boundary.

Upload Examples

curl -X POST https://www.nano-banana.cn/api/storage/upload-image \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "files=@./reference.png" \
  -F "files=@./reference-2.jpg"

Upload Response and Image-to-Image Usage

{
  "code": 0,
  "message": "ok",
  "data": {
    "urls": [
      "https://r2.nano-banana.cn/uploads/example.png"
    ],
    "results": [
      {
        "url": "https://r2.nano-banana.cn/uploads/example.png",
        "key": "uploads/example.png",
        "filename": "reference.png"
      }
    ]
  }
}

data.urls contains image URLs in upload order. data.results contains each file’s url, storage key and original filename. The example domain is illustrative; use the URLs returned by the API.

Pass data.urls as options.image_urls to POST /api/ai/generate/ and set scene to image-to-image. Reference count, format and size must satisfy the selected model and site prechecks.

Check the business code as well as the HTTP status: 0 means success and -1 means failure. Common errors include no auth, please sign in, No files provided, File … is not an image, and upload image failed. If a multi-file upload fails partway through, earlier files may already be stored. Only use the complete URL array when code is 0.

Request Parameters

Example (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",
    "options": { "aspectRatio": "1:1" }
  }'

# 响应
# { "code": 0, "message": "ok", "data": { "id": "3f2a1b4c-...", "status": "queuing", "costCredits": 2 } }

Image editing example: separate quality and resolution

{
  "mediaType": "image",
  "model": "gpt-image-2-official",
  "prompt": "Replace the background with a white studio backdrop",
  "scene": "image-to-image",
  "options": {
    "image_urls": [
      "https://your-server.com/reference.png"
    ],
    "aspectRatio": "16:9",
    "resolution": "2K",
    "quality": "medium"
  }
}

Response Example

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "3f2a1b4c-...",
    "status": "queuing",
    "costCredits": 2
  }
}

Limits and account requirements

API calls require a paid account; captchaToken is not required and CAPTCHA cannot replace paid eligibility. Unpaid accounts receive paid account required for API access. Webhook callbacks are currently unsupported; callbackUrl has no effect. Poll query instead. Keep reference images within 20MB each and provide accessible original URLs. Replace the example reference URL with a real image.

Request Parameters

Example (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"] } }

Task Status