logo
logo
请输入关键词搜索产品或者文档

热门搜索

中国

中国站

创蓝云智

国际站

Innopaas

视频生成-Seedance2.0

更新时间：2026-10-30 17:38:58

视频生成接口

基础信息

通用请求头

{
  "Content-Type": "application/json",
  "Authorization": "Bearer sk-xxx"
}

创建视频生成任务

接口地址: POST https://router.253.com/api/v3/contents/generations/tasks

请求参数说明:

content 数组元素说明:

场景示例1：纯文本生成视频

{
    "model": "doubao-seedance-2.0",
    "content": [
        {
            "type": "text",
            "text": "写实风格，晴朗的蓝天之下，一大片白色的雏菊花田，镜头逐渐拉近，最终定格在一朵雏菊花的特写上，花瓣上有几颗晶莹的露珠"
        }
    ],
    "ratio": "16:9",
    "duration": 5,
    "watermark": false,
    "resolution": "720p",
}

响应示例:

{
    "id": "cgt-20260811201115-xxxxx",
}

场景示例2：图片生成视频（Base64编码）

{
    "model": "doubao-seedance-2.0",
    "content": [
        {
            "type": "text",
            "text": "女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动"
        },
        {
            "type": "image_url",
            "image_url": {
                "url": "data:image/png;base64,aHR0******cG5n"
            }
        }
    ],
    "ratio": "16:9",
    "duration": 5,
    "watermark": false,
    "resolution": "720p",
}

响应示例:

{
    "id": "cgt-20260811201115-xxxxx",
}

场景示例3：文本+多参考图片+参考视频+背景音乐

{
  "model": "doubao-seedance-2.0",
  "content": [
    {
      "type": "text",
      "text": "全程使用视频1的第一视角构图，全程使用音频1作为背景音乐。第一人称视角果茶宣传广告，seedance牌「苹苹安安」苹果果茶限定款；首帧为图片1，你的手摘下一颗带晨露的阿克苏红苹果，轻脆的苹果碰撞声；2-4 秒：快速切镜，你的手将苹果块投入雪克杯，加入冰块与茶底，用力摇晃，冰块碰撞声与摇晃声卡点轻快鼓点，背景音：「鲜切现摇」；4-6 秒：第一人称成品特写，分层果茶倒入透明杯，你的手轻挤奶盖在顶部铺展，在杯身贴上粉红包标，镜头拉近看奶盖与果茶的分层纹理；6-8 秒：第一人称手持举杯，你将图片2中的果茶举到镜头前（模拟递到观众面前的视角），杯身标签清晰可见，背景音「来一口鲜爽」，尾帧定格为图片2。背景声音统一为女生音色。"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"
      },
      "role": "reference_image"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
      },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"
      },
      "role": "reference_video"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
      },
      "role": "reference_audio"
    }
  ],
  "generate_audio": true,
  "ratio": "16:9",
  "duration": 11,
  "watermark": false
}

响应示例:

{
    "id": "cgt-20260811201115-xxxxx",
}

场景示例4：使用素材库中的素材

{
  "model": "doubao-seedance-2.0",
  "content": [
    {
      "type": "text",
      "text": "展示这个素材人物的时尚穿搭短视频，模特展示夏季新款连衣裙，背景为城市街头，镜头从全身逐渐拉近到细节"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "asset://<ASSET_ID>"
      },
      "role": "reference_image"
    }
  ],
  "ratio": "9:16",
  "duration": 5,
  "watermark": false,
  "resolution": "720p"
}

响应示例:

{
    "id": "cgt-20260811201115-xxxxx",
}

查询视频生成任务

接口地址: GET https://router.253.com/api/v3/contents/generations/tasks/{task_id}

路径参数:

请求示例:

curl --location --request GET 'https://router.253.com/api/v3/contents/generations/tasks/task_AU37yBeCAZKiZCL4QYHMAYffFOm2XoD5' \
--header 'Authorization: Bearer sk-xxxxxxx' \
--header 'Content-Type: application/json'

返回示例（任务完成）：

{
  "actual_output_ratio": 39.1,
  "content": {
    "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0/02178660578277300000000000000000000ffffac15f86de6f968.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20260813%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20260813T072535Z&X-Tos-Expires=86400&X-Tos-Signature=dac176664763983b715698cf97b18e33d95c1c9e3ef40ab39ceaaeadb599f657&X-Tos-SignedHeaders=host"
  },
  "cost": {
    "currency": "CNY",
    "input_cost": 0,
    "output_cost": 3.533892,
    "total_cost": 3.533892
  },
  "created_at": 1786605782,
  "draft": false,
  "duration": 4,
  "execution_expires_after": 172800,
  "framespersecond": 24,
  "generate_audio": true,
  "id": "task_AU37yBeCAZKiZCL4QYHMAYffFOm2XoD5",
  "model": "doubao-seedance-2-0-260128",
  "output_format": "mp4",
  "priority": 0,
  "ratio": "16:9",
  "resolution": "720p",
  "seed": 70565,
  "service_tier": "default",
  "status": "succeeded",
  "updated_at": 1786605943,
  "usage": {
    "completion_tokens": 87300,
    "total_tokens": 87300
  }
}

响应示例（任务处理中）:

{
  "cost": {
    "currency": "CNY",
    "input_cost": 0,
    "output_cost": 8.139994399999999,
    "total_cost": 8.139994399999999
  },
  "created_at": 1786627959,
  "draft": false,
  "execution_expires_after": 172800,
  "generate_audio": true,
  "id": "task_Z8GvkKYej3NDoKWzsh84EG3UVC4GJA0C",
  "model": "doubao-seedance-2-0-fast-260128",
  "output_format": "mp4",
  "priority": 0,
  "service_tier": "default",
  "status": "running",
  "updated_at": 1786627959,
  "upstream_task_id": "cgt-20260813213238-9gkf2"
}

状态说明:"status": "running"

素材库管理接口列表

基础信息

通用请求头

{
  "Content-Type": "application/json",
  "Authorization": "Bearer sk-xxx"
}

Asset Group 管理接口

创建素材资产组合（CreateAssetGroup）

接口地址: POST https://router.253.com/seedance/assets/?Action=CreateAssetGroup&Version=2024-01-01

请求参数:

请求示例:

{
  "Name": "test",
  "Description": "test",
  "GroupType": "AIGC",
  "ProjectName": "default"
}

响应示例:

{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "CreateAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "group-2026**********-*****"
  }
}

查询素材资产组合列表（ListAssetGroups）

接口地址: POST https://router.253.com/seedance/assets/?Action=ListAssetGroups&Version=2024-01-01

请求参数:

请求示例:

{
  "Filter": {
    "Name": "test",
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10,
  "SortBy": "CreateTime",
  "SortOrder": "Desc",
  "ProjectName": "default"
}

响应示例:

{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "ListAssetGroups",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "TotalCount": 1,
    "Items": [
      {
        "Id": "group-2026**********-*****",
        "Name": "test",
        "Title": "test",
        "Description": "test",
        "GroupType": "AIGC",
        "ProjectName": "default",
        "CreateTime": "2026-03-28T00:00:00Z",
        "UpdateTime": "2026-03-28T00:00:00Z"
      }
    ],
    "PageNumber": 1,
    "PageSize": 10
  }
}

查询素材资产组合信息（GetAssetGroup）

接口地址: POST https://router.253.com/seedance/assets/?Action=GetAssetGroup&Version=2024-01-01

请求参数:

请求示例:

{
  "Id": "group-2026**********-*****",
  "ProjectName": "default"
}

响应示例:

{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "GetAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "group-2026**********-*****",
    "Name": "test",
    "Description": "test",
    "GroupType": "AIGC",
    "ProjectName": "default",
    "CreateTime": "2026-03-28T00:00:00Z",
    "UpdateTime": "2026-03-28T00:00:00Z"
  }
}

更新素材资产组合信息（UpdateAssetGroup）

接口地址: POST https://router.253.com/seedance/assets/?Action=UpdateAssetGroup&Version=2024-01-01

请求参数:

请求示例:

{
  "Id": "group-2026**********-*****",
  "Name": "new-name",
  "Description": "new-description",
  "ProjectName": "default"
}

响应示例:

{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "UpdateAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "group-2026**********-*****"
  }
}

删除素材资产组 （DeleteAssetGroup）

接口地址: POST https://router.253.com/seedance/assets/?Action=DeleteAssetGroup&Version=2024-01-01

请求参数:

请求示例:

{
  "Id": "group-2026**********-*****",
  "ProjectName": "default"
}

响应示例:

{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "DeleteAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {}
}

Asset 管理接口

CreateAsset：创建素材资产。该接口可用于上传个人素材资产，创建素材资产后可利用返回字段中的素材 Id （需处于 Active 状态）用于 Seedance 2.0 和 Seedance 2.5 模型生成视频。

创建素材资产（CreateAsset）

接口地址: POST https://router.253.com/seedance/assets/?Action=CreateAsset&Version=2024-01-01

请求参数:

请求示例:

{
  "GroupId": "group-20260328123456-abcde",
  "URL": "https://example.com/image.jpg",
  "Name": "产品图片1",
  "AssetType": "Image",
  "ProjectName": "default"
}

响应示例:

{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "CreateAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "Asset-20260328123456-abcde"
  }
}

查询素材资产列表（ListAssets）

接口地址: POST https://router.253.com/seedance/assets/?Action=ListAssets&Version=2024-01-01

请求参数:

请求示例:

{
  "Filter": {
    "GroupIds": [
      "group-2026**********-*****"
    ],
    "GroupType": "AIGC",
    "Statuses": [
      "Active"
    ],
    "Name": "test"
  },
  "PageNumber": 1,
  "PageSize": 10,
  "SortBy": "CreateTime",
  "SortOrder": "Desc",
  "ProjectName": "default"
}

响应示例:

{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "ListAssets",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Items": [
      {
        "Id": "Asset-2026**********-*****",
        "Name": "test",
        "URL": "https://example.com/asset-url",
        "GroupId": "group-2026**********-*****",
        "AssetType": "Image",
        "Status": "Active",
        "Moderation": {
          "Strategy": "Default"
        },
        "Error": {
          "Code": "",
          "Message": ""
        },
        "ProjectName": "default",
        "CreateTime": "2026-03-28T00:00:00Z",
        "UpdateTime": "2026-03-28T00:00:00Z",
        "LastInferenceTime": "2026-07-24T02:08:49Z"
      }
    ],
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 10
  }
}

查询素材资产信息（GetAsset）

接口地址: POST https://router.253.com/seedance/assets/?Action=GetAsset&Version=2024-01-01

请求参数:

请求示例:

{
  "Id": "Asset-2026**********-*****",
  "ProjectName": "default"
}

响应示例:

{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "GetAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "Asset-2026**********-*****",
    "Name": "test",
    "URL": "https://example.com/asset-url",
    "AssetType": "Image",
    "GroupId": "group-2026**********-*****",
    "Status": "Active",
    "Moderation": {
      "Strategy": "Default"
    },
    "Error": {
      "Code": "",
      "Message": ""
    },
    "CreateTime": "2026-03-28T00:00:00Z",
    "UpdateTime": "2026-03-28T00:00:00Z",
    "LastInferenceTime": "2026-07-24T10:08:49+08:00",
    "ProjectName": "default"
  }
}

Error.Code 错误码

Code错误原因
FaceMismatch真人脸一致性校验失败，素材中的人脸与参考/授权人脸不一致。
TranscodingFailed媒体转码或处理失败。
ContentRestricted内容安全审核未通过。
DownloadFailed无法下载客户提供的素材 URL。
TypeMismatch上传素材类型与声明类型不一致，例如声明视频但实际是图片。
FormatUnsupported素材格式不支持。
FormatUndetectable无法识别素材格式，可能文件损坏或格式异常。
AudioTrackRequired要求必须包含音轨，但素材中未检测到音轨。
AudioTrackForbidden要求不能包含音轨，但素材中检测到音轨。
DurationTooShort素材时长低于业务要求。
DurationTooLong素材时长超过业务限制。
WidthTooSmall / HeightTooSmall素材宽度或高度低于要求。
WidthTooLarge / HeightTooLarge素材宽度或高度超过限制。
AspectRatioTooSmall / AspectRatioTooLarge素材宽高比不符合要求。
FileSizeTooLarge素材文件大小超过限制。
PixelCountTooSmall / PixelCountTooLarge素材总像素数不符合要求。
FpsTooLow / FpsTooHigh视频帧率不符合要求。
InputTextSensitiveContentDetected文本内容安全审核未通过。
InputImageSensitiveContentDetected图片内容安全审核未通过。
InputVideoSensitiveContentDetected视频内容安全审核未通过。
InputAudioSensitiveContentDetected音频内容安全审核未通过。
InputTextSensitiveContentDetected.PolicyViolation文本涉及版权/政策限制。
InputImageSensitiveContentDetected.PolicyViolation图片涉及版权/政策限制。
InputVideoSensitiveContentDetected.PolicyViolation视频涉及版权/政策限制。
InputAudioSensitiveContentDetected.PolicyViolation音频涉及版权/政策限制。
ModerationServiceErrorUploadFailed审核服务暂不可用或审核上传失败，建议重新上传。
InternalError素材处理过程中出现内部异常。

更新素材资产信息（UpdateAsset）

接口地址: POST https://router.253.com/seedance/assets/?Action=UpdateAsset&Version=2024-01-01

请求参数:

请求示例:

{
  "Id": "Asset-2026**********-*****",
  "Name": "new-name",
  "ProjectName": "default"
}

响应示例:

{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "UpdateAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "Asset-2026**********-*****"
  }
}

删除素材资产组 （DeleteAssetGroup）

接口地址: POST https://router.253.com/seedance/assets/?Action=DeleteAsset&Version=2024-01-01

请求参数:

请求示例:

{
  "Id": "group-2026**********-*****",
  "ProjectName": "default"
}

响应示例:

{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "DeleteAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {}
}

真人素材

真人人像认证接口

接口地址: POST https://router.253.com/seedance/assets/?Action=CreateVisualValidateSession&Version=2024-01-01

请求参数:

请求示例:

{
    **"CallbackURL"**: **"https://www.example.com/callback"**
}

响应示例:

{
    **"BytedToken"**: **"202603311449168C23BA26**********"**,
    **"H5Link"**: **"https://ark.volcengine.com/region:cn-beijing/mobile/livenees-face-manage/authorization?pl=**********"**,
    **"CallbackURL"**: **"https://www.example.com/callback"**
}

获取真人 Asset Group ID

接口地址: POST https://router.253.com/seedance/assets/?Action=GetVisualValidateResult&Version=2024-01-01

请求参数:

请求示例:

{
  "BytedToken": "202603311449168C23BA26**********",
  "ProjectName": "default"
}

响应示例:

{
  "GroupId": "group-20260331145705-abcde"
}
24小时热线 400-9669-253
云通信推荐
国内短信
国际短信
视频短信
语音消息
短信LOGO认证
API&SDK推荐
一键登录
活体检测SDK
行为验证码
图片OCR
智能短链
生态资源
开发者中心
创蓝社区
积分商城
关于我们
关于我们
加入我们
智慧党建
公司动态
logo

中国总部：上海市松江区广富林东路199号4栋

24小时热线：400-9669-253
微信

创蓝公众号

企业微信

联系商务

上海 | 新加坡 | 北京 | 迪拜 | 深圳 | 雅加达 | 成都 | 胡志明 | 南京 | 墨西哥城 | 香港 | 长沙 | 拉各斯等城市
上海创蓝云智信息科技股份有限公司版权所有Copyright © 2026 ALL RIGHTS RESERVED
增值电信业务经营许可证：B2-20144076沪ICP备15046301号-16创蓝云智沪公网安备 31011702001190号、31011702008034号创蓝云智