画像・動画 API
統一エンドポイントを通じて、OpenAI 互換の画像形式で画像と動画を生成。
エンドポイント
画像生成と動画生成は単一のエンドポイントを共有します。プロンプトを POST リクエストで送信するだけで、ゲートウェイが最適な上流アカウントにルーティングします。
Endpoint
POST https://YOUR-BASE-URL/v1/images/generations画像生成
テキスト記述から画像を生成します。リクエストは OpenAI images/generations 形式に従います。Flux Pro、DALL·E 3、Stable Diffusion 3 などを同一エンドポイントで利用可能。
model をモデルプラザの画像モデル ID に設定します。レスポンスには生成された画像 URL が 1 つ以上含まれます。
curl
curl https://YOUR-BASE-URL/v1/images/generations \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-pro",
"prompt": "A serene mountain lake at sunrise, photorealistic",
"n": 1,
"size": "1024x1024"
}'画像編集
マスクと新しいプロンプトを指定して既存の画像を編集します。画像、マスク、プロンプトの各フィールドを含む multipart/form-data リクエストを送信してください。
インペインティングに対応するモデルのみ編集を受け付けます。編集対応モデルについてはモデルプラザをご確認ください。
curl
curl https://YOUR-BASE-URL/v1/images/edits \
-H "Authorization: Bearer sk-your-api-key" \
-F "image=@./input.png" \
-F "mask=@./mask.png" \
-F "prompt=Replace the background with a futuristic cityscape" \
-F "n=1" \
-F "size=1024x1024"動画生成
テキストまたは画像プロンプトから短尺動画を生成します。同じエンドポイントと同じ認証が動画モデルでも機能します。動画生成の計算コストのため、応答時間は長くなります。
動画サポートは急速に拡張中です。最新の動画モデルはモデルプラザでご確認ください。
curl
curl https://YOUR-BASE-URL/v1/images/generations \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2",
"prompt": "A cinematic aerial view of a futuristic city at night",
"n": 1,
"size": "1920x1080"
}'使用量と課金
画像・動画リクエストは、モデルプラザに表示されるレートで生成ごとに課金されます。画像サイズ、品質（hd/standard）、リクエスト枚数がトークンコストに影響します。
使用量はテキスト補完とともにダッシュボードで追跡され、ゲートウェイ全体のアクティビティを一元的に確認できます。