Дата обновления: 2026-06-06

Vision via Chat

POST /v1/chat/completions

В продакшене Crazyrouter проверена работа image_url в стиле OpenAI на основных визуальных моделях:

gpt-4o, gpt-4o-mini, gpt-4.1, gpt-5.5 и другие визуальные модели OpenAI
Поддерживаются как data URL data:image/...;base64,..., так и публичные https:// URL
message.content сейчас возвращается обычной строкой

Рекомендуемый порядок: для локальных файлов сначала вызывайте эндпоинт загрузки изображений, чтобы получить временный URL media.crazyrouter.com, затем передавайте его в image_url; либо сразу отправляйте base64 data URL. Удалённые публичные URL тоже работают, но должны удовлетворять условиям ниже.

Через base64 data URL (самый надёжный путь)

curl https://api.crazyrouter.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "What color is this image?"},
          {
            "type": "image_url",
            "image_url": {
              "url": "data:image/png;base64,iVBORw0KGgoAAA..."
            }
          }
        ]
      }
    ],
    "max_tokens": 100
  }'

Пример ответа:

{
  "model": "gpt-4o-mini",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Red."
      }
    }
  ]
}

Через удалённый https URL

curl https://api.crazyrouter.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "Describe in 5 words."},
          {
            "type": "image_url",
            "image_url": {
              "url": "https://www.gstatic.com/webp/gallery/1.jpg"
            }
          }
        ]
      }
    ],
    "max_tokens": 40
  }'

Ограничения удалённых URL

URL должен быть доступен с серверов Crazyrouter, а не просто открываться в браузере. Типичные причины ошибок:

Сбой	Причина	Решение
Домен не резолвится	Приватный/некорректный адрес	Использовать публичный https URL
403 Forbidden	Некоторые CDN (wikimedia, приватные S3) блокируют серверный UA или требуют Referer	Использовать эндпоинт загрузки или base64
Content-Type не `image/*`	URL возвращает HTML или редирект на страницу логина	Убедиться, что это прямая ссылка на изображение
Файл больше 20MB	Лимит на размер одного файла	Сжать или обрезать

Если видите ошибку Unable to process the image you provided. Please verify the image URL is publicly accessible, or upload it as base64., значит URL недоступен серверу — пройдитесь по таблице выше.

Рекомендуемый подход

Для внутренних ассетов, приватных и непроверенных по доступности изображений: сначала вызовите POST /v1/files/uploads и получите 72-часовой URL media.crazyrouter.com/..., затем передайте его в image_url
Для маленьких (< 1MB) и одноразовых изображений: отправляйте base64 data URL напрямую, экономя один лишний запрос
Несколько изображений, параметр detail и другие продвинутые опции: апстрим OpenAI это поддерживает, передавайте по официальной спецификации OpenAI