Nano Banana 2 Reference to Image

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

概览

通过一个来源视频片段和可选参考图片生成静态图像。

Google · reference-to-image

接口

POST /v1/images/generations/async

认证

Authorization: Bearer <AIAPIAIAPI_API_KEY>

请求体

model

类型：string · 必填：是 · 可空：否

用于路由请求的模型 ID。

prompt

类型：string · 必填：是 · 可空：否

描述目标生成结果的文本提示词。

images

类型：array · 必填：否 · 可空：否

来源图片；视频参考生图模式下为可选的辅助图片。

resolution

类型：string · 必填：否 · 可空：否

输出图像分辨率。

aspect_ratio

类型：string · 必填：否 · 可空：否

输出图像比例。

seed

类型：integer · 必填：否 · 可空：否

随机种子；-1 表示随机，不保证确定性。

output_format

类型：string · 必填：否 · 可空：否

输出文件格式。

enable_web_search

类型：boolean · 必填：否 · 可空：否

使用联网搜索辅助生成。

enable_image_search

类型：boolean · 必填：否 · 可空：否

使用图片搜索结果提供视觉上下文。

thinking_level

类型：string · 必填：否 · 可空：否

内部推理级别，更高的级别可能提升质量，但会增加延迟。

media_resolution

类型：string · 必填：否 · 可空：否

输入媒体的处理精细度。

top_p

类型：number · 必填：否 · 可空：否

Top-p 采样概率阈值。

temperature

类型：number · 必填：否 · 可空：否

控制生成创造性的采样温度。

video_clips

类型：array · 必填：是 · 可空：否

恰好一个 HTTP 或 YouTube 视频，HTTP 视频最多 15 MB（由供应商校验）。start 和 ends 单位为秒，ends=0 使用完整视频；fps 为 0 至 24，四个属性均必填。

请求示例

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

响应

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

任务状态

使用创建响应中的 task_id 查询：

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

错误响应

参数校验错误返回 HTTP 400，并包含稳定的错误代码。

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