Nano Banana 2 Reference to Image

Model ID google/nano-banana-2/reference-to-image

Overview

Generate a still image from one source video clip and optional reference images.

Google · reference-to-image

Endpoint

POST /v1/images/generations/async

Authentication

Authorization: Bearer <AIAPIAIAPI_API_KEY>

Request Body

model

Type: string · Required: Yes · Nullable: No

Model ID used to route the request.

prompt

Type: string · Required: Yes · Nullable: No

Text prompt describing the desired output.

images

Type: array · Required: No · Nullable: No

Source images; optional alongside the source video in reference-to-image mode.

resolution

Type: string · Required: No · Nullable: No

Output image resolution.

aspect_ratio

Type: string · Required: No · Nullable: No

Output image aspect ratio.

seed

Type: integer · Required: No · Nullable: No

Random seed; -1 selects a random seed. Determinism is not guaranteed.

output_format

Type: string · Required: No · Nullable: No

Output file format.

enable_web_search

Type: boolean · Required: No · Nullable: No

Ground generation with web search.

enable_image_search

Type: boolean · Required: No · Nullable: No

Use image search results as visual context.

thinking_level

Type: string · Required: No · Nullable: No

Internal reasoning level; higher levels may improve quality but increase latency.

media_resolution

Type: string · Required: No · Nullable: No

Input media processing detail.

top_p

Type: number · Required: No · Nullable: No

Top-p sampling probability threshold.

temperature

Type: number · Required: No · Nullable: No

Sampling temperature controlling creativity.

video_clips

Type: array · Required: Yes · Nullable: No

Exactly one HTTP or YouTube video. HTTP videos are limited to 15 MB (validated by the provider). start and ends are seconds; ends=0 uses the whole video. fps must be 0–24. All four properties are required.

Request Example

curl --request POST \
  --url https://aiapiaiapi.com/v1/images/generations/async \
  --header 'Authorization: Bearer $AIAPIAIAPI_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
      "model": "google/nano-banana-2/reference-to-image",
      "prompt": "A cinematic camera movement through a forest",
      "resolution": "1k",
      "video_clips": [{"ends":0,"fps":1,"start":0,"url":"https://example.com/reference.mp4"}]
    }'

JSON

{
  "model": "google/nano-banana-2/reference-to-image",
  "prompt": "A cinematic camera movement through a forest",
  "resolution": "1k",
  "video_clips": [{"ends":0,"fps":1,"start":0,"url":"https://example.com/reference.mp4"}]
}

Response

{
  "code": "success",
  "message": "",
  "data": { "task_id": "image_01K2ABC123" }
}

Task Status

Use the task_id from the create response:

GET /v1/images/generations/async/{task_id}

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "image_01K2ABC123",
    "status": "SUCCESS",
    "progress": "100%",
    "outputs": ["https://cdn.example.com/images/image_01K2ABC123.png"],
    "start_time": 1786960805,
    "finish_time": 1786960900,
    "submit_time": 1786960800,
    "fail_reason": ""
  }
}

Error Responses

Validation errors return HTTP 400 with a stable error code.

{
  "code": "unsupported_parameter",
  "message": "The parameter is not supported by this model.",
  "data": null
}