🎉 Бесплатные генерации при первой покупке каждого пакета — до 20 Lite-видео + 20 Lite-изображений + 10 Medium-видео + 10 Pro-изображений + 2 Pro-видео.

Начать работу
DreamUtopia
ru

Вакансии и опрос

Обе конечные точки создания возвращают идентификатор задания. Одна конечная точка сообщает результат для любого типа медиа, поэтому агенту нужен только один шаблон опроса.

оболочка
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; кредиты были возвращены
    Терминал
    Да

Поля процентного прогресса нет. Опрашивайте `status`, пока он не станет терминальным.

credits_used — это сумма, списанная при создании задания. За неудачное задание средства возвращаются автоматически, но поле всё равно показывает исходное списание; бесплатная попытка показывает 0.

Цикл опроса

bash
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, действительный в течение семи дней. Если файл нужен дольше, скачайте и сохраните его.

© 2026 DreamUtopia. Все права защищены.