Документация API

Быстрый старт

Получите ключ в профиле, пополните баланс — и можно отправлять запросы.

curl https://aichathub.ru/v1/chat/completions \
  -H "Authorization: Bearer $AICHATHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Авторизация

Ключ передаётся в заголовке Authorization. Поддерживается и X-API-Key.

Примеры кода

Python (официальный SDK OpenAI)

from openai import OpenAI

client = OpenAI(
    api_key="sk-ach-…",
    base_url="https://aichathub.ru/v1",
)

r = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{"role": "user", "content": "Объясни рекурсию одним абзацем"}],
)
print(r.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-ach-…",
  baseURL: "https://aichathub.ru/v1",
});

const r = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-5",
  messages: [{ role: "user", content: "Привет!" }],
});
console.log(r.choices[0].message.content);

Стриминг

Передайте "stream": true — ответ придёт по частям в формате Server-Sent Events, как у OpenAI. Списание считается по фактически сгенерированным токенам.

stream = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{"role": "user", "content": "Посчитай до 10"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

Список моделей

Актуальный перечень с ценами — на странице цен API. Программно доступны два способа:

• GET /v1/models — формат OpenAI, нужен ключ
• GET /api/public/models — цены в рублях, без авторизации

curl https://aichathub.ru/api/public/models

Оплата и баланс

Оплата — по факту за токены, без абонентской платы. Списывается только то, что израсходовано: отдельно за отправленные токены («запрос») и отдельно за сгенерированные («ответ»).

В ответе без стриминга мы добавляем служебное поле — сколько списано и сколько осталось:

"x_aichathub": { "charged_rub": 0.0123, "balance_rub": 987.65 }

Юридическим лицам доступна оплата по счёту с закрывающими документами — напишите в поддержку.

Ошибки

Формат ошибок совпадает с OpenAI, поэтому обработка в SDK работает без изменений.

Ограничения

• API работает с текстовыми моделями. Генерация изображений, видео и музыки доступна в приложении.
• До 5 активных ключей на аккаунт.
• Запросы обрабатываются на серверах провайдеров моделей за пределами РФ — учитывайте это при работе с персональными данными.