Development Dreamina Videos

​

Dreamina Video Generation API

​

Headers

​

Request parameters

​

Input guidance

• Image: a clear, well-lit, front-facing portrait works best. The face should be unobstructed and reasonably large in frame.
• Audio: mp3/wav, publicly reachable. Keep it under 60s (≤30s recommended for 1080p, ≤60s for 720p).
• Both image_url and audio_url must be reachable from the public internet.

​

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

​

Async & retrieval

• Pass callback_url — the endpoint returns a task_id immediately and POSTs the result to your URL when ready.
• Pass async: true — the endpoint returns a task_id immediately; poll the result 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"
}

​

Pricing