Nano Banana logoNano Banana
API 介绍快速开始

API

Wan 3.0 Prime API

视频

Wan 3.0 Prime API 支持通过文字、首尾帧或多模态参考资源生成 2–30 秒视频，提供 480p / 720p / 1080p 输出。参考模式最多支持 10 张图片、5 个视频和 5 个音频文件，每张图片不得超过 30MB。

身份验证

Bearerstringheader必填

用于授权请求的 API Key

Body

application/json
modelstring必填
wan-3-0-prime
input.promptstring必填

描述主体、动作、场景、光线、镜头运动与时间安排。首尾空白会自动去除。

input.frames_imagesstring[]可选

1 或 2 个可公开访问的 HTTPS 图片 URL 列表，依次为首帧和可选的尾帧。首尾帧是独立的生成模式，不能与 reference_images、reference_videos 或 reference_audios 同时传入。

最多可传 2 个 URL。

每张图片大小不得超过 30MB。

示例: ["https://example.com/first-frame.png","https://example.com/last-frame.png"]

input.reference_imagesstring[]可选

可公开访问的 HTTPS 参考图片 URL 列表。可与 reference_videos、reference_audios 组合使用，但不能与 frames_images 同时传入。请传 URL 字符串，不要传文件对象或 base64。

最多可传 10 个 URL。

每张图片大小不得超过 30MB。

示例: ["https://example.com/your-image.png"]

input.reference_videosstring[]可选

可公开访问的 HTTPS 参考视频 URL 列表，不能与 frames_images 同时传入。传入参考视频后积分消耗会变化，请查看下方的参考视频计费行与公式。

最多可传 5 个 URL。

示例: ["https://example.com/your-video.mp4"]

input.reference_audiosstring[]可选

可公开访问的 HTTPS 参考音频 URL 列表。可与其他 reference_* 资源组合使用，但不能与 frames_images 同时传入。

最多可传 5 个 URL。

示例: ["https://example.com/your-audio.mp3"]

input.reference_video_durationnumber可选

所传全部参考视频的总时长，单位为秒。传入 reference_videos 时必填。计费时将总时长向上取整，额外计费时长最多为 15 秒。不传参考视频时请省略。

input.durationinteger可选

视频时长，取 2–30 之间的整数秒，默认 5 秒。积分消耗随时长变化。

默认值: 5

2–30
input.resolutionstring可选

视频输出分辨率，请使用下方列出的小写值。不同分辨率对应不同积分费率。

默认值: 720p

480p720p1080p
input.aspect_ratiostring可选

输出画面的宽高比，默认 16:9。使用帧图片时，画面构图也会受参考帧影响。

默认值: 16:9

16:99:161:13:44:3
input.soundboolean可选

是否随视频生成音频，默认 false。请传 JSON 布尔值，不要传字符串。

默认值: false

请求示例

请选择一种生成模式：不传任何媒体资源时为文生视频；传 frames_images 时为首尾帧生成；传 reference_images、reference_videos、reference_audios 时为参考资源生成，这三类参考资源可组合使用。frames_images 与任意 reference_* 资源列表互斥，同时传入会返回参数错误。所有资源均为可公开访问的 HTTPS URL 列表，不接受文件对象或 base64。使用前请替换 example.com 示例地址。保存 data.task_id，通过 POST /api/v1/check 轮询至 completed 或 failed。

POST /api/v1/create
curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan-3-0-prime",
  "input": {
    "prompt": "一辆红色复古汽车在日落时沿海岸公路行驶。镜头平稳地跟拍车身侧面，温暖的光线映照在海面上。",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "sound": false
  }
}'
POST /api/v1/create · HTTP 201
{
  "data": {
    "task_id": "task_example",
    "model": "wan-3-0-prime",
    "status": "processing",
    "credits": 900
  }
}

使用返回的任务 ID 轮询此 Endpoint，直到任务完成或失败。建议每 5 秒轮询一次，以获取最新任务状态。

POST /api/v1/check
{
  "task_id": "task_example"
}

响应

POST /api/v1/check 返回的任务状态。以下 ID、URL 和时间戳仅用于示例。

idstring必填

data.id 为任务标识，与查询请求中的 task_id 一致。

statusstring必填
completed 表示生成成功，data.data 包含生成结果；其他状态下 data.data 为 null。
failed_reasonstring可选

仅当 status 为 failed 时返回，用于说明失败原因。completed 和 processing 状态不包含此字段。

已完成 · completed

下载链接位于 data.data.results。

POST /api/v1/check · HTTP 200
{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "wan-3-0-prime",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.mp4"
      ],
      "processing_time": 120
    }
  }
}

其他状态

processing 或 failed 状态下，data.data 为 null。以下以 failed 为例：只有 failed 才包含 failed_reason。processing 时继续轮询，failed 时停止轮询。

POST /api/v1/check · HTTP 200
{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "wan-3-0-prime",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

积分消耗

以下按分辨率及是否传入参考视频，展示每个计费秒消耗的积分。

以下按分辨率及是否传入参考视频，展示每个计费秒消耗的积分。
生成方式480P720P1080P
不传参考视频90180360
传入参考视频90180360

一次请求生成一个视频。省略时长和分辨率时使用上方默认值。传入参考视频可能增加积分消耗，请按对应计费行和公式计算。

不传参考视频：生成时长 × 每秒积分。传入参考视频：(生成时长 + min(15, ceil(reference_video_duration))) × 每秒积分。每秒费率不变，参考视频总时长向上取整后计入额外计费秒数，最多增加 15 秒。

POST /api/v1/create 响应中的 credits 字段为该任务实际扣除的积分。