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

1. Получите ключ на главной — вход по email: на почту придёт одноразовая ссылка, пароль не нужен.

2. Поменяйте base_url в своём инструменте на Акилон, ключ оставьте как Bearer-токен.

3. Сделайте первый запрос на бесплатной модели — пополнение для этого не нужно.

4. Пополните баланс по СБП, когда понадобятся платные модели, — без подписок, списываем по факту с баланса.

Первый вызов бесплатный. Модели со слагом *-free (deepseek-v4-flash-free,

codestral-free) не тарифицируются:

100 запросов в сутки, карта не нужна — достаточно подтверждённой почты (её подтверждает та самая

ссылка для входа). Платная модель — тот же ключ и адрес, меняется только имя модели.

Доступность бесплатных моделей мы не гарантируем: их раздают независимые поставщики вычислений,

раздача может прекратиться в любой день. Подробнее — Бесплатно.

OpenAI-совместимо

`python

from openai import OpenAI

client = OpenAI(base_url="https://akilon.ru/v1", api_key="akilon_ВАШ_КЛЮЧ")

client.chat.completions.create(

model="deepseek-v4-flash-free",

messages=[{"role": "user", "content": "Привет"}])

Платная модель — тот же вызов с model="deepseek-v4-flash" (или любым id из GET /v1/models).

Anthropic-совместимо (Claude Code)

`bash

export ANTHROPIC_BASE_URL=https://akilon.ru

export ANTHROPIC_API_KEY=akilon_ВАШ_КЛЮЧ

claude

ANTHROPIC_BASE_URL — без /v1 на конце: путь /v1/messages CLI дописывает сам.

Ключ можно передать любым из двух способов — шлюз принимает оба:

ANTHROPIC_API_KEY — SDK отправит его заголовком x-api-key;
ANTHROPIC_AUTH_TOKEN — SDK отправит его заголовком Authorization: Bearer.

Если в окружении уже лежит ключ настоящего Anthropic, задайте переменные только для этого запуска

(ANTHROPIC_BASE_URL=… ANTHROPIC_API_KEY=… claude), иначе CLI может подхватить старый.

Проверка

`bash

curl https://akilon.ru/v1/chat/completions \

-H "Authorization: Bearer akilon_ВАШ_КЛЮЧ" \

-d '{"model":"deepseek-v4-flash-free","messages":[{"role":"user","content":"Привет"}]}'

Стриминг

Cursor и Claude Code стримят всегда, поэтому проверьте и этот путь.

OpenAI-формат — stream: true, ответ приходит чанками data: {…}, последний — data: [DONE]:

`bash

curl -N https://akilon.ru/v1/chat/completions \

-H "Authorization: Bearer akilon_ВАШ_КЛЮЧ" \

-H "content-type: application/json" \

-d '{"model":"deepseek-v4-flash-free","stream":true,"messages":[{"role":"user","content":"Расскажи про СБП"}]}'

`python

stream = client.chat.completions.create(

model="deepseek-v4-flash-free",

stream=True,

messages=[{"role": "user", "content": "Расскажи про СБП"}])

for chunk in stream:

print(chunk.choices[0].delta.content or "", end="", flush=True)

Anthropic-формат — те же события, что у Anthropic: message_start → content_block_start →

content_block_delta → content_block_stop → message_delta (в нём usage) → message_stop:

`bash

curl -N https://akilon.ru/v1/messages \

-H "x-api-key: akilon_ВАШ_КЛЮЧ" \

-H "content-type: application/json" \

-d '{"model":"deepseek-v4-flash-free","max_tokens":256,"stream":true,"messages":[{"role":"user","content":"Расскажи про СБП"}]}'

Списание за стриминговый запрос считается по фактическим токенам из финального чанка — так же, как

за обычный.

Что дальше

Каталог моделей — GET /v1/models. Состояние рельсов — GET /v1/models?health=1.

Что означает ответ с ошибкой и что с ним делать — Ошибки API.

Интеграции, цены, счёт для юрлиц — в полной документации.