Wan 3.0

模型 IDalibaba/wan-3.0/image-to-video

Wan (Alibaba)
图生视频
视频

让一张参考图片动起来，并用文字描述控制画面生成视频。

调用这个模型 API 快速开始

概览

模型开发者: Wan (Alibaba)
API 渠道: fal.ai
分辨率: 480p · 720p · 1080p
时长: 2–30 秒
画幅比例: 6 种画幅比例
支持的协议: fal-task
openai-response
openai-video

调用这个模型

创建 API Key、充值账户余额，并在调用前确认密钥有权访问这个模型。

LLM 索引

复制此模型的完整接口文档，包含全部已公布协议，供 AI 助手读取。

API 协议

POST/v1/tasks/fal

请求参数

请求参数
参数	必填	类型	说明
`model`	必填	`string`	使用此处显示的完整公开模型 ID。约束 const = "alibaba/wan-3.0/image-to-video"
`audio`	可选	`boolean`	是否请求生成音频。默认 `true`
`prompt`	可选	`string`	描述主体、场景和期望生成的内容。约束 maxLength = 20000
`resolution`	可选	`string`	输出分辨率。允许值取决于此模型，并区分大小写。默认 `"1080p"` 约束 enum = ["480p","720p","1080p"]
`enable_thinking`	可选	`boolean`	上游是否在准备生成时启用思考选项。默认 `false`
`end_image_url`	可选	`string`	可选尾帧图片；同时需要提供起始参考图片。
`aspect_ratio`	可选	`string`	期望的输出宽高比。默认 `"adaptive"` 约束 enum = ["adaptive","16:9","4:3","1:1","3:4","9:16"]
`enable_prompt_expansion`	可选	`boolean`	是否在生成前扩展提示词。默认 `true`
`enable_safety_checker`	可选	`boolean`	是否启用上游安全检查；上游政策可能禁止关闭此选项。默认 `true`
`duration`	可选	`integer`	请求的视频时长，单位为秒。默认 `5` 约束 minimum = 2 maximum = 30
`seed`	可选	`integer`	用于控制生成随机性的整数种子。约束 minimum = 0 maximum = 2147483647
`start_image_url`	条件必填	`string`	首帧图片；提供可访问的 HTTP(S) 地址或 base64 图片 data URL。未通过 images、image 或 input_reference 提供参考图片时必填。
`seconds`	可选	`integer`	视频时长，单位为秒；此字段是 duration 的别名。默认 `5` 约束 minimum = 2 maximum = 30
`size`	可选	`string`	image_size 或 resolution 的别名。建议使用本表准确的原生值；像素尺寸别名可能不匹配区分大小写的分辨率值。
`parameters`	可选	`object`	本表原生参数的另一种容器写法；同一设置不可重复填写不同值。
`metadata`	可选	`object`	另一种容器写法：将原生参数放在 metadata.parameters 内。
`images`	可选	`array<string>`	可代替原生参考图片字段。第一项作为起始图片；仅在模型支持尾帧时才能提供第二项。约束 maxItems = 2
`image`	可选	`string \| array<string>`	参考图片的另一种别名写法，不可与原生图片字段或 input_reference 同时使用。
`input_reference`	可选	`string \| array<string>`	参考图片的另一种别名写法，不可与原生图片字段或 image 同时使用。

调用注意事项

每次请求使用 Authorization: Bearer 和 Scenepond API Key 认证；密钥保存在服务器。
参数值区分大小写。未填写或为 null 时，存在默认值的设置使用默认值；有效的 0 和 false 会被保留。
参数表使用 JSON 顶层的原生字段名，也可放入 parameters 或 metadata.parameters。未知的嵌套字段和重复参数中的冲突值会被拒绝。
提交后返回排队任务。先轮询状态，再在 SUCCESS 后查询生成文件列表。
POST 超时后不要自动重新提交。保存已返回的任务 ID，先检查状态，再决定是否创建新的付费任务。
默认值和限制依据当前网关与关联的上游参数规范；上游或网关更新后可能变化。
将 example.com 替换为自己可访问的参考图片地址。原生图片字段与 images/input_reference 别名选一种写法，不能重复提供。
提供尾帧时必须同时提供起始参考图片，不能只提交尾帧。
此图生视频模型可以只提供参考图片，提示词为可选项。

最小调用

1curl --fail-with-body -X POST "https://scenepond-api-production.up.railway.app/v1/tasks/fal" \
2  -H "Authorization: Bearer $SCENEPOND_API_KEY" \
3  -H "Content-Type: application/json" \
4  --data-binary @- <<'JSON'
5{
6  "model": "alibaba/wan-3.0/image-to-video",
7  "start_image_url": "https://example.com/reference.png"
8}
9JSON

在已安装 cURL 的终端中执行此示例，执行前先设置 SCENEPOND_API_KEY。

响应示例

响应示例仅展示结构；ID、URL 和数值为占位内容。

提交响应

1{
2  "id": "task_EXAMPLE",
3  "task_id": "task_EXAMPLE",
4  "status": "queued",
5  "model": "alibaba/wan-3.0/image-to-video",
6  "created_at": 1700000000
7}

已完成任务的状态

1{
2  "task_id": "task_EXAMPLE",
3  "platform": "fal",
4  "status": "SUCCESS",
5  "progress": "100%",
6  "fail_reason": "",
7  "created_at": 1700000000,
8  "finished_at": 1700000060
9}

生成文件列表

1{
2  "task_id": "task_EXAMPLE",
3  "artifacts": [
4    {
5      "key": "video",
6      "type": "video",
7      "content_url": "https://scenepond-api-production.up.railway.app/v1/tasks/task_EXAMPLE/artifacts/video/content"
8    }
9  ]
10}

后续请求

2. 查询任务状态

将 SCENEPOND_TASK_ID 设为返回的 task_id，每隔几秒查询，直到 SUCCESS 或 FAILURE。状态中包含进度和 fail_reason，但不包含生成文件。

1curl --fail-with-body -X GET "https://scenepond-api-production.up.railway.app/v1/tasks/$SCENEPOND_TASK_ID" \
2  -H "Authorization: Bearer $SCENEPOND_API_KEY"

在已安装 cURL 的终端中执行此示例，执行前先设置 SCENEPOND_API_KEY。

3. 获取生成结果

SUCCESS 后查询生成文件列表，使用返回的 content_url 和认证信息下载。请妥善保管带签名的地址。

1curl --fail-with-body -X GET "https://scenepond-api-production.up.railway.app/v1/tasks/$SCENEPOND_TASK_ID/artifacts" \
2  -H "Authorization: Bearer $SCENEPOND_API_KEY"

在已安装 cURL 的终端中执行此示例，执行前先设置 SCENEPOND_API_KEY。

接入你的应用

在应用中通过任务 API 提交生成请求，并按任务 ID 获取结果。

API 文档

模型访问权限和请求限制取决于账户、API Key 与服务配置。

价格

视频生成单价USD 0.05 – 0.2 / 秒价格因规格而异 · 3 档

各规格单价

输出分辨率: 480p

视频生成单价

USD 0.05 / 秒

输出分辨率: 720p

视频生成单价

USD 0.1 / 秒

输出分辨率: 1080p

视频生成单价

USD 0.2 / 秒

适用条件	视频生成单价
输出分辨率: 480p	USD 0.05 / 秒
输出分辨率: 720p	USD 0.1 / 秒
输出分辨率: 1080p	USD 0.2 / 秒

获取 API Key 充值余额

价格取决于模型配置。用量记录显示已记录的扣费；异步任务完成后可能调整费用。

调用这个模型

创建 API Key、充值账户余额，并在调用前确认密钥有权访问这个模型。

LLM 索引

复制此模型的完整接口文档，包含全部已公布协议，供 AI 助手读取。

API 协议

POST/v1/tasks/fal

请求参数

请求参数
参数	必填	类型	说明
`model`	必填	`string`	使用此处显示的完整公开模型 ID。约束 const = "alibaba/wan-3.0/image-to-video"
`audio`	可选	`boolean`	是否请求生成音频。默认 `true`
`prompt`	可选	`string`	描述主体、场景和期望生成的内容。约束 maxLength = 20000
`resolution`	可选	`string`	输出分辨率。允许值取决于此模型，并区分大小写。默认 `"1080p"` 约束 enum = ["480p","720p","1080p"]
`enable_thinking`	可选	`boolean`	上游是否在准备生成时启用思考选项。默认 `false`
`end_image_url`	可选	`string`	可选尾帧图片；同时需要提供起始参考图片。
`aspect_ratio`	可选	`string`	期望的输出宽高比。默认 `"adaptive"` 约束 enum = ["adaptive","16:9","4:3","1:1","3:4","9:16"]
`enable_prompt_expansion`	可选	`boolean`	是否在生成前扩展提示词。默认 `true`
`enable_safety_checker`	可选	`boolean`	是否启用上游安全检查；上游政策可能禁止关闭此选项。默认 `true`
`duration`	可选	`integer`	请求的视频时长，单位为秒。默认 `5` 约束 minimum = 2 maximum = 30
`seed`	可选	`integer`	用于控制生成随机性的整数种子。约束 minimum = 0 maximum = 2147483647
`start_image_url`	条件必填	`string`	首帧图片；提供可访问的 HTTP(S) 地址或 base64 图片 data URL。未通过 images、image 或 input_reference 提供参考图片时必填。
`seconds`	可选	`integer`	视频时长，单位为秒；此字段是 duration 的别名。默认 `5` 约束 minimum = 2 maximum = 30
`size`	可选	`string`	image_size 或 resolution 的别名。建议使用本表准确的原生值；像素尺寸别名可能不匹配区分大小写的分辨率值。
`parameters`	可选	`object`	本表原生参数的另一种容器写法；同一设置不可重复填写不同值。
`metadata`	可选	`object`	另一种容器写法：将原生参数放在 metadata.parameters 内。
`images`	可选	`array<string>`	可代替原生参考图片字段。第一项作为起始图片；仅在模型支持尾帧时才能提供第二项。约束 maxItems = 2
`image`	可选	`string \| array<string>`	参考图片的另一种别名写法，不可与原生图片字段或 input_reference 同时使用。
`input_reference`	可选	`string \| array<string>`	参考图片的另一种别名写法，不可与原生图片字段或 image 同时使用。

调用注意事项

每次请求使用 Authorization: Bearer 和 Scenepond API Key 认证；密钥保存在服务器。
参数值区分大小写。未填写或为 null 时，存在默认值的设置使用默认值；有效的 0 和 false 会被保留。
参数表使用 JSON 顶层的原生字段名，也可放入 parameters 或 metadata.parameters。未知的嵌套字段和重复参数中的冲突值会被拒绝。
提交后返回排队任务。先轮询状态，再在 SUCCESS 后查询生成文件列表。
POST 超时后不要自动重新提交。保存已返回的任务 ID，先检查状态，再决定是否创建新的付费任务。
默认值和限制依据当前网关与关联的上游参数规范；上游或网关更新后可能变化。
将 example.com 替换为自己可访问的参考图片地址。原生图片字段与 images/input_reference 别名选一种写法，不能重复提供。
提供尾帧时必须同时提供起始参考图片，不能只提交尾帧。
此图生视频模型可以只提供参考图片，提示词为可选项。

最小调用

1curl --fail-with-body -X POST "https://scenepond-api-production.up.railway.app/v1/tasks/fal" \
2  -H "Authorization: Bearer $SCENEPOND_API_KEY" \
3  -H "Content-Type: application/json" \
4  --data-binary @- <<'JSON'
5{
6  "model": "alibaba/wan-3.0/image-to-video",
7  "start_image_url": "https://example.com/reference.png"
8}
9JSON

在已安装 cURL 的终端中执行此示例，执行前先设置 SCENEPOND_API_KEY。

响应示例

响应示例仅展示结构；ID、URL 和数值为占位内容。

提交响应

1{
2  "id": "task_EXAMPLE",
3  "task_id": "task_EXAMPLE",
4  "status": "queued",
5  "model": "alibaba/wan-3.0/image-to-video",
6  "created_at": 1700000000
7}

已完成任务的状态

1{
2  "task_id": "task_EXAMPLE",
3  "platform": "fal",
4  "status": "SUCCESS",
5  "progress": "100%",
6  "fail_reason": "",
7  "created_at": 1700000000,
8  "finished_at": 1700000060
9}

生成文件列表

1{
2  "task_id": "task_EXAMPLE",
3  "artifacts": [
4    {
5      "key": "video",
6      "type": "video",
7      "content_url": "https://scenepond-api-production.up.railway.app/v1/tasks/task_EXAMPLE/artifacts/video/content"
8    }
9  ]
10}

后续请求

2. 查询任务状态

将 SCENEPOND_TASK_ID 设为返回的 task_id，每隔几秒查询，直到 SUCCESS 或 FAILURE。状态中包含进度和 fail_reason，但不包含生成文件。

1curl --fail-with-body -X GET "https://scenepond-api-production.up.railway.app/v1/tasks/$SCENEPOND_TASK_ID" \
2  -H "Authorization: Bearer $SCENEPOND_API_KEY"

在已安装 cURL 的终端中执行此示例，执行前先设置 SCENEPOND_API_KEY。

3. 获取生成结果

SUCCESS 后查询生成文件列表，使用返回的 content_url 和认证信息下载。请妥善保管带签名的地址。

1curl --fail-with-body -X GET "https://scenepond-api-production.up.railway.app/v1/tasks/$SCENEPOND_TASK_ID/artifacts" \
2  -H "Authorization: Bearer $SCENEPOND_API_KEY"

在已安装 cURL 的终端中执行此示例，执行前先设置 SCENEPOND_API_KEY。