🎉 각 팩 첫 구매 시 무료 생성 선물 — 최대 Lite 영상 20개 + Lite 이미지 20개 + Medium 영상 10개 + Pro 이미지 10개 + Pro 영상 2개.

시작하기
DreamUtopia
ko

채용 및 폴링

두 생성 엔드포인트 모두 작업 id를 반환합니다. 하나의 엔드포인트가 두 미디어 유형 모두에 대한 결과를 보고하므로, 에이전트는 하나의 폴링 패턴만 필요로 합니다.

shell
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초가 걸리고, 동영상은 몇 분이 걸릴 수 있습니다. 1초에 한 번보다 자주 폴링하지 마세요.

목록 및 복구

작업 ID를 분실한 경우 최근 작업을 나열하세요. 이 엔드포인트는 인증된 계정 범위로 제한되며 최신순으로 반환합니다.

shell
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 헤더를 보내세요:

shell
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은 7일 동안 유효한 서명된 URL입니다. 더 오래 보관해야 하는 경우 파일을 다운로드하여 저장하세요.

© 2026 DreamUtopia. 모든 권리 보유.