Изображения и документы

Выберите модель с поддержкой нужного типа входных данных Само наличие идентификатора в каталоге не означает поддержку изображений или PDF

Chat Completions

Передайте массив блоков content с текстом и изображением

{
  "model": "gpt-4.1-mini",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "Опиши изображение"},
      {
        "type": "image_url",
        "image_url": {
          "url": "https://raw.githubusercontent.com/github/explore/main/topics/python/python.png"
        }
      }
    ]
  }],
  "max_tokens": 256
}

Отправьте тело в POST /v1/chat/completions Изображение должно быть доступно по HTTPS без авторизации Если сервер не может скачать файл, передайте data URL: data:image/png;base64,...

Messages

Изображение задаётся отдельным блоком

{
  "type": "image",
  "source": {
    "type": "base64",
    "media_type": "image/png",
    "data": "<BASE64_IMAGE>"
  }
}

Замените <BASE64_IMAGE> содержимым файла в base64 без префикса data URL Добавьте блок в messages[].content вместе с текстовой инструкцией Полный пример находится в изображениях Messages

GenerateContent

В contents[].parts передайте inline_data

{
  "inline_data": {
    "mime_type": "image/png",
    "data": "<BASE64_IMAGE>"
  }
}

Несколько изображений

Добавьте отдельный блок для каждого файла в одном сообщении В текстовой инструкции укажите порядок и задачу сравнения Число файлов, размер и поддерживаемые типы зависят от модели и выбранного метода

PDF

В Messages модели с поддержкой документов принимают блок document

{
  "type": "document",
  "source": {
    "type": "base64",
    "media_type": "application/pdf",
    "data": "<BASE64_PDF>"
  }
}

Замените <BASE64_PDF> содержимым PDF Не переносите этот блок в другие форматы API без адаптации

Ошибки

Проверьте соответствие MIME-типа содержимому, корректность base64 и доступность URL Для Could not process image убедитесь, что файл не повреждён и имеет достаточное разрешение для задачи Не повторяйте неизменный запрос при ошибке входных данных

Стоимость

Изображения и документы могут учитываться как входные токены Расход зависит от модели, размера и способа обработки Не используйте единый фиксированный коэффициент для всех моделей

Vision, ошибки, стоимость