画像生成
共通カタログから画像生成に対応した Model ID を選び、画像を生成します。
画像を生成する前に、モデルカタログで、選択したモデルのインターフェース、対応サイズ、出力方法、課金単位を確認してください。
リクエストエンドポイント
互換性のある画像生成インターフェースに対応したモデルでは、次のエンドポイントを使用します。
POST https://api.vergora.ai/v1/images/generationsモデルが別のインターフェースを使用する場合は、このリクエストを流用せず、そのモデルのドキュメントに従ってください。
リクエスト例
{
"model": "YOUR_IMAGE_MODEL_ID",
"prompt": "朝の街を描いたシンプルなイラスト",
"size": "YOUR_SUPPORTED_SIZE"
}リクエストフィールド
| フィールド | 説明 |
|---|---|
model | 画像生成に対応した Model ID |
prompt | 被写体、シーン、構図、意図する仕上がりを記述します |
size | 選択したモデルが対応するサイズまたはアスペクト比 |
| その他のパラメーター | 枚数、品質、参照画像などのフィールドは、対応している場合にのみ使用します |
参照画像
既存の画像を編集したりスタイルを変えたりするモデルは、次のエンドポイントで 1 枚以上の参照画像を受け付けます。
POST https://api.vergora.ai/v1/images/edits参照画像の送信方法は 2 通りあります。モデルがどちらの方法に対応しているか、何枚まで受け付けるかは、モデルページに記載されています。
- ファイルとして送信する。
multipart/form-dataでリクエストを送信し、model、promptと一緒に、画像ファイルをimageフィールドに入れます。 - リンクまたはアップロード済みファイルとして送信する。
images配列を含む JSON を送信します。各要素には、公開リンク、POST /v1/uploadsが返すキー、またはdata:URI を指定します。
{
"model": "YOUR_IMAGE_MODEL_ID",
"prompt": "この写真を水彩画風にしてください",
"images": [
"https://cdn.example.com/photo.jpg",
"uploads/u42/20261112/0123…cdef.png"
]
}ファイルのアップロード方法と適用される制限については、動画生成の「参照ファイルをアップロードする」を参照してください。
結果を読み取る
モデルのインターフェースによって、結果には画像の URL、エンコードされた画像データ、またはタスクのステータスが含まれます。
- レスポンスのステータスと構造を確認します。
- インターフェースの定義に従って、画像またはタスクの識別子を読み取ります。
- タスクの識別子が返された場合は、そのインターフェースのドキュメントに記載されている方法でステータスを確認します。
- トラブルシューティングやコストの確認に備えて、リクエストまたはタスクの識別子を保存しておきます。
リクエストを送信しても、画像生成が完了したとは限りません。
画像を保存する
生成されたアセットは、ダウンロードするか、ご自身のストレージに保存してください。一時 URL の有効期間やアクセス要件は、実際のレスポンスによって異なります。結果の URL には機密性の高いアクセスパラメーターが含まれている場合があるため、共有する前に確認してください。
料金と再試行
画像リクエストは、枚数、サイズ、品質、またはその他の単位で課金される場合があります。モデルの料金とリクエストログの記録を基準にしてください。タイムアウトした場合は、画像を再生成する前に、既存のリクエストまたはタスクを確認してください。