Skip to main content
POST

Авторизация

string
обязательно
##Все API требуют аутентификации Bearer Token##Получение API-ключа:Откройте страницу управления API-ключами, чтобы получить ваш API-ключДобавьте в заголовок запроса:

Body

string
по умолчанию:"gpt-5.2-pro"
обязательно
Название моделиПоддерживаемые модели:
  • gpt-5.2-pro
  • gpt-5.2-codex
  • qwen3.8-max
  • Скоро будут добавлены новые модели…
array
обязательно
Список входных данныхВходной массив, каждый элемент содержит поля role и content.💡 Быстрое заполнение (область «Try it»):
  1. Нажмите «+ Add an item», чтобы добавить элемент ввода
  2. В поле role введите: user (сообщение пользователя), assistant (ответ AI) или system (системная подсказка)
  3. В поле content добавьте блоки контента (могут включать текст и изображения)
number
Управляет случайностью вывода, диапазон 0–2
  • Меньшие значения (например, 0.2) делают вывод более детерминированным
  • Большие значения (например, 1.8) делают вывод более случайным
По умолчанию: 1.0
integer
Максимальное количество генерируемых токеновУ разных моделей разные максимальные лимиты, обратитесь к документации конкретной модели
boolean
Использовать ли потоковый вывод
  • true: потоковый ответ (формат SSE)
  • false: вернуть полный ответ за один раз
По умолчанию: false
number
Параметр ядровой выборки (nucleus sampling), диапазон 0–1Управляет разнообразием генерируемого текста, рекомендуется использовать его как альтернативу temperatureПо умолчанию: 1.0
array
Список инструментов для расширения возможностей моделиПоддерживаемые типы инструментов:
  • Веб-поиск (web_search): поиск актуальной информации в интернете
  • Поиск по файлам (file_search): поиск по содержимому загруженных файлов
  • Function Calling (function): вызов пользовательских функций
  • Удалённый MCP (remote_mcp): подключение к удалённым сервисам Model Context Protocol
Пример: [{"type": "web_search"}]

Response

string
Уникальный идентификатор ответа
string
Тип объекта, фиксированное значение response
integer
Временная метка создания
string
Фактически использованное название модели
array
Список сгенерированных ответов
object
Статистика использования токенов

Примеры использования

Только текстовый ввод

Использование инструмента веб-поиска

cURL Example

Понимание изображений

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

Изображение в кодировке Base64

Использование инструмента поиска по файлам

Использование Function Calling

Использование удалённого MCP

Комбинирование нескольких инструментов

Спецификации типов контента

input_text

Тип текстового ввода Свойства:
  • type: фиксированное значение "input_text"
  • text: текстовое содержимое (строка)

input_image

Тип ввода изображения Свойства:
  • type: фиксированное значение "input_image"
  • image_url: URL изображения или Base64-кодированный data URI
Поддерживаемые форматы изображений:
  • JPEG
  • PNG
  • GIF
  • WebP
Ограничения размера изображения:
  • Максимальный размер файла: 20 МБ
  • Рекомендуемое разрешение: не более 2048x2048 пикселей

Подробности использования инструментов

Веб-поиск

Инструмент веб-поиска позволяет модели получать актуальную информацию из интернета. Пример конфигурации:
Сценарии использования:
  • Запрос последних новостей и текущих событий
  • Получение данных в реальном времени (акции, погода, курсы валют и т. д.)
  • Поиск актуальной технической документации
  • Проверка фактической информации

Поиск по файлам

Инструмент поиска по файлам позволяет модели искать релевантную информацию в загруженных документах. Пример конфигурации:
Сценарии использования:
  • Анализ внутрикорпоративных документов
  • Поиск по техническим спецификациям и руководствам
  • Запросы по договорам и юридическим документам
  • Системы вопросов и ответов на базе знаний

Function Calling

Определение пользовательских функций позволяет модели вызывать внешние API или выполнять конкретные операции. Полный пример конфигурации:
Описание параметров:
  • name: имя функции (обязательно)
  • description: описание функции (обязательно)
  • parameters: определение параметров в формате JSON Schema
    • type: тип параметра
    • properties: определения свойств параметров
    • required: список обязательных параметров
Сценарии использования:
  • Вызов сторонних API
  • Выполнение запросов к базе данных
  • Запуск бизнес-процессов
  • Интеграция с внутренними системами

Удалённый MCP

Подключение к удалённым сервисам Model Context Protocol (MCP) для расширения возможностей модели. Пример конфигурации:
Описание параметров:
  • url: адрес MCP-сервера (обязательно)
  • auth_token: токен аутентификации (необязательно)
  • timeout: таймаут в секундах, по умолчанию 30 секунд
Сценарии использования:
  • Подключение к корпоративным AI-сервисам
  • Использование специализированных моделей
  • Доступ к защищённым источникам данных
  • Интеграция с распределёнными AI-системами

Формат ответа при использовании инструментов

Когда модель использует инструменты, формат ответа будет содержать информацию о вызове инструментов:
Рабочий процесс вызова инструмента:
  1. Модель получает пользовательский ввод
  2. Анализирует, нужны ли инструменты
  3. При необходимости возвращает запрос на вызов инструмента
  4. Клиент выполняет вызов инструмента
  5. Возвращает результаты инструмента модели
  6. Модель формирует окончательный ответ

Важные замечания

  1. Требования к URL изображений:
    • Должен быть публично доступным URL
    • Или использовать формат Base64-кодированного Data URI
  2. Тарификация токенов:
    • Изображения расходуют токены в зависимости от их разрешения
    • Изображения с высоким разрешением автоматически уменьшаются для оптимизации стоимости
    • Вызовы инструментов также потребляют дополнительные токены
  3. Порядок контента:
    • Порядок элементов в массиве content влияет на понимание моделью
    • Рекомендуется сначала располагать текстовые инструкции, затем изображения
  4. Мультимодальные комбинации:
    • В одном запросе можно смешивать несколько текстов и изображений
    • Поддерживаются многошаговые диалоги с сохранением контекста
  5. Ограничения использования инструментов:
    • При одновременном использовании нескольких инструментов модель интеллектуально выбирает наиболее подходящий
    • Function calling требует чёткого определения функций и описания параметров
    • Результаты веб-поиска могут быть ограничены регионом и временем
  6. Совместимость API:
    • Полная совместимость с форматом OpenAI Responses API
    • Бесшовная миграция существующего кода OpenAI
    • Поддержка всех функций расширения инструментов OpenAI