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

시작하기
DreamUtopia
ko

업로드

생성은 모든 이미지 입력에 대해 업로드 ID를 받습니다. 한 번 업로드한 다음, 해당 ID가 존재하는 동안 필요한 만큼 많은 요청에서 재사용하세요.

shell
curl -sS -X POST https://api.dreamutopia.net/v1/uploads \
  -H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
  -F "file=@/path/to/photo.png"
response 201
{
  "id": "<upload_id>",
  "url": "<upload_url>",
  "expires_at": "2026-10-31T12:00:00Z"
}

규칙

  • file이라는 이름의 멀티파트 파트 하나.
  • JPEG, PNG 또는 WebP — 파일 바이트로 판단하며, 해당 part의 Content-Type으로 판단하지 않습니다.
  • 최대 30MB. 더 큰 요청은 객체가 저장되기 전에 거부됩니다.
  • 반환된 id는 불투명 핸들입니다. 불투명하게 취급하세요. 이는 업로드한 계정에만 작동합니다.
  • 서명된 url은 7일 동안 유효합니다. id를 사용하는 것이 좋습니다. 사용 시 재서명됩니다.

업로드를 사용하세요

생성의 미디어 필드에 id를 전달하세요:

image → image
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이 허용되지 않습니다. 어떤 생성에서도 참조되지 않는 업로드된 객체는 보존 기간이 지나면 제거되며, 사용된 객체는 해당 생성이 존재하는 동안 유지됩니다.

© 2026 DreamUtopia. 모든 권리 보유.