ym88659208ym87991671
Работа с OpenAI-запросами | Документация для разработчиков
Развернуть

Работа с OpenAI-запросами

Обновлено 7 сентября 2026

Вы можете передавать в модели GigaChat запросы в формате OpenAI. Такая возможность помогает проверять и адаптировать работу различных решений, использующих формат, к работе с моделями GigaChat.

Для работы с OpenAI-запросами используйте метод POST /openai/v1/chat/completions. Полученые запросы преобразуются в формат POST /v2/chat/completions и передаются в модель. Метод возвращает ответ в формате OpenAI chat.completion.

Описание формата запросов и ответов — в официальной документации OpenAI . Официальный формат ответа может отличаться от реализации в GigaChat API B2Bank.

Для работы с методом нужно получить доступ .

В этом разделе вы найдете примеры запросов, демонстрирующих основные сценарии работы с моделями.

Примеры запросов

Генерация текста

Наряду с обычной поддерживается генерация в режиме потоковой передачи токенов.

curl -X POST 'https://gigachat-ift.sberdevices.delta.sbrf.ru/openai/v1/chat/completions' \
  --cert <сертификат>.pem \
  --key <ключ>.key \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "GigaChat-3-Ultra",
    "messages": [
      {"role": "system", "content": "Ты — краткий помощник."},
      {"role": "user", "content": "Объясни, что такое OAuth, двумя предложениями."}
    ],
    "stream": false,
    "max_completion_tokens": 256,
    "temperature": 0.7
  }'

Распознавание изображений

Кроме изображений, сохраненных в хранилище, файлы можно передавать напрямую в запросе.

curl -X POST 'https://gigachat-ift.sberdevices.delta.sbrf.ru/openai/v1/chat/completions' \
  --cert <сертификат>.pem \
  --key <ключ>.key \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "GigaChat-3-Ultra",
    "messages": [
      {"role": "user", "content": [
        {"type": "text", "text": "Что на картинке?"},
        {"type": "file", "file": {"file_id": "<идентификатор_из_хранилища>"}}
      ]}
    ],
    "stream": false
  }'

Работа с функциями

Генерация параметров для собственных функций

С помощью метода можно генерировать аргументы для собственных функций или использовать их в контексте истории сообщений.

curl -X POST 'https://gigachat-ift.sberdevices.delta.sbrf.ru/openai/v1/chat/completions' \
  --cert <сертификат>.pem \
  --key <ключ>.key \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "GigaChat-3-Ultra",
    "messages": [
      {"role": "user", "content": "Какая погода в Москве?"}
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_weather",
          "description": "Получить текущую погоду в городе",
          "parameters": {
            "type": "object",
            "properties": {
              "city": {"type": "string", "description": "Название города"}
            },
            "required": ["city"]
          }
        }
      }
    ],
    "tool_choice": "auto",
    "stream": false
  }'

Вызов встроенных функций

Встроенные функции, например, создание изображений, можно вызывать в отдельном сообщении или в контексте истории сообщений. Поддерживаются встроенные функции, которые можно использовать в запросе POST /v2/chat/completions.

curl -X POST 'https://gigachat-ift.sberdevices.delta.sbrf.ru/openai/v1/chat/completions' \
  --cert <сертификат>.pem \
  --key <ключ>.key \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "GigaChat-3-Ultra",
  "stream": false,
  "messages": [
    { "role": "user", "content": "Нарисуй красного дракона на скале на закате" }
  ],
  "tools": [
    { "type": "image_generate" }
  ],
  "tool_choice": "auto"
}'
Заметили ошибку?
Выделите текст и нажмите
Ctrl
+
Enter
, чтобы сообщить нам об ошибке
Подключить API
Развернуть