Image Upscaler API Reference | Nano Banana Pro API

Suréchantillonneur

Agrandit une image en 1K, 2K ou 4K en conservant sa composition, ses couleurs et son format

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

Soumettre une tâche

POST/api/v1/images/generate

Paramètres

modelstringObligatoire
Must be "upscaler"
typestringFacultatif
"upscale"
image_urlsstring[]Obligatoire
Public URL of the image to upscale (first item is used)
resolutionstringFacultatifPar défaut 2k
"1k", "2k" (default) or "4k" output
1k2k4k
scalenumberFacultatif
Deprecated. Used only when resolution is omitted: 3 or 4 means "4k", otherwise "2k"

Requête

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"
  }'

Réponse200

JSON

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

Les valeurs credits_used de ces exemples sont indicatives. La consommation réelle est calculée à l'envoi et renvoyée par l'API.

Consulter la tâche

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.

Requête

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

Réponse200

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"
}

Attendre le résultat

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

Tarification

Resolution	Credits
1k	3
2k	4
4k	6

Fonctionnalités

Sortie en 1K, 2K et 4K
Conserve la composition, les couleurs et le format d'origine
Même moteur et mêmes tarifs que l'agrandisseur du site
Les tâches échouées sont remboursées automatiquement

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