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

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

{
  "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 Pro Digital Human

[Core Function] Vidu Q2 Pro Digital Human is a premium portrait animation model. [Strengths] It excels at generating highly realistic, expressive digital humans from a single portrait image, featuring precise lip-sync to audio and natural facial micro-expressions. [Best For] Highly recommended for: professional virtual spokespersons, high-end educational videos, news anchoring, and realistic character animation. [Limitations] Do NOT use this model for complex full-body physical interactions or videos longer than 10 seconds. [Routing] Use this by default for ‘talking head’ or ‘digital human’ requests prioritizing realism over speed.

POST

vidu

viduq2-pro-digital-human

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

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

{
  "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

Template story Viduq2 pro multi frame

Model API

Common API

File API

Vidu Q2 Pro Digital Human

Authorizations

Body

Response