MoonApiX Docs

Appearance

创建数字人视频任务 ​

数字人视频任务用于把形象和音频合成为视频。通常先准备 avatar_asset_id 和音频 URL，再提交视频任务。

前置资源 ​

资源获取方式
avatar_asset_id通过 POST /v1/assets/uploads 上传或登记形象素材。
audio_url数字人音频任务成功后返回，或使用可访问的音频 URL。
model使用数字人视频模型，例如 digital-human-video-v8。

创建视频任务 ​

http
POST /v1/tasks
bash
curl https://moonapix.com/v1/tasks \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "digital-human-video-v8",
    "avatar_asset_id": "asset_avatar_xxx",
    "audio_url": "https://example.com/audio.mp3",
    "name": "brand-host-video"
  }'

查询视频任务 ​

http
GET /v1/tasks/{task_id}
bash
curl https://moonapix.com/v1/tasks/task_xxx \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

响应字段 ​

字段说明
task_id视频任务 ID。
status任务状态。
url / video_url成功后的结果地址。
fail_reason / error失败时的错误信息。

排查建议 ​

现象检查项
形象不可用确认 avatar_asset_id 是否正确，素材是否可访问。
音频不可用确认 audio_url 可直接访问，音频任务已成功。
任务长时间处理中保留 task_id，稍后继续查询，或使用 Webhook。
结果不符合预期检查形象素材质量、音频清晰度和输入字段。

相关页面 ​