API 文档

通过九马媒体 API 上传素材、创建数字人形象与音色、制作视频并查询结果。

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

接入约定

推荐使用 X-Secret-Key: <secret_id-secret_key> 请求头认证。请在服务端安全保存凭据,不要把真实密钥放到网页或公开仓库中。部分接口也支持签名或用户令牌,具体以接口鉴权规则为准。

响应通常包含 code、message、data:code=200 表示业务成功,其余情况应读取 message。HTTP 状态与业务码请分别检查。

推荐调用顺序

  1. 准备可访问的素材 URL 或 Base64。
  2. 创建数字人形象,选择已有音色或传入录音地址创建音色。
  3. 创建数字人短视频,保存返回的任务 ID。
  4. 查询任务详情,制作完成后读取成品地址;失败时查看原因。

接口分类