🎉 Gerações grátis na primeira compra de cada pacote — até 20 vídeos Lite + 20 imagens Lite + 10 vídeos Medium + 10 imagens Pro + 2 vídeos Pro.

Começar
DreamUtopia
pt

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.

shell
curl -sS -X POST https://api.dreamutopia.net/v1/uploads \
  -H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
  -F "file=@/path/to/photo.png"
response 201
{
  "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 id retornado é um identificador opaco. Trate-o como opaco; ele só funciona para a conta que o enviou.
  • O url assinado é válido por sete dias. Prefira o id: ele é reassinado quando usado.

Use o upload

Passe o id no campo media da geração:

imagem → imagem
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>"]}'
imagem → vídeo
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.

© 2026 DreamUtopia. Todos os direitos reservados.