Create a digital human video task

Digital human video tasks combine an avatar and audio. Prepare an avatar_asset_id and audio URL before submitting the task.

Pre-resources

Resources	Access
avatar_asset_id	Upload or register image media assets by POST /v1/assets/uploads.
audio_url	URL from a successful digital human audio task, or another accessible audio URL.
model	Use digital human video models, for example digital-human-video-v8.

Create a video task

POST /v1/tasks

curl https://moonnexai.com/v1/tasks \
  -H "Authorization: Bearer <MOONNEXAI_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"
  }'

Query a video task

GET /v1/tasks/{task_id}

curl https://moonnexai.com/v1/tasks/task_xxx \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>"

Response fields

field	Annotations
task_id	Video task ID.
status	Task status.
url / video_url	The successful outcome address.
fail_reason / error	Error message when failed.

Recommendations for the examination

phenomena	Checkpoint
Image is not available	Confirms whether avatar_asset_id is correct and media assets is accessible.
Audio is not available	Confirm that audio_url is directly accessible and audio task has been successfully accessed.
task is in the process of being processed for long periods	Keep task_id, continue the query later, or use Webhook.
The results were not in line with expectations	Check image media assets quality, audio clarity and input field.

Relevant Pages

• Resources and Images
• Create Audio Job
• Overview of mandate management
• API Reference