アップロード
生成は、任意の画像入力に対してアップロード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という名前のマルチパートパートが1つあります。- JPEG、PNG、WebP のいずれであるかは、パートの Content-Type ではなくファイルのバイト列によって判定します。
- 最大30 MB。より大きなリクエストは、オブジェクトが保存される前に拒否されます。
- 返された
idは不透明なハンドルです。不透明なものとして扱ってください。これはアップロードしたアカウントでのみ機能します。 - 署名済みの
urlは7日間有効です。idを優先してください。使用時に再署名されます。
アップロードを使用する
生成のmediaフィールドに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 は使用できません。どの生成物からも参照されていないアップロード済みオブジェクトは保持期間の経過後に削除されますが、使用済みのオブジェクトはその生成物が存在する限り保持されます。