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

Arkheon повторяет API OpenAI. Меняете base_url на https://arkheonchat.com/v1 и ключ — код продолжает работать, только теперь со всеми моделями и рублёвым счётом.

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

1. Зарегистрируйтесь и подтвердите email.
2. Пополните баланс на странице Тарифы.
3. Создайте ключ в кабинете. Ключ показывается один раз.

Копироватьfrom openai import OpenAI

client = OpenAI(base_url="https://arkheonchat.com/v1", api_key="ark_...")

resp = client.chat.completions.create(
    model="anthropic/claude-sonnet-4",
    messages=[{"role": "user", "content": "Проверь договор на риски"}],
)
print(resp.choices[0].message.content)

Ключи

Передавайте ключ в заголовке Authorization: Bearer ark_…. До 10 активных ключей на аккаунт, каждый можно отозвать в кабинете. Ключ даёт доступ только к API — не к кабинету и не к смене пароля.

POST /v1/chat/completions

Поддерживаются model, messages (текст, image_url, file), max_tokens / max_completion_tokens, temperature, top_p, stop, stream, tools, tool_choice, parallel_tool_calls, response_format, seed, presence_penalty, frequency_penalty, reasoning, modalities. Остальные поля игнорируются; n должен быть 1.

Ответ — стандартный объект OpenAI. Дополнительно в нём есть arkheon.credits_charged и arkheon.balance. Если max_tokens не указан, используется 2048; максимум — 16 384.

Поиск в интернете включается суффиксом :online у модели, например openai/gpt-4o-mini:online.

Модель auto подбирает модель под запрос сама: код, вычисления, анализ длинных документов, тексты или быстрый ответ. Если в кабинете включено «спрашивать перед дорогими моделями», API вместо вопроса берёт модель дешевле порога; передайте "arkheon": {"allow_expensive": true} в теле запроса, чтобы разрешить дорогую. Фактическая модель приходит в arkheon.model, причина выбора — в arkheon.auto.

Стриминг

"stream": true — ответ приходит как text/event-stream, последний чанк содержит usage, затем data: [DONE]. Работает с stream=True в SDK.

GET /v1/models

Список доступных моделей с ценой ответа в кредитах. Идентификаторы вида vendor/model. Ниже — самые дешёвые из 209.

Полный список — в ответе /v1/models или в выборе модели в чате.

Тарификация

Перед запросом на балансе резервируется оценка стоимости (учитывает max_tokens). После ответа списывается фактическая стоимость по данным провайдера, остаток резерва сразу возвращается. 1 кредит ≈ 1 ₽, минимальное списание — 1 кредит. Пустой ответ и ошибки провайдера не оплачиваются. Баланс: GET /v1/balance.

GET /v1/usage

Статистика по ключу, которым подписан запрос: ?days=30 (1–90). Ответ содержит total (запросы, токены, кредиты), by_day (плотный ряд по дням), by_model. Ключ видит только себя; вся картина по аккаунту — в кабинете.

curl https://arkheonchat.com/v1/usage?days=7 -H "Authorization: Bearer ark_..."

{"object":"usage","scope":"key","key":{"id":12,"name":"Бот поддержки","prefix":"ark_3f"},
 "period":{"from":"2026-08-27","to":"2026-09-02","days":7},
 "total":{"requests":418,"prompt_tokens":91230,"completion_tokens":40211,"cached_tokens":0,"credits":612},
 "by_day":[{"date":"2026-08-27","requests":51,"credits":80,...}],
 "by_model":[{"model":"openai/gpt-4o-mini","requests":390,"credits":402,...}]}

Ошибки и лимиты

Формат ошибок — как у OpenAI: {"error": {"message", "type", "code"}}.