curl --request POST \
  --url https://api.modellix.ai/api/v1/vidu/viduq2-turbo-digital-human \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "image_url": "https://example.com/portrait.jpg"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-vidu-dh-001",
    "model_id": "vidu/viduq2-turbo-digital-human",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-vidu-dh-001"
    }
  }
}

{
  "code": 400,
  "message": "Invalid parameters: parameter 'first_frame_image' is required"
}

{
  "code": 401,
  "message": "Authentication failed: invalid API key"
}

{
  "code": 429,
  "message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}

{
  "code": 500,
  "message": "Internal server error"
}

Vidu Q2 Turbo Digital Human

[Core Function] Vidu Q2 Turbo Digital Human is a fast portrait animation model. [Strengths] It excels at quickly animating a static portrait image into a speaking or moving digital human, syncing lip movements to provided audio with low latency. [Best For] Highly recommended for: rapid generation of talking head videos, quick virtual presenters, and responsive interactive avatars. [Limitations] Do NOT use this model for complex full-body motion, multi-character interactions, or videos longer than 10 seconds. [Routing] Use this model when the user wants to make a portrait ‘talk’ quickly. For higher realism and better quality, route to Q2 Pro Digital Human.

POST

vidu

viduq2-turbo-digital-human

curl --request POST \
  --url https://api.modellix.ai/api/v1/vidu/viduq2-turbo-digital-human \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "image_url": "https://example.com/portrait.jpg"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-vidu-dh-001",
    "model_id": "vidu/viduq2-turbo-digital-human",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-vidu-dh-001"
    }
  }
}

{
  "code": 400,
  "message": "Invalid parameters: parameter 'first_frame_image' is required"
}

{
  "code": 401,
  "message": "Authentication failed: invalid API key"
}

{
  "code": 429,
  "message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}

{
  "code": 500,
  "message": "Internal server error"
}

Authorizations

Authorization

string

header

required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

Vidu Q2 digital human request.

image_url

string

required

Portrait image URL or base64 data URI

Minimum string length: 1

Example:

"https://example.com/portrait.jpg"

prompt

string

Motion or speech description for the digital human

Required string length: 1 - 2000

Example:

"Presenter speaks confidently, making eye contact with the camera"

audio_url

string

Audio file URL. When provided, the digital human's lip movements will synchronize to this audio track.

Minimum string length: 1

Example:

"https://example.com/speech.mp3"

resolution

enum<string>

default:720p

Video resolution

Available options:

540p,

720p,

1080p

Example:

"1080p"

Response

Task submitted successfully

code

integer

required

Response code, 0 indicates success

Example:

0

message

string

required

Response message

Example:

"success"

data

object

required

Detailed data about the submitted asynchronous task.

Show child attributes

Viduq2 pro multi frame Viduq2 turbo multi frame

Model API

Common API

File API

Vidu Q2 Turbo Digital Human

Authorizations

Body

Response