认证
authorization string 必需
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的模型 ID
值: spark_avatar_imitator_v2v
image_url string 必需
人物图片 URL, 用于指定要生成数字人的人物形象
driving_video_info object 必需
驱动视频信息, 包含驱动视频的 URL 和存储类型
video_url
string必需驱动视频 URL, 用于指定驱动数字人动作的视频
store_type
integer必需存储类型
值:
0
轮询
由于图像生成需要时间, 您需要在创建任务后轮询任务状态
初始响应返回任务 ID 和初始状态. 实际的生成结果必须通过轮询任务状态端点来获取
响应格式
error object
错误信息. 仅在状态为 failed 时出现
code
string错误码
error_message
string详细错误信息
output array
生成结果. 仅在状态为 completed 时出现
content
array生成内容列表
type
string资源类型
值:
videourl
string生成的视频 URL（已处理并上传至 CDN）
size
integer视频大小（字节）
jobId
string远程任务 ID
usage object
使用统计. 仅在状态为 completed 时出现
cost
string总费用（美元）
discount
number折扣金额
input_tokens
integer输入 Token 数量
output_tokens
integer输出 Token 数量
total_tokens
integer总 Token 数量（ComfyUI 成本）
generated_videos
integer生成的视频数量
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 003018001 | 缺少图片 URL |
| 003018002 | 缺少驱动视频信息 |
| 003018003 | 缺少存储类型 |
| 003018004 | 缺少视频 URL |
| 003018005 | 无效的存储类型 |
| 003018006 | 无效的驱动视频信息格式 |
| 003018095 | 内部生成错误 |
| 003018096 | 结果解析异常 |
| 003018097 | HTTP 错误响应 |
| 003018098 | 状态检查异常 |
| 003018099 | 任务创建异常 |