认证
authorization string 必需
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的模型 ID
值: spark_dance_v1_0_lite_t2v
content array 必需
输入给模型, 生成视频的信息, 支持文本格式
文本内容对象
type
string必需内容类型
值:
texttext
string必需输入给模型的文本内容, 描述期望生成的视频, 包括:
文本提示词（必填）: 支持中英文. 建议不超过 500 字. 字数过多信息容易分散, 模型可能因此忽略细节, 只关注重点, 造成视频缺失部分元素
callback_url string
填写本次生成任务结果的回调通知地址
return_last_frame boolean
是否返回生成视频的尾帧图像
true: 返回生成视频的尾帧图像. 设置为 true 后, 可通过查询视频生成任务接口获取视频的尾帧图像. 尾帧图像的格式为 png, 宽高像素值与生成的视频保持一致, 无水印. 使用该参数可实现生成多个连续视频: 以上一个生成视频的尾帧作为下一个视频任务的首帧, 快速生成多个连续视频
false: 不返回生成视频的尾帧图像
默认值: false
service_tier string
指定处理本次请求的服务等级类型
default: 在线推理模式
flex: 离线推理模式
默认值: default
可选值: default, flex
execution_expires_after integer
任务超时阈值. 指定任务提交后的过期时间（单位: 秒）, 从 created_at 时间戳开始计算
默认值: 172800（48 小时）
范围: [3600, 259200]
resolution string
视频分辨率
默认值: 720p
可选值: 480p, 720p, 1080p
ratio string
生成视频的宽高比例
默认值: 16:9
可选值: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9
duration integer
生成视频时长, 单位: 秒
duration 和 frames 二选一即可, frames 的优先级高于 duration. 如果您希望生成整数秒的视频, 建议指定 duration
默认值: 5
范围: 2 - 12
frames integer
生成视频的帧数
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
范围: [-1, 2^32-1]
camera_fixed boolean
是否固定摄像头
默认值: false
可选值: true, false
watermark boolean
生成视频是否包含水印
默认值: false
可选值: true, false
轮询
由于视频生成需要时间, 您需要在创建任务后轮询任务状态
初始响应返回任务 ID 和初始状态. 实际的生成结果必须通过轮询任务状态端点来获取
响应格式
error object
错误信息. 仅在状态为 failed 时出现
code
string错误码
error_message
string详细错误信息
output array
生成结果. 仅在状态为 completed 时出现
content
array生成内容列表
type
string资源类型
url
string内容 URL
size
integer视频大小
jobId
string远程任务 ID
duration
integer视频时长（秒）
format
string视频格式
resolution
string视频分辨率
ratio
string宽高比
fps
integer帧率
usage object
使用统计信息. 仅在状态为 completed 时出现
cost
string总费用（美元）
discount
number折扣金额
input_tokens
integer输入令牌数
output_tokens
integer输出令牌数 / 完成令牌数
total_tokens
integer总令牌数
generated_videos
integer生成的视频数量
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 003004001 | 缺少内容 |
| 003004002 | 内容格式无效 |
| 003004003 | 分辨率无效 |
| 003004004 | 宽高比无效 |
| 003004005 | 时长无效 |
| 003004006 | 帧率无效 |
| 003004007 | 种子无效 |
| 003004008 | 布尔参数无效 |
| 003004009 | 缺少内容类型 |
| 003004010 | 缺少文本字段 |
| 003004095 | 内部生成错误 |
| 003004096 | 结果解析异常 |
| 003004097 | HTTP 错误响应 |
| 003004098 | 状态检查异常 |
| 003004099 | 任务创建异常 |