Вакансии и опрос
Обе конечные точки создания возвращают идентификатор задания. Одна конечная точка сообщает результат для любого типа медиа, поэтому агенту нужен только один шаблон опроса.
curl -sS https://api.dreamutopia.net/v1/generations/$MID \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY"{
"id": "3f2b…",
"type": "video",
"status": "succeeded",
"model": "medium",
"credits_used": 13,
"created_at": "2026-10-24T12:00:00Z",
"updated_at": "2026-10-24T12:02:10Z",
"result": { "url": "<result_url>" },
"error": null
}Статусы
| статус | Значение | Терминал |
|---|---|---|
| queued | Принято, ожидание запуска | Нет |
| processing | Генерация выполняется | Нет |
| succeeded | result.url готов | Да |
| failed | error.code — internal; кредиты были возвращены | Да |
queued
- Значение
- Принято, ожидание запуска
- Терминал
- Нет
processing
- Значение
- Генерация выполняется
- Терминал
- Нет
succeeded
- Значение
result.urlготов- Терминал
- Да
failed
- Значение
error.code—internal; кредиты были возвращены- Терминал
- Да
Поля процентного прогресса нет. Опрашивайте `status`, пока он не станет терминальным.
credits_used — это сумма, списанная при создании задания. За неудачное задание средства возвращаются автоматически, но поле всё равно показывает исходное списание; бесплатная попытка показывает 0.
Цикл опроса
MID="3f2b…"
while :; do
BODY=$(curl -sS "https://api.dreamutopia.net/v1/generations/$MID" \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY")
case "$(jq -r .status <<<"$BODY")" in
succeeded) jq -r .result.url <<<"$BODY"; break ;;
failed) jq -r .error.message <<<"$BODY" >&2; exit 1 ;;
*) sleep 4 ;;
esac
doneНачните с 3–5 секунд и увеличьте интервал до 10. Обычное изображение обрабатывается 10–40 секунд; видео может занять несколько минут. Не опрашивайте чаще одного раза в секунду.
Размещение и восстановление
Если идентификатор задания потерян, выведите список последних заданий. Конечная точка ограничена аутентифицированной учётной записью и возвращает результаты в порядке от новых к старым.
curl -sS "https://api.dreamutopia.net/v1/generations?type=video&limit=20" \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY"type — это image, video, all или не указан для обоих. limit — от 1 до 50. Передайте next_cursor обратно как cursor для следующей страницы.
Повторные попытки и идемпотентность
Создание списывает кредиты, поэтому повторная попытка не должна создавать вторую задачу. Отправьте заголовок Idempotency-Key с уникальным значением для каждого логического запроса:
curl -sS -X POST https://api.dreamutopia.net/v1/images/generations \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: my-request-0001" \
-d '{"model":"lite","prompt":"a red fox","resolution":"2k","aspect_ratio":"1:1"}'- Первый вызов возвращает
202. - Повторная попытка с тем же ключом и телом возвращает
200и существующее задание; повторного списания нет. - Повторное использование ключа с другим телом запроса или пока первый вызов ещё выполняется возвращает
409.
Время жизни результата
result.url — это подписанный URL, действительный в течение семи дней. Если файл нужен дольше, скачайте и сохраните его.