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

OpenAI-совместимый API к моделям **OpenAI**, **Claude**, **Gemini**, **DeepSeek**, **Kimi**, для Claude — ещё и формат Anthropic (Claude Code). Оплата — кредитами подписки Aijora.

- **Адрес (Base URL):** `https://www.aijora.ru/api/v1`
- **Авторизация:** заголовок `Authorization: Bearer sk-aijora-…` (или `x-api-key: sk-aijora-…`)
- **Форматы:** Chat Completions (`POST /chat/completions`, все модели), Responses (`POST /responses`, GPT, Kimi, DeepSeek) и Anthropic Messages (`POST /messages`, Claude); обычный и потоковый ответ (`stream: true`), вызов функций (tools).
- **Ключ** создаётся на https://www.aijora.ru/vibecoding или в личном кабинете https://www.aijora.ru/account/api-keys. Нужна активная подписка Aijora.

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

```bash
curl https://www.aijora.ru/api/v1/chat/completions \
  -H "Authorization: Bearer $AIJORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6-sol", "messages": [{"role": "user", "content": "Напиши функцию сортировки на Python"}]}'
```

## Ключи

Один ключ открывает все модели: модель выбирается полем `model` в запросе. При создании ключ можно ограничить одним брендом — например, чтобы отдать его подрядчику или агенту.

| Ключ | Модели |
|---|---|
| Все модели | `gpt-6-astra`, `gpt-6.1-sol`, `gpt-6-sol`, `claude-opus-5.5`, `claude-sonnet-5.5`, `claude-haiku-5.5`, `claude-opus-5`, `gemini-4-argon`, `gemini-3.1-pro`, `gemini-3.8-flash`, `deepseek-v4.1-flash`, `kimi-k3.1-pro` |
| Только OpenAI | `gpt-6-astra`, `gpt-6.1-sol`, `gpt-6-sol` |
| Только Claude | `claude-opus-5.5`, `claude-sonnet-5.5`, `claude-haiku-5.5`, `claude-opus-5` |
| Только Gemini | `gemini-4-argon`, `gemini-3.1-pro`, `gemini-3.8-flash` |
| Только DeepSeek | `deepseek-v4.1-flash` |
| Только Kimi | `kimi-k3.1-pro` |

Ключ с ограничением на модель другого бренда вернёт **403** `model_not_allowed_for_key`.

Список моделей, доступных ключу: `GET /models` с этим ключом.

## Эндпоинты

| Метод | Путь | Что делает |
|---|---|---|
| POST | `/chat/completions` | Ответ модели в формате OpenAI Chat Completions |
| POST | `/responses` | Ответ модели в формате OpenAI Responses (так работает Codex): GPT, Kimi, DeepSeek |
| POST | `/messages` | Ответ Claude в формате Anthropic Messages (Claude Code, SDK Anthropic) |
| GET | `/models` | Список моделей |

## Claude Code и SDK Anthropic

> **Временно недоступно.** Claude Code временно работает нестабильно: у провайдера сбоят вызовы инструментов. Обычные запросы к Claude через API работают.

Модели Claude (`claude-opus-5.5`, `claude-sonnet-5.5`, `claude-haiku-5.5`, `claude-opus-5`) доступны и в формате Anthropic Messages: `POST https://www.aijora.ru/api/v1/messages` — с потоком SSE, tools, картинками, кэшем (`cache_control`) и рассуждениями (`thinking`).

Claude Code (переменные окружения или блок `env` в `~/.claude/settings.json`):

```bash
export ANTHROPIC_BASE_URL="https://www.aijora.ru/api"        # без /v1: Claude Code сам допишет /v1/messages
export ANTHROPIC_AUTH_TOKEN="sk-aijora-…"            # уходит как Authorization: Bearer
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1   # без телеметрии на серверы Anthropic
```

Модель выбирается командой `/model`: id Anthropic (`claude-sonnet-5-5`, `claude-opus-5-5`, `claude-haiku-5-5` и старые версии вроде `claude-sonnet-4-6`) ведут на актуальную модель того же семейства по её цене.

SDK Anthropic (Python):

```python
from anthropic import Anthropic

client = Anthropic(base_url="https://www.aijora.ru/api", api_key="sk-aijora-…")
r = client.messages.create(model="claude-sonnet-5.5", max_tokens=1024, messages=[{"role": "user", "content": "Привет!"}])
print(r.content[0].text)
```

Ошибки `/messages` приходят в формате Anthropic: `{"type": "error", "error": {"type", "message"}}`.

## Python (официальная библиотека openai)

```python
from openai import OpenAI

client = OpenAI(base_url="https://www.aijora.ru/api/v1", api_key="sk-aijora-…")

# Chat Completions
r = client.chat.completions.create(
    model="kimi-k3.1-pro",
    messages=[{"role": "user", "content": "Объясни, что делает этот код: …"}],
)
print(r.choices[0].message.content)

# Responses
r = client.responses.create(model="gpt-6-sol", input="Придумай название для кофейни")
print(r.output_text)
```

## JavaScript / Node.js

```js
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://www.aijora.ru/api/v1", apiKey: process.env.AIJORA_API_KEY });

const stream = await client.chat.completions.create({
  model: "gpt-6-sol",
  messages: [{ role: "user", content: "Расскажи анекдот про программистов" }],
  stream: true,
});
for await (const chunk of stream) process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
```

## Потоковый ответ

Передайте `"stream": true`. Chat Completions присылает события `data: {chat.completion.chunk}` и в конце `data: [DONE]`. Чтобы получить расход токенов в потоке, добавьте `"stream_options": {"include_usage": true}`. Responses присылает события `response.output_text.delta` и финальное `response.completed` с полем `usage`.

## Вызов функций (tools)

Передайте `tools` в формате OpenAI (`{"type": "function", "function": {"name", "description", "parameters"}}` для Chat Completions). Модель вернёт `tool_calls` (`finish_reason: "tool_calls"`); результат функции отправьте следующим сообщением с `role: "tool"` и `tool_call_id`.

## Модели и цены

Цена в кредитах Aijora за 1 млн токенов. Повторяющееся начало запроса (кэш) считается по сниженной цене. У Claude запись в кэш стоит ×1,25 от цены входа.

| id модели | Бренд | Описание | Эндпоинты | Вход | Вход из кэша | Выход |
|---|---|---|---|---|---|---|
| `gpt-6-astra` | OpenAI | GPT-6 Astra — Самая сильная, сложные задачи | `/chat/completions`, `/responses` | 281 кредит | 28 кредитов | 1 405 кредитов |
| `gpt-6.1-sol` | OpenAI | GPT-6.1 Sol — Новое поколение Sol | `/chat/completions`, `/responses` | 60 кредитов | 3 кредита | 301 кредит |
| `gpt-6-sol` | OpenAI | GPT-6 Sol — Баланс качества и цены | `/chat/completions`, `/responses` | 60 кредитов | 6 кредитов | 301 кредит |
| `claude-opus-5.5` | Claude | Claude Opus 5.5 — Сложный код и архитектура | `/chat/completions`, `/messages` | 161 кредит | 16 кредитов | 803 кредита |
| `claude-sonnet-5.5` | Claude | Claude Sonnet 5.5 — Основная модель Claude Code | `/chat/completions`, `/messages` | 80 кредитов | 8 кредитов | 401 кредит |
| `claude-haiku-5.5` | Claude | Claude Haiku 5.5 — Быстрые правки и подагенты | `/chat/completions`, `/messages` | 6 кредитов | 0,6 кредита | 30 кредитов |
| `claude-opus-5` | Claude | Claude Opus 5 — Предыдущий Opus | `/chat/completions`, `/messages` | 201 кредит | 20 кредитов | 1 003 кредита |
| `gemini-4-argon` | Gemini | Gemini 4 Argon — Самая сильная Gemini | `/chat/completions` | 80 кредитов | 80 кредитов | 401 кредит |
| `gemini-3.1-pro` | Gemini | Gemini 3.1 Pro — Рассуждения и длинный контекст | `/chat/completions` | 50 кредитов | 50 кредитов | 351 кредит |
| `gemini-3.8-flash` | Gemini | Gemini 3.8 Flash — Быстрая и недорогая | `/chat/completions` | 23 кредита | 23 кредита | 113 кредитов |
| `deepseek-v4.1-flash` | DeepSeek | DeepSeek V4.1 Flash — Самая доступная, хороша в коде | `/chat/completions`, `/responses` | 12 кредитов | 0,3 кредита | 48 кредитов |
| `kimi-k3.1-pro` | Kimi | Kimi K3.1 Pro — Контекст до 1 млн токенов, сильна в коде | `/chat/completions`, `/responses` | 80 кредитов | 8 кредитов | 401 кредит |

## Списание

Списание идёт после ответа модели, по фактическому числу токенов, с общего баланса кредитов подписки. Расход по каждому ключу виден в личном кабинете. На ключ можно поставить лимит в кредитах — за день, неделю, месяц или без сброса.

## Ошибки

Ошибки приходят в формате OpenAI: `{"error": {"code", "message", "type"}}`.

| Код | code | Что значит | Что делать |
|---|---|---|---|
| 400 | `model_not_found` | Неизвестная модель | Возьмите id из таблицы моделей |
| 400 | `unsupported_endpoint` | Модель не работает через этот эндпоинт (например, Claude и Gemini — не через `/responses`) | Смотрите колонку «Эндпоинты» в таблице моделей |
| 401 | `invalid_api_key` | Нет ключа или ключ неверный | Проверьте заголовок Authorization |
| 402 | `insufficient_credits` / `key_budget_exceeded` / `no_subscription` | Закончились кредиты, лимит ключа или нет подписки | Пополните баланс или поднимите лимит ключа |
| 403 | `model_not_allowed_for_key` | Ключ ограничен другим брендом | Создайте ключ «Все модели» |
| 403 | `key_disabled` | Ключ выключен | Включите его в личном кабинете |
| 503 | `upstream_error` | Модель временно недоступна | Повторите запрос через минуту |
| 503 | `model_unavailable` | Модель временно отключена (сейчас: Claude Fable 5) | Выберите другую модель из таблицы |

## Безопасность

- Полный ключ показывается один раз, при создании. Храните его в переменных окружения, не в коде и не в репозитории.
- Если ключ попал в чужие руки — выключите или удалите его в личном кабинете: он перестанет работать сразу.
