Geração de imagens
POST /v1/images/generations cria uma tarefa de imagem e retorna imediatamente. Consulte o endpoint de tarefa compartilhado para obter o resultado.
curl -sS -X POST https://api.dreamutopia.net/v1/images/generations \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "pro",
"prompt": "a red fox in fresh snow, cinematic lighting",
"resolution": "2k",
"aspect_ratio": "16:9"
}'{ "id": "3f2b…", "type": "image", "status": "queued", "created_at": "2026-10-24T12:00:00Z" }Campos
| Campo | Valores |
|---|---|
| model | lite, pro |
| prompt | Obrigatório, não vazio, até 8.000 caracteres |
| resolution | 2k, 4k; lite aceita apenas 2k |
| aspect_ratio | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, adaptive |
| reference_images | Carregue ids ou URLs do DreamUtopia; 0–3 para lite, 0–14 para pro |
model
- Valores
lite,pro
prompt
- Valores
- Obrigatório, não vazio, até 8.000 caracteres
resolution
- Valores
2k,4k;liteaceita apenas2k
aspect_ratio
- Valores
1:1,4:3,3:4,16:9,9:16,3:2,2:3,adaptive
reference_images
- Valores
- Carregue ids ou URLs do DreamUtopia; 0–3 para
lite, 0–14 parapro
adaptive requer pelo menos uma imagem de referência. Omita reference_images para texto-para-imagem. resolution tem como padrão 2k e aspect_ratio como 1:1, então model + prompt é uma requisição válida.
Referências de mesclagem
Uma referência é imagem-para-imagem; duas ou mais é uma mistura multi-referência. Carregue cada arquivo primeiro e passe os ids em ordem.
-d '{
"model": "pro",
"prompt": "combine the two products on one studio table",
"resolution": "2k",
"aspect_ratio": "adaptive",
"reference_images": ["<upload_id>", "<upload_id>"]
}'Custo
Os créditos de imagem são fixos por tier. Os valores ativos estão em GET /v1/models sob image[].credits. Os créditos são cobrados quando a tarefa é criada e reembolsados se ela falhar.