Chat Completions

В разработке

Главный эндпоинт генерации. Совместим с OpenAI Chat Completions API — можно использовать любую OpenAI-совместимую библиотеку, просто подменив base_url и api_key.

Endpoint

http

POST https://api.aiproxypay.ru/v1/chat/completions

Запрос

json

{
  "model": "openai/gpt-4o-mini",
  "messages": [
    {"role": "system", "content": "Ты — лаконичный ассистент."},
    {"role": "user",   "content": "Объясни, что такое HTTP/3."}
  ],
  "temperature": 0.7,
  "max_tokens": 512,
  "stream": false
}

Параметры

Поле	Тип	Описание
model	string	Идентификатор модели, например `anthropic/claude-3-5-sonnet`.
messages	array	История диалога. Каждое сообщение — `{role, content}`.
temperature	number	0…2, по умолчанию 1.
max_tokens	integer	Лимит длины ответа.
stream	boolean	Включает SSE-стриминг чанков. По умолчанию `false`.

Ответ

json

{
  "id": "chatcmpl_a1b2c3",
  "object": "chat.completion",
  "created": 1716120000,
  "model": "openai/gpt-4o-mini",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "HTTP/3 — это третья основная версия протокола HTTP…"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 128,
    "total_tokens": 160,
    "aip_tokens": 160
  }
}

Поле usage.aip_tokens — сколько списано с вашего баланса. Курс зависит от модели и тарифицируется как 1 токен модели = 1 токен AIPROXYPAY для базовых моделей, выше — для продвинутых.

Стриминг

При stream: true ответ отдаётся как Server-Sent Events. Каждый чанк — JSON в формате OpenAI.

bash

curl https://api.aiproxypay.ru/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"openai/gpt-4o-mini","messages":[{"role":"user","content":"Считай до 5"}],"stream":true}'