Загрузки
Генерация принимает upload id для любого изображения на входе. Загрузите один раз, затем повторно используйте этот id в стольких запросах, сколько вам нужно, пока он существует.
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"
}Правила
- Одна составная часть с именем
file. - JPEG, PNG или WebP — определяется по байтам файла, а не по Content-Type части.
- Максимум 30 МБ. Более крупные запросы отклоняются до сохранения объекта.
- Возвращённый
id— это непрозрачный дескриптор. Рассматривайте его как непрозрачный; он работает только для аккаунта, который его загрузил. - Подписанный
urlдействителен в течение семи дней. Предпочтительнее использоватьid: он переподписывается при использовании.
Используйте загрузку
Передайте id в поле media генерации:
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}'Цепочки и очистка
result.url завершённой генерации можно использовать везде, где принимается id загрузки, поэтому одна задача может питать следующую. Внешние URL не принимаются для ссылок на изображения. Загруженный объект, на который не ссылается ни одна генерация, удаляется по истечении срока хранения; использованный хранится столько, сколько существует его генерация.