画像生成
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 | lite には 0~3 個、pro には 0~14 個の ID または DreamUtopia URL をアップロードしてください |
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
- 値
liteには 0~3 個、proには 0~14 個の ID または DreamUtopia URL をアップロードしてください
adaptive には少なくとも1枚の参照画像が必要です。テキストから画像を生成する場合は reference_images を省略してください。resolution のデフォルトは 2k、aspect_ratio のデフォルトは 1:1 なので、model + prompt だけで有効なリクエストになります。
参照をブレンドする
1枚の参照はimage-to-image、2枚以上はマルチリファレンスブレンドです。まず各ファイルをアップロードし、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 にあります。クレジットはジョブ作成時に課金され、失敗した場合は返金されます。