Wan 3.0
alibaba/wan-3.0/image-to-video- Alibaba
- 图生视频
让一张参考图片动起来，并用文字描述控制画面生成视频。
API
https://open.scenepond.ai/v1每次请求使用 Authorization: Bearer 和 Scenepond API Key 认证；密钥保存在服务器。
复制此模型的完整接口文档，包含全部已公布协议，供 AI 助手读取。
/v1/tasks请求参数
| 参数 | 必填 | 类型 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
model | 必填 | string | 使用此处显示的完整公开模型 ID。 约束
| ||||||||||||||||||||||||||||||||||||||||||||
parameters | 必填 | object | 此模型的生成参数。 | ||||||||||||||||||||||||||||||||||||||||||||
仅在提供 parameters 时适用；子字段必填不代表可选的父字段也必填。
| |||||||||||||||||||||||||||||||||||||||||||||||
调用注意事项
- 图片和视频使用同一套任务接口。选择模型后，系统自动选择渠道。
- 每次请求使用 Authorization: Bearer 和 Scenepond API Key 认证；密钥保存在服务器。
- 提交一次并保存 task_id，轮询至 succeeded 或 failed，再通过结果接口下载。
- 请求受理后返回任务 ID；部分任务可能在返回 ID 时已完成。
- 提交受理后返回 HTTP 202，Location 为 /v1/tasks/{task_id}。
- 生成产物保存 14 天。请在 expires_at 前下载；过期后无法恢复。
- POST 超时后请勿自动重提，任务可能已创建并产生费用。
- 参数和限制因模型而异，只接受此模型列出的字段。
- 生成的图片和视频只保存 14 天，请在到期前下载并保存到本地。
- 已存储的结果包含 expires_at，表示该文件到期时间的 Unix 时间戳（秒）。请逐个文件使用此字段，不要按任务创建时间推算。
- 部分历史结果可能没有 expires_at，这不代表永久保存，请尽快下载。
- 到期后，使用 API Key 鉴权且不带 access 查询参数的内容请求返回 HTTP 410，错误码为 artifact_expired。私有访问链接在内容不可用时可能返回 404。过期文件无法继续下载或恢复。
- 请勿公开 content_url。保存链接不等于保存文件，请在 expires_at 到期前将文件内容下载到自己的存储。
最小调用
1curl --fail-with-body -X POST "https://open.scenepond.ai/v1/tasks" \
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 "parameters": {
8 "image_urls": [
9 "https://example.com/reference.png"
10 ]
11 }
12}
13JSON在已安装 cURL 的终端中执行此示例，执行前先设置 SCENEPOND_API_KEY。
响应示例
响应示例仅展示结构；ID、URL 和数值为占位内容。
提交响应
1{
2 "task_id": "task_EXAMPLE",
3 "model": "alibaba/wan-3.0/image-to-video",
4 "status": "queued",
5 "progress": 0,
6 "created_at": 1700000000,
7 "finished_at": 0,
8 "error": null,
9 "links": {
10 "self": "/v1/tasks/task_EXAMPLE",
11 "artifacts": "/v1/tasks/task_EXAMPLE/artifacts"
12 }
13}已完成任务的状态
1{
2 "task_id": "task_EXAMPLE",
3 "model": "alibaba/wan-3.0/image-to-video",
4 "status": "succeeded",
5 "progress": 100,
6 "created_at": 1700000000,
7 "finished_at": 1700000060,
8 "error": null,
9 "links": {
10 "self": "/v1/tasks/task_EXAMPLE",
11 "artifacts": "/v1/tasks/task_EXAMPLE/artifacts"
12 }
13}生成文件列表
1{
2 "task_id": "task_EXAMPLE",
3 "artifacts": [
4 {
5 "key": "video",
6 "type": "video",
7 "mime_type": "video/mp4",
8 "content_url": "https://open.scenepond.ai/v1/tasks/task_EXAMPLE/artifacts/video/content",
9 "expires_at": 1701209660
10 }
11 ]
12}结果过期响应（API Key 鉴权）
1{
2 "error": {
3 "message": "Artifact content has expired or is no longer available",
4 "type": "artifact_expired",
5 "code": "artifact_expired"
6 }
7}后续请求
2. 查询任务状态
每隔几秒查询一次，直到 succeeded 或 failed。
1curl --fail-with-body -X GET "https://open.scenepond.ai/v1/tasks/$SCENEPOND_TASK_ID" \
2 -H "Authorization: Bearer $SCENEPOND_API_KEY"在已安装 cURL 的终端中执行此示例，执行前先设置 SCENEPOND_API_KEY。
3. 获取生成结果
任务 succeeded 后列出产物，并使用同一个 API Key 下载各个 content_url。
1curl --fail-with-body -X GET "https://open.scenepond.ai/v1/tasks/$SCENEPOND_TASK_ID/artifacts" \
2 -H "Authorization: Bearer $SCENEPOND_API_KEY"在已安装 cURL 的终端中执行此示例，执行前先设置 SCENEPOND_API_KEY。
4. 到期前下载
将 SCENEPOND_TASK_ID 设为 task_id，将 SCENEPOND_ARTIFACT_KEY 设为 artifacts[].key。请在 expires_at 到期前下载二进制文件。内容接口支持 GET、HEAD 和 Range 请求；仅保存 content_url 无法保留媒体文件。
1curl --fail-with-body --output output.bin -X GET "https://open.scenepond.ai/v1/tasks/$SCENEPOND_TASK_ID/artifacts/$SCENEPOND_ARTIFACT_KEY/content" \
2 -H "Authorization: Bearer $SCENEPOND_API_KEY"在已安装 cURL 的终端中执行此示例，执行前先设置 SCENEPOND_API_KEY。
错误码
| 状态 | 处理方式 |
|---|---|
400 | 检查模型 ID、必填字段、数据类型和参数允许值。 |
401 | 检查 API Key 是否正确且已启用。 |
403 | 检查密钥限制和模型权限。 |
410 | artifact_expired：媒体已过期或不可用。请使用之前下载的副本；重试无法恢复过期文件。 |
429 | 遵循返回的重试间隔，并降低请求频率。 |
5xx | 检查错误响应，避免盲目重试付费生成请求。 |
生成产物保存 14 天。请在 expires_at 前下载；过期后无法恢复。
失败任务可能仅返回 generation_failed，未提供具体原因。请检查错误和用量记录后再提交。