Documentation
API Reference
[ POST ] Chat Completion - Запрос к модели

[ POST ] Chat Completion - Запрос к модели

POST /chat/completions

Генерирует ответ модели на основе переданного диалога.

Заголовки

  • Authorization: Bearer YOUR_API_KEY — ваш API-ключ
  • Content-Type: application/json

Параметры запроса

ПараметрТипОбязательныйОписание
modelstringДаID модели
messagesarrayДаМассив сообщений
temperaturenumberНетКреативность ответов (0.0-2.0)
max_tokensnumberНетМаксимальная длина ответа
streambooleanНетПотоковый режим ответа
functionsarrayНетОписание доступных функций
function_callstringНетПринудительный вызов функции
nnumberНетКоличество вариантов ответа
presence_penaltynumberНетШтраф за повторение тем (-2.0 до 2.0)
frequency_penaltynumberНетШтраф за повторение слов (-2.0 до 2.0)
top_pnumberНетNucleus sampling (0.0-1.0)
userstringНетID пользователя для логирования

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

{
  "model": "gemini-2.5-flash",
  "messages": [
    {
      "role": "system",
      "content": "Ты - эксперт Python"
    },
    {
      "role": "user",
      "content": "Как создать виртуальное окружение?"
    }
  ],
  "temperature": 0.7,
  "max_tokens": 150
}

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

{
  "choices": [
    {
      "message": {
        "content": "Для создания виртуального окружения используйте команду:\n\npython -m venv myenv",
        "role": "assistant"
      },
      "finish_reason": "stop",
      "index": 0
    }
  ],
  "created": 1692913639,
  "model": "gemini-2.5-flash",
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 15,
    "total_tokens": 35
  }
}

Статус-коды

  • 200 [OK]
  • 400 [Bad Request]
  • 401 [Unauthorized]
  • 403 [Forbidden]
  • 429 [Too Many Requests]
  • 500 [Internal Server Error]
[ GET ] List of models - Список моделей