이미지 생성
POST /v1/images/generations는 이미지 작업을 생성하고 즉시 반환합니다. 결과를 얻으려면 공유 작업 엔드포인트를 폴링하세요.
curl -sS -X POST https://api.dreamutopia.net/v1/images/generations \
-H "Authorization: Bearer $DREAMUTOPIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "pro",
"prompt": "a red fox in fresh snow, cinematic lighting",
"resolution": "2k",
"aspect_ratio": "16:9"
}'{ "id": "3f2b…", "type": "image", "status": "queued", "created_at": "2026-10-24T12:00:00Z" }필드
| Field | 값 |
|---|---|
| model | lite, pro |
| prompt | 필수, 비어 있지 않음, 최대 8,000자 |
| resolution | 2k, 4k; lite는 2k만 허용합니다 |
| aspect_ratio | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, adaptive |
| reference_images | ID 또는 DreamUtopia URL을 업로드하세요; lite의 경우 0–3, pro의 경우 0–14 |
model
- 값
lite,pro
prompt
- 값
- 필수, 비어 있지 않음, 최대 8,000자
resolution
- 값
2k,4k;lite는2k만 허용합니다
aspect_ratio
- 값
1:1,4:3,3:4,16:9,9:16,3:2,2:3,adaptive
reference_images
- 값
- ID 또는 DreamUtopia URL을 업로드하세요;
lite의 경우 0–3,pro의 경우 0–14
adaptive에는 최소 하나의 참조 이미지가 필요합니다. 텍스트-투-이미지의 경우 reference_images를 생략하세요. resolution의 기본값은 2k이고 aspect_ratio의 기본값은 1:1이므로, model + prompt만으로도 유효한 요청입니다.
참조 블렌딩
하나의 레퍼런스는 이미지 대 이미지이고, 둘 이상은 멀티 레퍼런스 블렌드입니다. 먼저 각 파일을 업로드하고 id를 순서대로 전달하세요.
-d '{
"model": "pro",
"prompt": "combine the two products on one studio table",
"resolution": "2k",
"aspect_ratio": "adaptive",
"reference_images": ["<upload_id>", "<upload_id>"]
}'비용
이미지 크레딧은 티어별로 정액입니다. 실시간 값은 GET /v1/models의 image[].credits 아래에 있습니다. 크레딧은 작업이 생성될 때 청구되며 실패하면 환불됩니다.