Seedance 2.5(全能参考)
任务进度与结果查询见 使用说明。
说明
异步任务接口,用于提交 Seedance 2.5 全能参考视频任务,支持同时使用图片、视频和音频作为参考素材。
请求地址
http
POST /open/v1/ai_creation/task/submitHeader
http
access_token: {{access_token}}
Content-Type: application/json请求参数 Body
json
{
"ref_resources": [
{
"url": "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref.jpg",
"file_type": "image"
},
{
"url": "https://res.chanjing.cc/chanjing/res/aigc_creation/video/ref.mp4",
"file_type": "video"
},
{
"url": "https://res.chanjing.cc/chanjing/res/aigc_creation/audio/ref.mp3",
"file_type": "audio"
}
],
"ref_prompt": "保持参考素材中的主体特征、运动节奏和声音风格,生成电影感品牌短片",
"creation_type": 4,
"aspect_ratio": "auto",
"clarity": 720,
"video_duration": 5,
"number_of_images": 1,
"model_code": "seedance-2.5-r2v"
}参数说明
| 字段 | 类型 | 是否必传 | 示例 | 说明 |
|---|---|---|---|---|
| ref_resources | array<object> | 条件必传 | [{"url":"https://.../ref.mp4","file_type":"video"}] | 参考素材列表;与 ref_img_url 至少传一种,合计至少 1 个、最多 50 个 |
| ref_resources.url | string | 是 | https://.../ref.mp4 | 可公开访问的参考素材 URL |
| ref_resources.file_type | string | 是 | video | 参考素材类型,支持 image、video、audio |
| ref_img_url | array<string> | 否 | ["https://.../ref.jpg"] | 兼容旧版参考图字段;仅传图片时可替代 ref_resources |
| ref_prompt | string | 是 | 保持参考素材中的主体特征和运动节奏 | 视频生成提示词 |
| creation_type | int | 是 | 4 | 创作类型,固定为 4 |
| aspect_ratio | string | 是 | auto | 输出视频宽高比,支持 auto、16:9、4:3、1:1、3:4、9:16、21:9 |
| clarity | int | 是 | 720 | 输出清晰度,支持 480、720、1080 |
| video_duration | int | 是 | 5 | 输出视频时长(秒),支持 3-30 的整数 |
| number_of_images | int | 是 | 1 | 生成数量,固定为 1 |
| model_code | string | 是 | seedance-2.5-r2v | 模型编码,固定为 seedance-2.5-r2v |
参考素材限制:
| 素材类型 | 数量上限 | 时长限制 |
|---|---|---|
| 图片 | 30 张 | - |
| 视频 | 10 个 | 所有输入视频累计不超过 30 秒 |
| 音频 | 10 个 | 所有输入音频累计不超过 30 秒 |
视频和音频的累计时长分别计算。相同 URL 会合并去重,不重复计数。
响应示例
json
{
"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 | 系统内部错误 |
示例代码
shell
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 '{
"ref_resources": [
{"url": "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref.jpg", "file_type": "image"},
{"url": "https://res.chanjing.cc/chanjing/res/aigc_creation/video/ref.mp4", "file_type": "video"},
{"url": "https://res.chanjing.cc/chanjing/res/aigc_creation/audio/ref.mp3", "file_type": "audio"}
],
"ref_prompt": "保持参考素材中的主体特征、运动节奏和声音风格,生成电影感品牌短片",
"creation_type": 4,
"aspect_ratio": "auto",
"clarity": 720,
"video_duration": 5,
"number_of_images": 1,
"model_code": "seedance-2.5-r2v"
}'go
payload := strings.NewReader(`{
"ref_resources": [
{"url":"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref.jpg","file_type":"image"},
{"url":"https://res.chanjing.cc/chanjing/res/aigc_creation/video/ref.mp4","file_type":"video"},
{"url":"https://res.chanjing.cc/chanjing/res/aigc_creation/audio/ref.mp3","file_type":"audio"}
],
"ref_prompt": "保持参考素材中的主体特征、运动节奏和声音风格,生成电影感品牌短片",
"creation_type": 4,
"aspect_ratio": "auto",
"clarity": 720,
"video_duration": 5,
"number_of_images": 1,
"model_code": "seedance-2.5-r2v"
}`)java
RequestBody body = RequestBody.create(mediaType, "{\n \"ref_resources\": [{\"url\":\"https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref.jpg\",\"file_type\":\"image\"},{\"url\":\"https://res.chanjing.cc/chanjing/res/aigc_creation/video/ref.mp4\",\"file_type\":\"video\"},{\"url\":\"https://res.chanjing.cc/chanjing/res/aigc_creation/audio/ref.mp3\",\"file_type\":\"audio\"}],\n \"ref_prompt\": \"保持参考素材中的主体特征、运动节奏和声音风格,生成电影感品牌短片\",\n \"creation_type\": 4,\n \"aspect_ratio\": \"auto\",\n \"clarity\": 720,\n \"video_duration\": 5,\n \"number_of_images\": 1,\n \"model_code\": \"seedance-2.5-r2v\"\n}");py
payload = json.dumps({
"ref_resources": [
{"url": "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/ref.jpg", "file_type": "image"},
{"url": "https://res.chanjing.cc/chanjing/res/aigc_creation/video/ref.mp4", "file_type": "video"},
{"url": "https://res.chanjing.cc/chanjing/res/aigc_creation/audio/ref.mp3", "file_type": "audio"}
],
"ref_prompt": "保持参考素材中的主体特征、运动节奏和声音风格,生成电影感品牌短片",
"creation_type": 4,
"aspect_ratio": "auto",
"clarity": 720,
"video_duration": 5,
"number_of_images": 1,
"model_code": "seedance-2.5-r2v"
})