画像の入力
画像に対応したモデルには、テキストと一緒に画像を、Base64でエンコードして渡せます。 画像を生成する場合は、画像生成を参照してください。
画像を指定する
Chat Completionsでは、content に type が image_url の要素を追加します。
url には、Base64でエンコードした画像を data:image/png;base64,... の形式(データURL)で指定します。
Shell
IMAGE=$(base64 < image.png | tr -d '\n')
curl https://ai-gateway.lolipop.jp/v1/chat/completions \
-H "Authorization: Bearer $AI_GATEWAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [
{
"role": "user",
"content": [
{ "type": "text", "text": "この画像には何が写っていますか。" },
{
"type": "image_url",
"image_url": { "url": "data:image/png;base64,'"$IMAGE"'" }
}
]
}
]
}'対応しているAPI
| API | 指定する形式 |
|---|---|
| Chat Completions | type が image_url の要素 |
| Responses | type が input_image の要素 |
| Messages | type が image のブロック(Base64のみ) |
制限事項
- リクエストボディの上限は10 MiBです。Base64でエンコードした画像も、この上限に含まれます。
urlにデータURLではなく画像のURLを指定すると、モデルによっては400が返ります。- 画像の入力に対応していないモデルでは、
400が返る場合があります。