Nano Banana | BeatAPI API Documentation

curl -X POST https://api.beatapi.io/v1/images/tasks \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "model": "nano-banana",
  "prompt": "Editorial product photograph on a warm stone pedestal.",
  "aspect_ratio": "1:1",
  "output_format": "png"
}'

{
  "data": {
    "capability_id": "nano-banana",
    "capability_version": null,
    "completed_at": null,
    "created_at": 1782210000,
    "error_code": null,
    "error_message": null,
    "id": "task_8K2qA",
    "media_type": "image",
    "model": "nano-banana",
    "object": "task",
    "output": null,
    "request_id": "req_abc123",
    "stage": "queued",
    "status": "queued",
    "task_kind": "image",
    "updated_at": 1782210000,
    "usage": {
      "credits_charged": 0.03,
      "credits_refunded": 0,
      "credits_reserved": 0.03,
      "credits_settled": 0
    }
  }
}

Generate or edit one image from text and up to three public HTTPS reference images, with configurable aspect ratio and output format.

Supported modes

Mode	Required input	Rules
Text to image	`model`, `prompt`	Omit `images`; BeatAPI selects the text-generation route internally.
Reference image	`model`, `prompt`, `images`	Provide 1–3 public HTTPS PNG, JPEG or WebP image URLs; BeatAPI selects the compatible editing route internally.

Async flow: Create the task, save data.id, then poll the Task with GET /v1/tasks/{task_id}. On succeeded, read data.output.media. On failed, read data.error_code and data.error_message, then follow the error and retry policy.

Using a local file? upload a local input first and pass the returned data.url.

認証

AuthorizationBearer

Send your API key as Authorization: Bearer <BEATAPI_API_KEY>.

リクエスト

This endpoint expects an object.

model"nano-banana"必須

Must be nano-banana.

promptstring必須1-5000 characters

Generation or image-editing instructions.

imageslist of stringsオプション

Public HTTPS reference-image URLs in PNG, JPEG or WebP; each link is checked when the task is created, and one that is not such an image (an error page, a GIF, a 404) is refused with 400. Omit for text-to-image.

aspect_ratioenumオプションデフォルト値 1:1

Output image aspect ratio.

resolutionenumオプションデフォルト値 1K

Output resolution tier. This model renders 1K only.

許可された値:

output_formatenumオプションデフォルト値 png

Output image file format.

許可された値:

レスポンス

Image generation task accepted

エラー

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error

Supported modes

認証

ヘッダー

リクエスト

レスポンス

エラー