数字人短视频接口

提交视频制作任务并查询制作结果。

当前环境请求基址https://api.jiuma.com

创建数字人短视频

使用形象和音频片段创建异步制作任务。

POST/digitalHumanVideo/createDigitalHumanVideo

请求地址：https://api.jiuma.com/digitalHumanVideo/createDigitalHumanVideo

请求参数

参数	类型	要求	说明
`video_url`	string\|int	必填	形象 ID、素材 URL 或 base64
`audios`	array	必填	至少一项，选择下方一种驱动方式填写
`type`	string	选填	cartoon 或 super，默认 super
`clarity_type`	int	选填	1 标准 480P、2 高品质 720P
`callback_url`	string	选填	http/https 制作成功回调地址

文本驱动 audios[0]

参数	类型	要求	说明
`drive`	string	必填	固定为 text
`words`	string	必填	需要朗读的台词
`audio_config`	int	必填	当前用户可用的音色 ID

录音驱动 audios[0]

参数	类型	要求	说明
`drive`	string	必填	固定为 audio
`audio_url`	string	必填	可访问的音频 URL 或 base64；时长须小于 60 秒

请求示例

cURL · Bash / macOS / Linux · 文本驱动

curl -X POST "https://api.jiuma.com/digitalHumanVideo/createDigitalHumanVideo" \
  -H "X-Secret-Key: <secret_id-secret_key>" \
  --data-urlencode "video_url=456" \
  -d "audios[0][drive]=text" \
  --data-urlencode "audios[0][words]=您好，欢迎使用九马 AI。" \
  -d "audios[0][audio_config]=789"

cURL · Bash / macOS / Linux · 录音驱动

curl -X POST "https://api.jiuma.com/digitalHumanVideo/createDigitalHumanVideo" \
  -H "X-Secret-Key: <secret_id-secret_key>" \
  -d "video_url=456" \
  -d "audios[0][drive]=audio" \
  --data-urlencode "audios[0][audio_url]=https://example.com/speech.mp3"

响应示例

JSON

{
  "code": 200,
  "message": "创建成功",
  "data": 901
}

关键返回字段

data: 异步制作任务 ID；查询详情时传入 human_video_id。

常见失败原因

缺少形象或音频参数、音色不可用、马力不足、创建失败。

获取数字人短视频详情

按任务 ID 查询制作状态、失败原因和成品视频地址。

POST/digitalHumanVideo/digitalHumanVideoInfo

请求地址：https://api.jiuma.com/digitalHumanVideo/digitalHumanVideoInfo

请求参数

参数	类型	要求	说明
`human_video_id`	int\|string	必填	创建接口返回的短视频 ID

请求示例

cURL · Bash / macOS / Linux

curl -X POST "https://api.jiuma.com/digitalHumanVideo/digitalHumanVideoInfo" \
  -H "X-Secret-Key: <secret_id-secret_key>" \
  -d "human_video_id=901"

响应示例

JSON

{
  "code": 200,
  "message": "查询成功",
  "data": {
    "id": 901,
    "check_status": 21,
    "check_status_name": "制作完成",
    "check_reason": "",
    "new_video_file_url": "https://example.com/result.mp4"
  }
}

关键返回字段

data.check_status: 制作状态；21 表示制作完成，17 表示制作失败。
data.check_status_name: 可直接展示给用户的状态名称。
data.check_reason: 制作失败时读取具体原因。
data.new_video_file_url: 制作完成后读取成品视频地址，未完成时可能为空。

常见失败原因

ID 缺失、任务不存在、无权查看；制作失败时读取 check_reason。