Image Upscaler API Reference | Nano Banana Pro API

Upscaler

Skaliert ein Bild auf 1K, 2K oder 4K und behält Bildaufbau, Farben und Seitenverhältnis bei

Endpoint: POST /api/v1/images/generate
model: upscaler
Output: Image
Credits: from 3

Aufgabe senden

POST/api/v1/images/generate

Parameter

modelstringErforderlich
Must be "upscaler"
typestringOptional
"upscale"
image_urlsstring[]Erforderlich
Public URL of the image to upscale (first item is used)
resolutionstringOptionalStandard 2k
"1k", "2k" (default) or "4k" output
1k2k4k
scalenumberOptional
Deprecated. Used only when resolution is omitted: 3 or 4 means "4k", otherwise "2k"

Anfrage

curl -X POST https://www.bananapro.site/api/v1/images/generate \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "upscaler",
    "type": "upscale",
    "image_urls": ["https://cdn.gempix2.site/gempix2/img/tasks/gptimage25-g25-89eb5727b74db3d74b84ab07045757123470ab2b6bc0ae72-0.webp"],
    "resolution": "2k"
  }'

Antwort200

JSON

{
  "success": true,
  "data": {
    "task_id": "task_up123",
    "credits_used": 4,
    "remaining_credits": 496
  }
}

Die credits_used-Werte in diesen Beispielen dienen nur zur Veranschaulichung. Der tatsächliche Verbrauch wird beim Senden berechnet und von der API zurückgegeben.

Aufgabe abfragen

GET/api/v1/images/{task_id}

status

pending: Accepted and waiting to start. Keep polling.
processing: Running. Keep polling.
completed: Finished. Read image_url; output holds the full result.
failed: Ended without a result. error_message says why and credits_refunded shows what was returned.

Poll every 5 to 10 seconds and stop at completed or failed, or register a webhook to be notified instead. Failed tasks are refunded automatically.

Anfrage

curl https://www.bananapro.site/api/v1/images/task_abc123 \
  -H "Authorization: Bearer sk-your-api-key"

Antwort200

JSON

{
  "success": true,
  "data": {
    "task_id": "task_abc123",
    "model": "upscaler",
    "status": "completed",
    "output": { "images": [{ "url": "https://..." }] },
    "primary_url": "https://...",
    "image_url": "https://...",
    "error_message": null,
    "credits_used": 4,
    "credits_refunded": 0,
    "created_at": "2026-10-04T10:00:00.000Z",
    "updated_at": "2026-10-04T10:01:12.000Z",
    "completed_at": "2026-10-04T10:01:12.000Z"
  },
  "request_id": "req_abc123"
}

Auf das Ergebnis warten

TASK_ID=task_abc123
while true; do
  TASK=$(curl -s https://www.bananapro.site/api/v1/images/$TASK_ID \
    -H "Authorization: Bearer sk-your-api-key")
  STATUS=$(echo "$TASK" | jq -r '.data.status')
  if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then
    echo "$TASK" | jq
    break
  fi
  sleep 10
done

Preise

Resolution	Credits
1k	3
2k	4
4k	6

Funktionen

Ausgabe in 1K, 2K und 4K
Behält Bildaufbau, Farben und Seitenverhältnis des Originals bei
Gleiche Engine und Preise wie der Upscaler auf der Website
Fehlgeschlagene Aufgaben werden automatisch erstattet

curl -X POST https://www.bananapro.site/api/v1/images/generate \ -H "Authorization: Bearer sk-your-api-key" \ -H "Content-Type: application/json" \ -d '{ "model": "upscaler", "type": "upscale", "image_urls": ["https://cdn.gempix2.site/gempix2/img/tasks/gptimage25-g25-89eb5727b74db3d74b84ab07045757123470ab2b6bc0ae72-0.webp"], "resolution": "2k" }'

{ "success": true, "data": { "task_id": "task_abc123", "model": "upscaler", "status": "completed", "output": { "images": [{ "url": "https://..." }] }, "primary_url": "https://...", "image_url": "https://...", "error_message": null, "credits_used": 4, "credits_refunded": 0, "created_at": "2026-10-04T10:00:00.000Z", "updated_at": "2026-10-04T10:01:12.000Z", "completed_at": "2026-10-04T10:01:12.000Z" }, "request_id": "req_abc123" }

TASK_ID=task_abc123 while true; do TASK=$(curl -s https://www.bananapro.site/api/v1/images/$TASK_ID \ -H "Authorization: Bearer sk-your-api-key") STATUS=$(echo "$TASK" | jq -r '.data.status') if [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; then echo "$TASK" | jq break fi sleep 10 done

Resolution

Credits