Envios
Uma geração aceita um id de upload para qualquer entrada de imagem. Faça o upload uma vez e depois reutilize o id em quantas requisições precisar enquanto ele existir.
curl -sS -X POST https://api.dreamutopia.net/v1/uploads \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
-F "file=@/path/to/photo.png"{
"id": "<upload_id>",
"url": "<upload_url>",
"expires_at": "2026-10-31T12:00:00Z"
}Regras
- Uma parte multipart chamada
file. - JPEG, PNG ou WebP, decidido pelos bytes do arquivo — não pelo Content-Type da parte.
- Máximo de 30 MB. Solicitações maiores são recusadas antes que o objeto seja armazenado.
- O
idretornado é um identificador opaco. Trate-o como opaco; ele só funciona para a conta que o enviou. - O
urlassinado é válido por sete dias. Prefira oid: ele é reassinado quando usado.
Use o upload
Passe o id no campo media da geração:
curl -sS -X POST https://api.dreamutopia.net/v1/images/generations \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"lite","prompt":"the same scene in watercolor","resolution":"2k","aspect_ratio":"adaptive","reference_images":["<upload_id>"]}'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","image":"<upload_id>","resolution":"720p","duration":8}'Encadeamento e limpeza
O result.url de uma geração concluída pode ser usado em qualquer lugar onde um id de upload é aceito, então um job pode alimentar o próximo. URLs externas não são aceitas para referências de imagem. Um objeto enviado que nenhuma geração referencia é removido após a janela de retenção; um usado é mantido enquanto sua geração existir.