Wan3（首尾帧生视频）

任务进度与结果查询见 使用说明。

说明

异步任务接口，用于提交 Wan3 首尾帧生视频任务。请求需传入首帧图片，可选传入尾帧图片；两张图片按请求中的出现顺序分别作为首帧和尾帧。

请求地址

POST /open/v1/ai_creation/task/submit

Header

access_token: {{access_token}}
Content-Type: application/json

请求参数 Body

{
  "start_frame": "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/start.jpg",
  "end_frame": "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/end.jpg",
  "ref_prompt": "镜头从首帧自然过渡到尾帧，主体动作连贯，光影变化平滑",
  "creation_type": 4,
  "aspect_ratio": "auto",
  "clarity": 720,
  "resolution_mode": "native",
  "video_duration": 5,
  "number_of_images": 1,
  "model_code": "wan3.0-first-last-to-video"
}

参数说明

字段	类型	是否必传	示例	说明
start_frame	string	条件必传	https://.../start.jpg	首帧图片 URL；与 ref_img_url、ref_resources 至少传一种
end_frame	string	否	https://.../end.jpg	尾帧图片 URL；传入后参考图片总数仍不能超过 2 张
ref_img_url	array<string>	条件必传	["https://.../start.jpg", "https://.../end.jpg"]	兼容参考图 URL 列表，可替代 start_frame、end_frame
ref_resources	array<object>	条件必传	[{"url":"https://.../start.jpg","file_type":"image"}]	参考图片列表，可替代 start_frame、end_frame
ref_resources.url	string	是	https://.../start.jpg	可公开访问且能通过服务端校验的参考图片 URL
ref_resources.file_type	string	是	image	该模式固定传 image
ref_prompt	string	是	镜头从首帧自然过渡到尾帧	视频生成提示词，最多 20000 个字符
creation_type	int	是	4	创作类型，固定为 4
aspect_ratio	string	是	auto	输出视频宽高比，支持 auto、16:9、4:3、1:1、3:4、9:16；按参考图片智能匹配请传 auto
clarity	int	是	720	输出清晰度，支持 480、720、1080
resolution_mode	string	否	native	分辨率模式：native 为标准版，fast 为加速版；不传时按 native 处理
video_duration	int	是	5	输出视频时长（秒），支持 2-30 的整数
number_of_images	int	是	1	OpenAPI 单次生成数量，固定为 1
model_code	string	是	wan3.0-first-last-to-video	模型编码，固定为 wan3.0-first-last-to-video

支持的分辨率组合与价格：

输出规格	clarity	resolution_mode	活动价（蝉豆/秒）	原价（蝉豆/秒）	活动价（魔力/秒）	原价（魔力/秒）
480P 标准版	480	native，可省略	7	15	1	2
480P 加速版	480	fast	10	20	2	3
720P 标准版	720	native，可省略	11	20	2	3
720P 加速版	720	fast	23	45	3	6
1080P 标准版	1080	native，可省略	21	40	3	6
1080P 加速版	1080	fast	43	85	6	12

Wan3 当前为限时 5 折活动，实际扣费以表格中的活动价为准，原价保持不变。活动价格以计费配置为准，不根据原价实时换算。

OpenAPI 始终传真实分辨率 480、720 或 1080，并通过 resolution_mode 区分标准版和加速版。48001、72001、108001 是社区端内部选项值，不能作为 OpenAPI 的 clarity。价格按生成时长计费，任务价格为对应单价乘以 video_duration。

start_frame、end_frame、ref_img_url 和 ref_resources 中的图片会按 URL 合并去重，合计必须为 1-2 张。只传一张时作为首帧，传两张时依次作为首帧和尾帧。图片支持 JPEG、PNG、WebP、BMP、TIFF、GIF，单张不超过 30 MB。

响应示例

{
  "trace_id": "96afa792520b0e6a86d72e89435bc0a7",
  "code": 0,
  "msg": "success",
  "data": "a60747d7-dc05-4afc-b2ef-ee4370ed53c6"
}

响应字段说明

字段	说明
code	响应状态码
msg	响应信息
trace_id	请求链路追踪 ID
data	创作任务唯一 ID（unique_id）

响应状态码说明

code	说明
0	响应成功
400	传入参数格式错误
10400	AccessToken 验证失败
40000	参数错误
40001	超出 QPS 限制
50000	系统内部错误

示例代码

cURL

curl --location --request POST 'https://open-api.chanjing.cc/open/v1/ai_creation/task/submit' \
--header 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "start_frame": "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/start.jpg",
  "end_frame": "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/end.jpg",
  "ref_prompt": "镜头从首帧自然过渡到尾帧，主体动作连贯，光影变化平滑",
  "creation_type": 4,
  "aspect_ratio": "auto",
  "clarity": 720,
  "resolution_mode": "native",
  "video_duration": 5,
  "number_of_images": 1,
  "model_code": "wan3.0-first-last-to-video"
}'

Go

payload := strings.NewReader(`{
  "start_frame": "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/start.jpg",
  "end_frame": "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/end.jpg",
  "ref_prompt": "镜头从首帧自然过渡到尾帧，主体动作连贯，光影变化平滑",
  "creation_type": 4,
  "aspect_ratio": "auto",
  "clarity": 720,
  "resolution_mode": "native",
  "video_duration": 5,
  "number_of_images": 1,
  "model_code": "wan3.0-first-last-to-video"
}`)

Java

RequestBody body = RequestBody.create(mediaType, "{\n  \"start_frame\": \"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/start.jpg\",\n  \"end_frame\": \"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/end.jpg\",\n  \"ref_prompt\": \"镜头从首帧自然过渡到尾帧，主体动作连贯，光影变化平滑\",\n  \"creation_type\": 4,\n  \"aspect_ratio\": \"auto\",\n  \"clarity\": 720,\n  \"resolution_mode\": \"native\",\n  \"video_duration\": 5,\n  \"number_of_images\": 1,\n  \"model_code\": \"wan3.0-first-last-to-video\"\n}");

Python

payload = json.dumps({
  "start_frame": "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/start.jpg",
  "end_frame": "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/end.jpg",
  "ref_prompt": "镜头从首帧自然过渡到尾帧，主体动作连贯，光影变化平滑",
  "creation_type": 4,
  "aspect_ratio": "auto",
  "clarity": 720,
  "resolution_mode": "native",
  "video_duration": 5,
  "number_of_images": 1,
  "model_code": "wan3.0-first-last-to-video"
})