Skip to main content
This guide will walk you through the process of creating and training your first custom digital human avatar using NavTalk.

​
Prerequisites

Before you begin, ensure you have:
  • A NavTalk account with API access
  • Your API key (obtain from the dashboard)
  • Training video ready (meeting the quality requirements)

​
Step-by-Step Process

1

Prepare Training Video

Before uploading, ensure your training video meets the quality and content requirements. See the Reference Materials Requirements page for detailed specifications, recommended content, troubleshooting tips, and a reference video example.
2

Start Training Process

Initiate the avatar training:
curl -X POST "https://api.navtalk.ai/api/v1/userImage/generateAvatar" \
  -H "Authorization: Bearer your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "mediaUrl": "222",
    "avatarId": "aaa"
  }'
3

Monitor Training Progress

Check the training status periodically:
curl -X GET "https://api.navtalk.ai/train/avatar/{training_job_id}/status" \
  -H "Authorization: Bearer your-api-key-here"
Training typically takes 15-60 minutes depending on the complexity and quality settings. You can check status periodically or set up webhooks for notifications.
4

Use Your Custom Avatar

Once training is complete, use your custom avatar in your applications:
# For Video Synthesis API
curl -X POST "https://app.navtalk.ai/generate" \
  -H "Content-Type: application/json" \
  -d '{
    "license": "your-api-key-here",
    "character_name": "custom.my-avatar-123",
    "content": "Hello, this is my custom avatar!",
    "voice": "echo"
  }'

​
Troubleshooting

  • Check file sizes and formats (MP4, MOV recommended, under 50MB)
  • Verify video meets minimum requirements (at least 2 seconds, 1080p or lower)
  • Ensure videos are not corrupted
  • Check that your training video meets quality requirements (clear, well-lit, consistent appearance)
  • Contact support if issues persist
  • Ensure videos meet quality requirements (1080p or lower, at least 2 seconds)
  • Check that lighting is consistent and adequate
  • Verify facial features are clearly visible throughout
  • Avoid videos with complex facial hair (beards, mustaches) - use portraits with little or no facial hair
  • Ensure videos meet resolution requirements (1080p or lower, not higher)
  • Ensure good lighting throughout
  • Avoid portraits with beards or complex facial hair - use portraits with little or no facial hair
  • Consider using a video that can loop naturally for smoother synthesis
  • Try increasing training iterations or using higher quality settings
  • Verify that training completed successfully and note the character name
  • Check that the training status shows ‘completed’ before attempting to use the avatar