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

Три шага до первого ответа

1. Войдите в кабинет

   На странице регистрации одно нажатие создаёт аккаунт и выдаёт API-ключ для подключения приложений. Вход в кабинет — по логину и паролю.sk-ai-host-… Сохраните API-ключ: второй раз полный ключ не показывается.

2. Положите ключ в переменную окружения

   Не вставляйте ключ в исходный код — он попадёт в git и утечёт.

   export AI_HOST_KEY="sk-ai-host-..."
3. Отправьте запрос

   Модель выберите в каталоге: скорость, контекст и качество рядом.

Подключение к инструментам

Один адрес — разные протоколы. Codex, Claude Code, редакторы и свой код подключаются по-разному, поэтому ниже готовые конфиги: скопировали, подставили ключ, заработало.

model = "fast-chat"
model_provider = "aihost"

[model_providers.aihost]
name = "AI-HOST"
base_url = "https://ai-host.xyz/v1"
env_key = "AI_HOST_KEY"
wire_api = "responses"

export AI_HOST_KEY="sk-ai-host-..."

codex "объясни этот проект"

Ключ в заголовке

Все защищённые методы принимают ключ в Authorization. Ключ действует, пока вы его не отзовёте: срок жизни не ограничен.

Запрос к модели

Поддерживается всё, что вы ждёте от OpenAI-совместимого API: stream, tools,temperature, response_format.

curl https://ai-host.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-ai-host-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fast-chat",
    "messages": [{"role": "user", "content": "Привет!"}],
    "max_tokens": 200
  }'

Тело запроса

Как считается стоимость

Списываются токены запроса и ответа — отдельно, по своей цене за миллион. Списание идёт сначала с пакетов токенов (они оплачены заранее), затем с баланса. Перед запросом мы проверяем, хватит ли средств на самый дорогой вариант (max_tokens включён): запрос на 2 ₽ при балансе в 1 ₽ вернёт 402, а не уведёт счёт в минус.

Повторы без двойной оплаты

Если приложение повторяет запрос при таймауте — передайте заголовок Idempotency-Key с уникальным значением (UUID). Повтор с тем же значением вернёт сохранённый ответ и не спишет деньги второй раз.

curl https://ai-host.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-ai-host-..." \
  -H "Idempotency-Key: 8f14e45f-ceea-467f-a4b5-1c2d3e4f5a6b" \
  -H "Content-Type: application/json" \
  -d '{"model":"fast-chat","messages":[{"role":"user","content":"Привет"}]}'

Ответ по частям

С stream: true ответ приходит как Server-Sent Events: строки data: {...} и завершающая data: [DONE]. Так пользователь видит текст с первого токена, а не ждёт весь ответ.

stream = client.chat.completions.create(
    model="fast-chat",
    messages=[{"role": "user", "content": "Расскажи про Python"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

Что значит код ответа

Тело ошибки всегда JSON вида {"error":{"message":"…","type":"…","code":"…"}} — можно показывать пользователю message и не разбирать текст.

Частота и квота

• Частота — запросов в минуту. Считается с резервированием слота: параллельные запросы не пробивают лимит.
• Квота тарифа — токенов за период. Видна в кабинете полоской.
• Суточный лимит — если включён, токены за календарные сутки.