Skip to main content

​
Welcome to NavTalk API

The NavTalk REST API provides programmatic access to manage your AI providers, models, voices, digital human avatars, and video generation tasks. This API complements the Real-time Digital Human API by allowing you to manage the resources needed for real-time conversations and video synthesis.

Real-time Digital Human API

WebSocket-based API for real-time conversations with digital humans

Video Synthesis API

Generate high-quality videos with digital human avatars

​
Base URL

https://api.navtalk.ai
Alternative Environments:
  • QA Environment: https://qaapi.navtalk.ai
  • Development Environment: https://devapi.navtalk.ai

​
Authentication

All API endpoints require authentication using your NavTalk license key. You can provide the license key in two ways:

​
Method 1: Query Parameter

GET https://api.navtalk.ai/api/open/v1/provider/list?license=your-license-key

​
Method 2: Authorization Header

curl https://api.navtalk.ai/api/open/v1/provider/list \
  -H "Authorization: Bearer your-license-key"
You can obtain your license key from the NavTalk Dashboard.

​
Core Data Resources

The NavTalk API is organized around four core data resources that work together to create and manage digital human experiences.

​
Providers

Providers represent the AI service providers (e.g., OpenAI, ElevenLabs) that you have connected to your NavTalk account.
  • Purpose: Manage your connected AI providers
  • Usage: Required when creating avatars or querying available models and voices
  • Key Fields: id, provider, name

List Providers

GET /api/open/v1/provider/list
Example Response: 
{
  "code": 200,
  "message": "SUCCESS",
  "data": [
    {
      "id": "b92a28fb2ea737457c7f13ba554759c0",
      "provider": "OpenAIRealtime",
      "name": "My OpenAI Provider"
    },
    {
      "id": "a83b19ec1da626346b6e02a9443648d1",
      "provider": "ElevenLabs",
      "name": "My ElevenLabs Provider"
    }
  ]
}

​
Models

Models are the AI models available from each provider. Different models offer different capabilities, performance characteristics, and pricing.
  • Purpose: Query available AI models for a specific provider
  • Usage: Select a model when creating an avatar
  • Key Fields: id, model, provider

List Models

GET /api/open/v1/model/list?providerId={providerId}
Example Response: 
{
  "code": 200,
  "message": "SUCCESS",
  "data": [
    {
      "id": "agent_3201khcbet2vf349gpmtfg83q0hy",
      "model": "gpt-4o-realtime-preview-2024-12-17",
      "provider": "OpenAIRealtime"
    }
  ]
}

​
Voices

Voices are the text-to-speech voices available from each provider. Each voice has unique characteristics like tone, accent, and language support.
  • Purpose: Query available voices for a specific provider
  • Usage: Select a voice when creating an avatar
  • Key Fields: id, voice, provider

List Voices

GET /api/open/v1/voice/list?providerId={providerId}
Example Response: 
{
  "code": 200,
  "message": "SUCCESS",
  "data": [
    {
      "id": "CwhRBWXzGAHq8TQ4Fs17",
      "voice": "Rachel",
      "provider": "ElevenLabs"
    },
    {
      "id": "ash",
      "voice": "ash",
      "provider": "OpenAIRealtime"
    }
  ]
}

​
Avatars

Avatars are digital human characters that you create and manage. Avatars can be created from videos or images and are used in real-time conversations and video synthesis.
  • Purpose: Create, manage, and configure digital human avatars
  • Usage: Use avatars in real-time conversations or video generation
  • Key Operations: Create, List, Update, Delete, Check Status

Add Avatar

Create a new avatar from video or image

List Avatars

Get all avatars for your account

Avatar Detail

Get detailed information about an avatar

Update Avatar

Update avatar configuration

Check Status

Check avatar training status

Delete Avatar

Remove an avatar from your account
Avatar Creation Flow:

​
Additional Resources

​
File Upload

Upload media files (videos, images, audio) to NavTalk’s storage for use in avatar creation and video generation.

Upload File

POST /api/open/v1/file/upload

​
Video Generation

Generate looping videos of digital human avatars for background animations or idle states.

Generate Loop Video

Start a loop video generation job

Check Generation Status

Poll the status of a video generation job

​
Typical Workflow

Here’s a typical workflow for getting started with the NavTalk API:
1

List Your Providers

Call GET /api/open/v1/provider/list to see which AI providers you have connected.
2

Query Available Models and Voices

For each provider, query available models and voices:
  • GET /api/open/v1/model/list?providerId={providerId}
  • GET /api/open/v1/voice/list?providerId={providerId}
3

Create an Avatar

Upload a video or image and create an avatar:
POST /api/open/v1/avatar/add
{
  "name": "my-avatar",
  "url": "https://example.com/video.mp4",
  "providerId": "b92a28fb2ea737457c7f13ba554759c0",
  "model": "agent_3201khcbet2vf349gpmtfg83q0hy",
  "voice": "CwhRBWXzGAHq8TQ4Fs17",
  "firstMessage": "Hello!",
  "prompt": "You are a helpful assistant."
}
4

Check Training Status

Poll the avatar training status:
GET /api/open/v1/avatar/status?jobId={jobId}
5

Use Your Avatar

Once training is complete, use your avatar in:

​
Need Help?

Real-time API Quick Start

Get started with real-time digital human conversations

Video Synthesis Quick Start

Learn how to generate videos with avatars

Custom Avatar Training

Create custom avatars from your own videos or images

Support

Contact our support team for assistance