seedance视频生成(豆包系列) 算子介绍 描述 Seedance是字节跳动豆包大模型团队最新推出的视频生成基础模型,可根据用户输入的文本、图片等内容,快速生成优质的视频片段 使用限制 暂只支持文生视频和图生视频 不支持调整帧数 视频生成为异步接口,您需要先创建视频生成任务,再通过视频生成任务的 ID 去查询视频生成结果 核心功能 视频生产 注意与前提 细分项 注意与前提费用 调用算子前,您需先了解使用算子时的模型调用费用,详情请参见大模型调用计费 。 鉴权(API Key) 调用算子前,您需要先生成算子调用的API Key,并建议将API Key配置为环境变量,便于更安全地调用算子,详情请参见获取 API Key 并配置。 BaseURL 调用算子前,您需要先根据您当前使用的LAS服务所在地域,了解算子调用的BaseURL,用于配置算子调用路径参数取值。 详情请参见获取 Base URL,下文中的调用示例仅作为参考,实际调用时需替换为您对应地域的路径取值。 API 调用 Generate POST https://operator.las.cn-beijing.volces.com/api/v1/contents/generations/tasks 接口说明 调用 seedance模型 进行视频生成。 请求参数 参数 类型 必填 示例值 说明model string doubao-seedance-1-5-pro-251215 您需要调用的模型的 ID (Model ID)。支持: doubao-seedance-1-5-pro-251215, doubao-seedance-1-0-pro-fast-251015 doubao-seedance-1-0-pro-250528, doubao-seedance-1-0-lite-t2v-250428 doubao-seedance-1-0-lite-i2v-250428 content list of object 输入给模型,生成视频的信息,支持文本信息、图片信息和样片信息。参考 创建视频生成任务 API 中的 content 参数。 callback_url string http://xxx/callback 填写本次生成任务结果的回调通知地址。当视频生成任务有状态变化时,方舟将向此地址推送 POST 请求。 回调请求内容结构与查询任务API的返回体一致。 回调返回的 status 包括以下状态: queued:排队中。 running:任务运行中。 succeeded: 任务成功。 failed:任务失败。(如发送失败,即5秒内没有接收到成功发送的信息,回调三次) expired:任务超时,即任务处于运行中或排队中状态超过过期时间。可通过 execution_expires_after 字段设置过期时间。 return_last_frame boolean false 是否返回视频最后一帧的图像,默认值为 false。 true:返回生成视频的尾帧图像。设置为 true 后,可通过 查询视频生成任务接口 获取视频的尾帧图像。 尾帧图像的格式为 png,宽、高、像素值与生成的视频保持一致,无水印。 使用该参数可实现生成多个连续视频:以上一个生成视频的尾帧作为下一个视频任务的首帧,快速生成多个连续视频。 false:不返回生成视频的尾帧图像。 execution_expires_after integer 172800 任务超时阈值。指定任务提交后的过期时间(单位:秒),从 created at 时间戳开始计算。默认值 172800 秒,即 48 小时。取值范围:[3600,259200] generate_audio boolean true 默认为true,控制生成的视频是否包含与画面同步的声音。 注意 仅 doubao-seedance 1.5 pro 支持。 true:模型输出的视频包含同步音频。doubao-seedance 1.5 pro 能够基于文本提示词与视觉内容,自动生成与之匹配的人声、音效及背景音乐。 建议将对话部分置于双引号内,以优化音频生成效果。 例如:男人叫住女人说:“你记住,以后不可以用手指指月亮。” false:模型输出的视频为无声视频。 draft boolean 默认false,控制是否开启样片模式 resolution string 720p 视频分辨率,枚举值: 480p 720p 1080p :参考图场景不支持 注意 doubao-seedance 1.5 pro、doubao-seedance 1.0 lite 默认值 720p doubao-seedance 1.0 pro&pro-fast 默认值:1080p ratio string 16:9 生成视频的宽高比例。 16:9 9:16 21:9 - adaptive: 根据输入自动选择最合适的宽高比。 说明 文生视频:默认 16:9 (doubao-seedance 1.5 Pro 默认值为 adaptive ) 图文视频:默认值 adaptive (参考图文视频场景默认值为 16:9 ) duration integer duration 和 frames 二选一即可,frames 的优先级高于 duration。如果您希望生成整数秒的视频,建议指定 duration。 生成视频时长,单位:秒。支持 2~12 秒。 frames integer doubao-seedance 1.5 pro 暂不支持。duration 和 frames 二选一即可,frames 的优先级高于 duration。如果您希望生成小数秒的视频,建议指定 frames。 生成视频的帧数。通过指定帧数,可以灵活控制生成视频的长度,生成小数秒的视频。 由于 frames 的取值限制,仅能支持有限小数秒,您需要根据公式推算最接近的帧数。 计算公式:帧数 = 时长 × 帧率(24)。 取值范围:支持 [29, 289] 区间内所有满足 25 + 4n 格式的整数值,其中 n 为正整数。 例如:假设需要生成 2.4 秒的视频,帧数=2.4×24=57.6。由于 frames 不支持 57.6,此时您只能选择一个最接近的值。根据 25+4n 计算出最接近的帧数为 57,实际生成的视频为 57/24=2.375 秒。 seed integer 种子整数,用于控制生成内容的随机性。取值范围:[-1, 2^32-1]之间的整数。 camera_fixed boolean false 参考图场景不支持 是否固定摄像头。枚举值: true:固定摄像头。平台会在用户提示词中追加固定摄像头,实际效果不保证。 false:不固定摄像头。 默认值为 false。 watermark boolean false 生成视频是否包含水印。枚举值: false: 不含水印。 true: 含有水印。 返回数据 参数 类型 说明id string 任务ID 示例 请求示例 curl --location "https://operator.las.cn-beijing.volces.com/api/v1/contents/generations/tasks" \ --header "Content-Type: application/json" \ --header "Authorization: Bearer $LAS_API_KEY" \ --data '{ "model": "doubao-seedance-1-0-pro-250528", "content": [ "type": "text", "text": "写实风格,晴朗的蓝天之下,一大片白色的雏菊花田,镜头逐渐拉近,最终定格在一朵雏菊花的特写上,花瓣上有几颗晶莹的露珠" "ratio": "16:9", "duration": 5, "watermark": false Bash 返回示例
"id": "cgt-20251125163544-qrj4f" JSON Task GET https://operator.las.cn-beijing.volces.com/api/v1/contents/generations/tasks/{id} 接口说明 查询视频生成任务状态。 请求参数 参数 类型 必填 示例值 说明id string cgt-2025-* 您需要查询的视频生成任务的 ID 。 本请求参数为Query String Parameters,在URL String中传入。 返回数据 参数 类型 示例值 说明id string cgt-2025-* 视频生成任务 ID model string 任务使用的模型名称和版本,模型名称-版本 status string succeeded 模型状态以及相关的信息: queued: 排队中。 running:任务运行中。 cancelled: 取消任务,取消状态24h自动删除(只支持排队中状态的任务被取消)。 succeeded: 任务成功。 failed: 任务失败。 expired: 任务超时。 error error 错误提示信息,任务成功返回null,任务失败时返回错误数据,错误信息具体参见 错误处理。 created_at integer 1764059744 创建时间 updated_at integer 1764059744 更新时间 content content 视频生成任务的输出内容。 seed integer 1345 本次请求使用的种子整数值。 resolution string 1080p 生成视频的分辨率。 ratio string 9:16 生成视频的宽高比。 duration integer 生成视频的时长,单位:秒。 说明:duration 和 frames 参数只会返回一个。创建视频生成任务时未指定 frames,会返回 duration。 frames integer 生成视频的帧数。 说明:duration 和 frames 参数只会返回一个。创建视频生成任务时指定了 frames,会返回 frames。 framespersecond integer 生成视频的帧率。 generate_audio boolean false 生成的视频是否包含与画面同步的声音。仅 Seedance 1.5 pro 会返回该参数。 true: 模型输出的视频包含同步音频。 false: 模型输出的视频为无声视频。 draft boolean false 生成的视频是否为 Draft 视频。仅 Seedance 1.5 pro 会返回该参数。 true: 表示当前输出为 Draft 视频。 false: 表示当前输出为正常视频。 draft_task_id string Draft 视频任务 ID。基于 Draft 视频生成正式视频时,会返回该参数。 execution_expires_after integer 任务超时阈值,单位:秒。 usage token_usage 视频生成token使用量 示例 请求示例 curl --location "https://operator.las.cn-beijing.volces.com/api/v1/contents/generations/tasks/cgt-xxxxxx" \ --header "Content-Type: application/json" \ --header "Authorization: Bearer $LAS_API_KEY" Bash 返回示例
"framesPerSecond": 24,
"id": "cgt-20251119202422-jcfm2", "model": "doubao-seedance-1-0-pro-250528", "status": "succeeded",
"content": {
"video_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/xxx.mp4", "last_frame_url": "https://ark-content-generation-cn-beijing.tos-cn-beijing.volces.com/xxx.png", "file_url": null
"usage": {
"completion_tokens": 295800
"frames": 145,
"framespersecond": 24,
"created_at": 1763555062,
"updated_at": 1763555155,
"seed": 655,
"ratio": "9:16",
"resolution": "1080p" JSON 错误码 HttpCode 错误码 错误信息 说明401 ApiKey.Invalid The api key is invalid. API不合法 最近更新时间:2026.03.30 14:23:36