채용 및 폴링
두 생성 엔드포인트 모두 작업 id를 반환합니다. 하나의 엔드포인트가 두 미디어 유형 모두에 대한 결과를 보고하므로, 에이전트는 하나의 폴링 패턴만 필요로 합니다.
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
done3~5초에서 시작하여 10초로 늘리세요. 일반적인 이미지는 10~40초가 걸리고, 동영상은 몇 분이 걸릴 수 있습니다. 1초에 한 번보다 자주 폴링하지 마세요.
목록 및 복구
작업 ID를 분실한 경우 최근 작업을 나열하세요. 이 엔드포인트는 인증된 계정 범위로 제한되며 최신순으로 반환합니다.
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은 7일 동안 유효한 서명된 URL입니다. 더 오래 보관해야 하는 경우 파일을 다운로드하여 저장하세요.