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