dreamina-videolisted
Install: claude install-skill AceDataCloud/Skills
# Dreamina Talking-Photo Video Generation
Generate audio-driven digital human videos through AceDataCloud's Dreamina API (powered by ByteDance OmniHuman 1.5). Provide a portrait image and driving audio to produce a lip-synced talking-photo video.
> **Setup:** See [authentication](../_shared/authentication.md) for token setup.
## Quick Start
```bash
curl -X POST https://api.acedata.cloud/dreamina/videos \
-H "Authorization: ******" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://example.com/portrait.jpg",
"audio_url": "https://example.com/voiceover.mp3",
"async": true
}'
```
The response contains a `task_id`. Poll for the result:
```bash
curl -X POST https://api.acedata.cloud/dreamina/tasks \
-H "Authorization: ******" \
-H "Content-Type: application/json" \
-d '{"action": "retrieve", "id": "<task_id>"}'
```
> **Async:** See [async task polling](../_shared/async-tasks.md). Poll `POST /dreamina/tasks` until `response.data.status` equals `"done"`.
## Model
| Model | Description |
|-------|-------------|
| `omnihuman-1.5` | ByteDance OmniHuman 1.5 — audio-driven lip-sync digital human (default and only available model) |
## Workflow
### Basic Talking-Photo
Generate a video where a portrait person speaks a given audio track.
```json
POST /dreamina/videos
{
"model": "omnihuman-1.5",
"image_url": "https://example.com/portrait.jpg",
"audio_url": "https://example.com/speech.mp3",
"prompt": "Natural expression, steady h