概要
テキストから画像を生成するためにgpt-image-2モデルを使用します。テキストプロンプトに基づいて画像を生成し、生成結果を同時に返します。
APIの詳細
制約
- 呼び出し元にはAPI Keyが必要です。詳細については、AI API Keyを管理するを参照してください。
リクエストパス
POST {BASE_URL}/api/v1/images/generations
リクエストヘッダー
名前 |
必須 |
例 |
説明 |
|---|---|---|---|
| Authorization | はい | Bearer {token} | 認証情報 |
| Content-Type | はい | application/json | リクエストボディの形式 |
リクエストパラメータ
パスパラメータ
名前 |
型 |
必須 |
例 |
説明 |
|---|---|---|---|---|
| なし | このAPIにはパスパラメータはありません。 |
クエリパラメータ
名前 |
型 |
必須 |
例 |
説明 |
|---|---|---|---|---|
| なし | このAPIにはクエリパラメータはありません。 |
ボディ
名前 |
型 |
必須 |
例 |
説明 |
|---|---|---|---|---|
| model | string | はい | gpt-image-2 | モデル名。gpt-image-2固定です。 |
| prompt | string | はい | A simple red apple on a white table, photorealistic | 画像生成用のプロンプト |
| size | string | はい | 1024x1024 | 画像サイズ |
| n | integer | はい | 1 | 生成する画像の数 |
レスポンス
レスポンスパラメータ
名前 |
型 |
説明 |
|---|---|---|
| created | integer | 作成時刻のタイムスタンプ |
| data | array[object] | 生成された画像 |
| usage | object | 使用量情報 |
data
名前 |
型 |
説明 |
|---|---|---|
| url | string | 画像URL |
| b64_json | string | Base64エンコードされた画像データ |
| revised_prompt | string | 修正後のプロンプト |
リクエスト例
curl -sS -X POST "${BASE_URL}/api/v1/images/generations" \
-H "Authorization: Bearer ${API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A simple red apple on a white table, photorealistic",
"size": "1024x1024",
"n": 1
}'
レスポンス例
成功レスポンス（200）
{
"created": 1780000000,
"data": [
{
"url": "https://...",
"b64_json": "...",
"revised_prompt": "..."
}
],
"usage": {}
}
エラーレスポンス
{
"error": {
"message": "error message",
"type": "error_type",
"code": "error_code"
}
}