Документация · Chat Completions

Chat Completions

Диалог с моделью в формате OpenAI Chat Completions.

POST/v1/chat/completions

Полный ответ приходит одним запросом, а с stream: true — по частям (см. Стриминг). Фонового режима в Chat Completions нет, как и у OpenAI: для него используйте Responses API.

completion = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[
        {"role": "system", "content": "Отвечай кратко."},
        {"role": "user", "content": "Чем отличается TCP от UDP?"},
    ],
    max_tokens=500,
)
print(completion.choices[0].message.content)

Тело запроса

modelstringобязательный: id из /v1/models.
messagesobject[]обязательный: Роли system, developer, user, assistant. content — строка или массив частей {"type": "text"}.
max_tokensinteger: Предел длины ответа. То же, что max_completion_tokens. По умолчанию 4096.
temperaturenumber: От 0 до 1, большее значение приводится к 1.
reasoning_effortstring: low, medium, high у моделей с рассуждением.
streamboolean: Отдавать ответ по частям.
stream_options.include_usageboolean: Прислать перед [DONE] чанк с usage.

{
  "id": "chatcmpl-6f1c2a0e-…",
  "object": "chat.completion",
  "created": 1791899327,
  "model": "gpt-5.4-mini",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "TCP гарантирует доставку…", "refusal": null },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 24, "completion_tokens": 118, "total_tokens": 142 }
}

Получить ответ ещё раз

GET/v1/chat/completions/{id}

Ответы хранятся, как stored completions у OpenAI: готовый ответ можно получить по его id.

Устаревший Completions

POST/v1/completions

Для старых программ: prompt вместо messages, ответ — text_completion с choices[].text. Поддерживаются max_tokens, temperature и stream.

НазадСписок моделей ДальшеResponses