Development Dreamina Videos

​

Dreamina Digital Human Video Generation API

​

Request Headers

​

Request Parameters

​

Input Recommendations

• Image: Clear, well-lit frontal portrait works best; face unobstructed, occupying a moderate proportion of the frame.
• Audio: mp3/wav, must be publicly accessible. Recommended duration is within 60 seconds (1080p recommended ≤30 seconds, 720p ≤60 seconds).
• Both image_url and audio_url must be publicly accessible.

​

Response Example

{
  "success": true,
  "task_id": "0c0b4d3a-2f1e-4a6b-9c2d-2b3c4d5e6f70",
  "trace_id": "a9063166-26ed-4451-85b5-54e896817c69",
  "data": {
    "task_id": "362b4fed67bd11f1ad1100163e57d510",
    "status": "done",
    "video_url": "https://cdn.acedata.cloud/634d760216.mp4",
    "image_url": "https://cdn.acedata.cloud/4hfydw.jpg",
    "audio_url": "https://cdn.acedata.cloud/6f7d62b18b.wav"
  }
}

​

Asynchronous and Querying

• Provide callback_url: The interface immediately returns task_id, and the result is sent to this address after generation.
• Provide async: true: The interface immediately returns task_id, then poll results via POST /dreamina/tasks (free) by task_id or trace_id.

​

Error Handling

{
  "error": {
    "code": "bad_request",
    "message": "image_url is required (a public URL of a portrait image)"
  },
  "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab"
}

​

Billing