概要
gemini-3-pro-imageモデル（nanobana）を使用して、テキストから画像を生成します。Vertex AI互換のgenerateContentインターフェースを介して、テキストプロンプトに基づく画像を生成します。
APIの詳細
制約
- 呼び出し元にはAPI Keyが必要です。詳細については、AI API Keyを管理するを参照してください。
リクエストパス
POST {BASE_URL}/api/v1/publishers/googleVertexAI/models/gemini-3-pro-image:generateContent
Request header
Name |
Required |
Example value |
Description |
|---|---|---|---|
| Authorization | Yes | Bearer {token} | Authentication information |
| Content-Type | Yes | application/json | Request body format |
リクエストヘッダー
名前 |
必須 |
例 |
説明 |
|---|---|---|---|
| Authorization | はい | Bearer {token} | 認証情報 |
| Content-Type | はい | application/json | リクエストボディの形式 |
リクエストパラメータ
パスパラメータ
名前 |
型 |
必須 |
例 |
説明 |
|---|---|---|---|---|
| なし | このAPIにはパスパラメータはありません。 |
クエリパラメータ
名前 |
型 |
必須 |
例 |
説明 |
|---|---|---|---|---|
| なし | このAPIにはクエリパラメータはありません。 |
ボディ
名前 |
型 |
必須 |
例 |
説明 |
|---|---|---|---|---|
| contents | array[object] | はい | 対話内容 | |
| contents[].role | string | はい | user | ロール。user固定です。 |
| contents[].parts | array[object] | はい | コンテンツパーツ | |
| contents[].parts[].text | string | はい | Generate an image of a red apple on a white table | テキストから画像を生成するためのプロンプト |
| generationConfig | object | はい | 生成設定 | |
| generationConfig.maxOutputTokens | integer | はい | 8192 | 出力Tokenの最大数 |
| generationConfig.responseModalities | array[string] | はい | ["TEXT", "IMAGE"] | レスポンスモダリティ。TEXTとIMAGEの両方を含める必要があります。 |
レスポンス
生成されたテキストと画像のコンテンツを含む、標準のVertex AI generateContentレスポンスを返します。
レスポンス例
curl -sS -X POST "${BASE_URL}/api/v1/publishers/googleVertexAI/models/gemini-3-pro-image:generateContent" \
-H "Authorization: Bearer ${API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Generate an image of a red apple on a white table"
}
]
}
],
"generationConfig": {
"maxOutputTokens": 8192,
"responseModalities": ["TEXT", "IMAGE"]
}
}'
レスポンス例
エラーレスポンス
{
"error": {
"message": "error message",
"type": "error_type",
"code": "error_code"
}
}