DreamAPI
DreamAPI
Docs

DreamVideo 3.0

POSThttps://api.newportai.com/api/async/dreamvideo_3.0/text_to_video

The DreamVideo 3.0 API is an advanced video generation model that supports multiple generation modes, including text-to-video and image-to-video, enabling flexible and high-quality video creation.

The DreamVideo 3.0 Text To Video API generates videos directly from a text prompt. It supports 480P and 720P output, with a configurable duration from 3 to 15 seconds.

  • Submit a POST request to the DreamVideo 3.0 Text To Video API to obtain a taskId.
  • Submit a POST request to the Polling API to retrieve the generated video 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

prompt string Required

Text prompt describing the video content to generate.

duration integer Optional

Video duration in seconds. Range: [3-15]. Default: 5.

resolution string Optional

Video resolution. Available options: 480P, 720P. Default: 480P.

aspectRatio string Optional

Aspect ratio of the generated video. Default: auto. When provided, it must not be empty. Available options: 9:16, 3:4, 1:1, 4:3, 16:9.

seed integer Optional

The seed value used for generation to ensure reproducibility. Default: 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": "API-20d5247d5f2a418abfb1603ad4e28906",
            "status": 3,
            "executionTime": 84467,
            "expire": 1788339892017,
            "taskType": "dreamvideo_3.0/text_to_video",
            "creditsConsumed": 10
        },
        "videos": [
            {
                "videoType": "mp4",
                "videoUrl": "https://dreamapi-rs-aigc.newportai.com/dreamapi/o/2026-09-02/dreamvideo30_t2v_example.mp4"
            }
        ]
    }
}
Request
cURL
curl -X POST 'https://api.newportai.com/api/async/dreamvideo_3.0/text_to_video' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {{key}}' \
  -d '{
  "prompt": "A person standing in close-up, then turning away and walking into a wide landscape",
  "duration": 5,
  "resolution": "480P",
  "aspectRatio": "1:1",
  "seed": 42
}'
0Successful
{
    "code": 0,
    "message": "success",
    "data": {
        "taskId": "API-20d5247d5f2a418abfb1603ad4e28906"
    }
}