Geração de vídeo
POST /v1/videos/generations oferece suporte a texto para vídeo, imagem para vídeo e transições de primeiro/último quadro. Ele retorna um job imediatamente; faça polling no endpoint de job compartilhado.
curl -sS -X POST https://api.dreamutopia.net/v1/videos/generations \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "medium",
"prompt": "a gentle camera push as the fox turns",
"image": "<upload_id>",
"resolution": "720p",
"duration": 8
}'{ "id": "a646…", "type": "video", "status": "queued", "created_at": "2026-10-24T12:00:00Z" }Campos
| Campo | Valores |
|---|---|
| model | lite, medium, pro |
| prompt | Obrigatório, não vazio, até 8.000 caracteres |
| resolution | 480p, 720p, 1080p; lite não pode usar 1080p |
| duration | Segundos: 5–10 para lite, 5–15 para medium, 5–30 para pro |
| image | Primeiro frame: id de upload ou URL do DreamUtopia. Omitir para texto-para-vídeo. |
| last_frame_image | Requer image; não suportado por lite |
| generate_audio | Apenas pro, e a conta precisa ter premium; lite e medium são recusados |
model
- Valores
lite,medium,pro
prompt
- Valores
- Obrigatório, não vazio, até 8.000 caracteres
resolution
- Valores
480p,720p,1080p;litenão pode usar1080p
duration
- Valores
- Segundos: 5–10 para
lite, 5–15 paramedium, 5–30 parapro
image
- Valores
- Primeiro frame: id de upload ou URL do DreamUtopia. Omitir para texto-para-vídeo.
last_frame_image
- Valores
- Requer
image; não suportado porlite
generate_audio
- Valores
- Apenas
pro, e a conta precisa ter premium;liteemediumsão recusados
resolution tem como padrão 720p. generate_audio é exclusivo de pro e exige premium: lite e medium são recusados com 400 invalid_request, e pro sem premium retorna 403 unauthorized.
Primeiro/último quadro
-d '{
"model": "pro",
"prompt": "day turns to night over the city",
"image": "<upload_id>",
"last_frame_image": "<upload_id>",
"resolution": "720p",
"duration": 10
}'Ambos os frames devem ser uploads ou URLs do DreamUtopia. Um frame final sem um frame inicial é rejeitado.
Custo
Os créditos de vídeo dependem apenas da duração: cada nível tem três faixas de duração, e a resolução está incluída até o limite do nível. GET /v1/models retorna a matriz exata resolution → duration → credits, que corresponde ao que é cobrado. O áudio está incluído no preço, sem acréscimo.