⌘K

Spark Actor Imitation

spark_actor_imitation

输入一张图片和一段模版视频, 可以将图片中的人物按照模版视频的动作/表情/口型驱动起来, 主体及背景特征与输入图片保持一致

认证

authorization string 必填

所有 API 均使用 Bearer Token 鉴权

获取 API Key:

访问 API Key 管理页面 获取 API Key

用法:

将以下 Header 添加到请求中:

Authorization: Bearer YOUR_API_KEY

参数

model string 必填

请求使用的模型 ID.

值:spark_actor_imitation


video_url string 必填

参考视频 URL


image_url string 必填

图片 URL


轮询

由于视频生成需要时间, 您需要在创建任务后轮询任务状态

初始响应返回任务 ID 和初始状态. 实际的生成结果必须通过轮询任务状态端点来获取

响应格式

error object

错误信息. 仅在状态为 failed 时出现.

code string

错误码

error_message string

详细错误信息


output array

生成结果. 仅在状态为 completed 时出现.

content array

生成内容列表

type string

资源类型, 如 video, image

url string

生成内容的 URL


usage object

使用统计. 仅在状态为 completed 时出现.

cost string

总费用 (美元)

discount number

折扣金额


metadata object

元数据信息


错误码

错误码描述
003017001缺少参考视频 URL
003017002缺少图片 URL
003017095内部生成错误
003017096结果解析错误
003017097HTTP 错误响应
003017098状态检查错误
003017099任务创建错误/服务不可用