跳转到主要内容
Seedance 2.5
使用字节官方模型 ID dreamina-seedance-2-5-260628。沿用官方 JSON 请求结构,替换视频基础 URL 和 API Key 即可接入 TensorAI;资产管理的 URL、AK/SK 替换方式见 迁移配置。 点击“试一试”创建任务;成功后可点击“查询任务”,自动带入任务 ID 和 API Key。已有任务可使用 查询视频任务 查看状态和结果。

创建任务

成功返回 HTTP 200:
保存返回的 id,用于查询任务状态和视频结果。

请求参数

请求体上限为 64 MiB。布尔参数请使用 JSON 的 true / false;可选参数未传时由模型决定,传入值须符合字段及模型要求。

2.5 参数组合

首帧 / 首尾帧任务,以及 edit / extend 任务需使用 ratio=adaptive。编辑和延长需提供 reference_video;编辑时若指定 duration,须为 -1。 支持 {"type":"draft_task","draft_task":{"id":"<DRAFT_TASK_ID>"}} 引用同账号已成功的 2.5 样片任务;请使用与样片相同的模型。正式成片参数还需满足实际模型对分辨率等字段的要求。

素材与 content

素材可使用公网 HTTP(S) URL 或当前账号的 asset://<ASSET_ID>。图片、音频还支持 Base64 Data URL(解码后分别最多 30 MiB、15 MiB);视频暂不支持内联 Base64。公网 URL 不能指向本地或私网地址。 例如,把创建请求中的 content 替换为参考图输入:
“试一试”默认提供一条文本和一条图片。通过 type 选择素材类型,填写对应字段;其他素材可点击“添加项目”继续添加,也可删除不需要的项目。 已有资产引用会校验归属和状态。手动管理资产的创建、查询与活体校验见 资产管理。

查询结果

试一试:查询视频任务。Seedance 2.0、2.5 共用同一查询接口。
成功响应示例(可选元数据以实际返回为准):
只可查询当前账号创建的任务。主视频地址为平台转存地址;启用并成功返回尾帧时读取 content.last_frame_url。自动时长场景读取查询结果的实际 duration。

官方 Python SDK 接入

以下示例使用官方 volcenginesdkarkruntime SDK。SDK 安装说明见 官方文档。
设置环境变量 PLATFORM_API_KEY 为 TensorAI API Key: