DreamAPI
DreamAPI
Docs

Dreamact

POSThttps://api.newportai.com/api/async/wan/dreamact/2.1

The Dreamact API enables video-driven talking head generation, animating multiple facial images to mirror the expressions, mouth movements, and head poses of a driving video. The service reconstructs a drivable face model from input images and applies motion sequences extracted from the source video to create a realistic animated result.

  • Submit a POST request to the Dreamact API to obtain a taskId.
  • Submit a POST request to the Polling API to retrieve the Dreamact results.
  • Configure a Callback URL to receive results automatically on completion.

Request Headers

Content-Type string Required

Enum: application/json

Authorization string Required

Bearer authentication token. Example: Bearer {{APIKey}}.

Request Body

video string Required

The URL of the driving video file. It must be publicly accessible in MP4 format, and the duration must not exceed 1 minute.

images array Required

A list of publicly accessible image URLs. Supported formats include JPG, JPEG, PNG, WEBP, and GIF.

resolution string Optional

The processing resolution for the generated video. Supported values: 480P, 720P. Default is 480P. Higher resolution produces better quality but consumes more credits (see Pricing tab).

qualityMode string Optional

The quality mode for the generated video. Supported values: high, base. Default is base.

taskMode string Optional

The generation mode. Supported values: replace_body (Swap the character in source video while keeping original movements and background), pose2v (Generate video of the reference character following given pose sequences). Default value: replace_body.

seed integer Optional

The seed value used for generation to ensure reproducibility. Default value: 42.

Response

code integer

Returns 0 for success, or a specific error code.

message string

Returns "success" or a descriptive error message.

data object
taskId string

The unique identifier for the task. Use this ID with the Polling API to retrieve the generated output.

Errors

10192Illegal param

Polling

Use the Polling API to retrieve the processing results.

Callback

Alternatively, you can enable Callback to receive task results automatically upon completion.

0Task Completed
{
    "code": 0,
    "message": "success",
    "data": {
        "task": {
            "taskId": "b3e8416cdbe14a229b3c47f4d91bfebb",
            "status": 3,
            "executionTime": 221829,
            "expire": 1769052600483,
            "taskType": "wan/dreamact/2.1"
        },
        "videos": [
            {
                "videoType": "mp4",
                "videoUrl": "https://dreamface-resource-aigc.oss-us-east-1.aliyuncs.com/dreamapi/o/2026-01-20/a96a1b03307a4a28b7bbf5f771c6322d.mp4"
            }
        ]
    }
}
Request
cURL
curl -X POST 'https://api.newportai.com/api/async/wan/dreamact/2.1' \
  -H "Authorization: Bearer {{key}}" \
  -H 'Content-Type: application/json' \
  -d '{
    "images":["https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/INj5UrnnrKIzCR1uYBWv0.png"],
    "video":"https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/mq0MSmKgPGQQsxS9UovqH.mp4",
    "seed":-1,
    "resolution":"720P",
    "qualityMode":"base",
    "taskMode":"pose2v"
}'
0Successful
{
    "code": 0,
    "message": "success",
    "data": {
        "taskId": "b3e8416cdbe14a229b3c47f4d91bfebb"
    }
}