Image Upscaler API Reference | Nano Banana Pro API

업스케일러

이미지를 1K, 2K 또는 4K로 업스케일하며 원본 구도, 색감, 화면비를 유지합니다

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

작업 제출

POST/api/v1/images/generate

매개변수

modelstring필수
Must be "upscaler"
typestring선택 사항
"upscale"
image_urlsstring[]필수
Public URL of the image to upscale (first item is used)
resolutionstring선택 사항기본값 2k
"1k", "2k" (default) or "4k" output
1k2k4k
scalenumber선택 사항
Deprecated. Used only when resolution is omitted: 3 or 4 means "4k", otherwise "2k"

요청

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

응답200

JSON

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

예시의 credits_used 값은 참고용입니다. 실제 사용량은 제출 시 계산되어 API가 반환합니다.

작업 조회

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.

요청

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

응답200

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

결과 기다리기

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
1k	3
2k	4
4k	6

기능

1K, 2K, 4K 출력
원본 구도, 색감, 화면비 유지
사이트 업스케일러와 동일한 엔진 및 가격
실패한 작업은 크레딧 자동 환불

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