Vision — изображения в запросах
Передайте изображение вместе с текстовым запросом в /v1/chat/completions — модель опишет содержимое, ответит на вопрос по картинке или проанализирует скриншот. Поддерживаются URL и base64.
Поддерживаемые модели
| Параметр | Тип | Описание |
|---|---|---|
claude-opus-4.8 / claude-sonnet-4.6 | Claude | Полная поддержка vision — URL и base64. |
gpt-5.5 | GPT | URL и base64. Лучше всего для анализа документов и схем. |
Изображение должно быть публично доступно по URL — или передано в base64. Приватные URL (S3 с подписью, внутренние сети) передавайте через base64.
Формат запроса
Поле content заменяется массивом блоков: text и image_url.
curl https://plusvibeapi.ru/v1/chat/completions \
-H "Authorization: Bearer $PLUSVIBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-4.8",
"max_tokens": 256,
"messages": [{
"role": "user",
"content": [
{"type": "text", "text": "Что изображено на картинке? Опиши кратко."},
{"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}
]
}]
}'Base64 — без публичного URL
Для приватных изображений закодируйте файл в base64 и передайте как data URL:
# base64 — для приватных изображений без публичного URL
curl https://plusvibeapi.ru/v1/chat/completions \
-H "Authorization: Bearer $PLUSVIBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"max_tokens": 256,
"messages": [{
"role": "user",
"content": [
{"type": "text", "text": "Что на картинке?"},
{"type": "image_url", "image_url": {"url": "data:image/jpeg;base64,/9j/4AAQ..."}}
]
}]
}'Параметры image_url
| Параметр | Тип | Описание |
|---|---|---|
urlобяз. | string | Публичный URL изображения или data:image/jpeg;base64,… для base64. |
detail | "auto" | "low" | "high" | Детализация анализа (только GPT). "auto" — по умолчанию. "high" — больше токенов, лучше качество. |