DreamAPI
DreamAPI
Docs

DreamAvatar 3.0 Fast

POSThttps://api.newportai.com/api/async/dreamavatar/image_to_video/3.0fast

The DreamAvatar 3.0 Fast API generates a talking avatar from audio and image inputs. The resulting avatar accurately mirrors the facial expressions and vocal tone of a real person while supporting multiple languages.

  • Submit a POST request to the DreamAvatar 3.0 Fast API to obtain a taskId.
  • Submit a POST request to the Polling API to retrieve the Image-to-Video DreamAvatar 3.0 Fast 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

audio string Required

The URL of the audio file. It must be publicly accessible in MP3, WAV, or MP4 format, and the duration must not exceed 3 minutes.

image string Required

The URL of the image file. It must be publicly accessible and in JPG, JPEG, PNG, WEBP, or GIF format.

prompt string Required

The text prompt used to guide the generation process.

resolution string Optional

Specifies the resolution of the output video. Options: 480p or 720p. Default: 480p.

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": "aa4bf173ffd84c2f8734d536d6a7b5a7",
            "status": 3
        },
        "videos": [
            {
                "videoType": "mp4",
                "videoUrl": "https://dreamface-resource-cv.oss-us-east-1.aliyuncs.com/videogen-avatar/2025-09-01/7368200032188366851.mp4"
            }
        ]
    }
}
Request
cURL
curl -X POST 'https: //api.newportai.com/api/async/dreamavatar/image_to_video/3.0fast' \
  -H "Authorization: Bearer {{key}}" \
  -H 'Content-Type: application/json' \
  -d '{
      "audio": "https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/AoOVLxqINsl1dTAAhnmAW.wav",
      "image": "https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/INj5UrnnrKIzCR1uYBWv0.png",
      "prompt": "a boy smile ",
      "resolution": "480p"
}'
0Successful
{
    "code": 0,
    "message": "success",
    "data": {
        "taskId": "aa4bf173ffd84c2f8734d536d6a7b5a7"
    }
}