Как получить ключ API?

Зарегистрируйтесь в Cruxy и создайте ключ через вход с устройства, описанный в быстром старте: запросите код устройства, подтвердите его в браузере и опрашивайте эндпоинт до получения ключа. Ключи API выдаются из того же аккаунта, что и приложение, а API оплачивается за токен, отдельно от вашего тарифа.

Какую модель передавать?

Передавайте auto, если нет причины поступить иначе. Mira служит быстрым размером для коротких вызовов в больших объёмах, Vaani остаётся сбалансированным размером по умолчанию, а Kavi даёт глубокий размер для самых сложных задач. Модель за размером может меняться; id размера остаётся контрактом.

Есть ли у вас SDK?

Любой клиент OpenAI работает для chat completions и models, на любом языке, который вы уже используете. Для собственных маршрутов Cruxy документация показывает запрос в curl и в TypeScript с fetch.

Используются ли мои данные для обучения?

Ваши промпты и ответы не используются для обучения моделей ИИ без вашего явного отдельного согласия. Логи запросов хранят модель, число токенов, стоимость и время, и ничего из содержимого. Полное описание в политике конфиденциальности.

Разработчикам

Создавайте то, что будет дальше.

Один базовый URL, один ключ и три размера моделей за ним. OpenAI-совместимый API для чата, собственные маршруты Cruxy, когда нужны память, хранилища, файлы и evals, и CLI, который работает в вашем репозитории.

Начать бесплатно Читать быстрый старт

import OpenAI from 'openai';

const cruxy = new OpenAI({
  baseURL: 'https://api.cruxy.ai/v1',
  apiKey: process.env.CRUXY_API_KEY,
});

const res = await cruxy.chat.completions.create({
  model: 'auto',
  messages: [{ role: 'user', content: 'Summarize this ticket' }],
});

import os
from openai import OpenAI

cruxy = OpenAI(
    base_url="https://api.cruxy.ai/v1",
    api_key=os.environ["CRUXY_API_KEY"],
)

res = cruxy.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "Summarize this ticket"}],
)

curl https://api.cruxy.ai/v1/chat/completions \
  -H "Authorization: Bearer $CRUXY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto",
       "messages": [{"role": "user",
                     "content": "Summarize this ticket"}]}'

Response · chat.completion

{
  "id": "chatcmpl-8f3a1c2d",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Checkout fails on UPI when the cart
          holds a gift card. Steps to reproduce and
          a fix are below."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 212,
    "completion_tokens": 96,
    "total_tokens": 308
  }
}

Запрос настоящий. Ответ приведён для примера и сокращён до своей формы.

Базовый URL: api.cruxy.ai/v1
Модели: kavi · vaani · mira · auto
Стриминг: SSE в формате OpenAI, заканчивается [DONE]
Ошибки: Стабильный код у каждой

Платформа

Всё, на чём можно строить. Всё доступно, всё задокументировано.

Chat APIДоступноOpenAI-совместимые chat completions на трёх размерах моделей. Стриминг, вызов инструментов и reasoning_effort, который вы задаёте на каждый запрос.Руководство по чату Cruxy CodeДоступноАгент для программирования в вашем терминале. Читает вашу кодовую базу, правит файлы с diff перед каждым одобрением, запускает ваши тесты и открывает pull request.Подробнее о Cruxy Code Evals APIДоступноНаборы кейсов, которые задаёте вы, запуски, которые вы начинаете, результаты, которые вы читаете. Направьте фреймворк для оценки на OpenAI-совместимые маршруты или используйте маршруты evals напрямую.Справочник API Эмбеддинги, реранкинг и модерацияДоступноcruxy-embed превращает текст в векторы, cruxy-rerank упорядочивает кандидатов относительно запроса, а cruxy-guard классифицирует текст по категориям безопасности контента.Рецепты ДокументацияДоступноБыстрый старт, руководство по каждому маршруту, сборник рецептов с retrieval, циклами инструментов и стримингом в браузере, и полный справочник API.Читать документацию СтатусДоступноПроверки в реальном времени и инциденты, на собственном домене, чтобы вы могли проверить нас до того, как проверять свой код.Смотреть статус

Чат

Два маршрута, один набор моделей. Используйте тот, на котором уже говорит ваш клиент.

Руководство по чату

POST /v1/chat/completions

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

Направьте любой клиент OpenAI или фреймворк для оценки на https://api.cruxy.ai/v1 с вашим ключом Cruxy. Стандартные объекты chat.completion, SSE в формате OpenAI и конверт ошибок OpenAI со стабильным кодом Cruxy внутри.

temperature, top_p, max_tokens и reasoning_effort учитываются
Поля, которые шлюз не использует, игнорируются, а не отклоняются, так что фреймворк, который их отправляет, всё равно работает
Воспроизводимый запуск ваших сообщений и модели. Без памяти, без хранилищ, без файлов

POST /api/v1/chat

Чат Cruxy

Те же модели со всем, что есть в приложении Cruxy: вспоминание и запись памяти, хранилища и постоянные правила, файлы по id и usage.cost в каждом ответе.

memory: { recall, capture } на каждый запрос, правила включены или выключены, vault_id
usage.cost с уровнем, суммой и валютой в каждом ответе
cruxy.request_id, чтобы найти вызов в ваших логах и связать его с обратной связью

const stream = await cruxy.chat.completions.create({
  model: 'auto',
  stream: true,
  messages: [{ role: 'user', content: 'Draft the release note' }],
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}

stream = cruxy.chat.completions.create(
    model="auto",
    stream=True,
    messages=[{"role": "user", "content": "Draft the release note"}],
)

for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

curl -N https://api.cruxy.ai/v1/chat/completions \
  -H "Authorization: Bearer $CRUXY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto", "stream": true,
       "messages": [{"role": "user",
                     "content": "Draft the release note"}]}'

СТРИМИНГ

Установите stream в true, и ответ придёт как server-sent events в формате OpenAI: кадры chat.completion.chunk с дельтами содержимого или вызовов инструментов, затем [DONE].

Если апстрим падает посреди потока, поток завершается кадром ошибки вместо [DONE], так что ваш клиент отличит обрыв от завершения. Вызов инструментов работает на обоих маршрутах: отправьте функции, которые модель может вызвать, выполните те, что она вернёт, и передайте результаты обратно.

Руководство по вызову инструментов

API

Каждый маршрут, по одной строке. Пути такие, как их перечисляет справочник.

Полный справочник API

ГРУППАМАРШРУТЫЧТО ДЕЛАЕТДОКУМЕНТАЦИЯ

Чат

POST /v1/chat/completions
POST /api/v1/chat
POST /api/v1/tokens/count

OpenAI-совместимые chat completions, собственный чат Cruxy с памятью, хранилищами, правилами и файлами, и счётчик токенов.Руководство по чату

Модели

GET /v1/models
GET /api/v1/models

Каталог уровней, как список OpenAI или с собственными метаданными Cruxy: контекстное окно, цены, поддержка инструментов и настройки рассуждений по умолчанию.Справочник моделей

Вызов инструментов

"tools": [ ... ] on every chat route

Отправьте функции, которые модель может вызвать, выполните вызовы, которые она вернёт, и передайте результаты обратно.Руководство по вызову инструментов

Эмбеддинги и реранкинг

POST /api/v1/embeddings
POST /api/v1/rerank

Превращайте текст в векторы с cruxy-embed и упорядочивайте документы-кандидаты относительно запроса с cruxy-rerank.Руководство по эмбеддингам

Модерация

POST /api/v1/moderations

Классифицируйте текст по категориям безопасности контента с cruxy-guard и действуйте по булеву полю flagged.Руководство по модерации

Файлы

POST /api/v1/files
GET /api/v1/files/{id}/content

Загружайте, перечисляйте, скачивайте и удаляйте файлы, затем прикрепляйте их к запросам чата Cruxy по id.Справочник API

Evals

POST /api/v1/evals/suites
POST /api/v1/evals/suites/{id}/runs

Наборы кейсов, которые задаёте вы, запуски, которые вы начинаете, и результаты, которые вы читаете.Справочник API

Обратная связь

POST /api/v1/feedback

Сообщайте об исходе прошлого вызова по его request id: принятия, отклонения, оценки и результаты тестов.Руководство по обратной связи

Память, хранилища и правила

GET /api/v1/memories
POST /api/v1/vaults
PUT /api/v1/rules

Читайте и удаляйте воспоминания, управляйте хранилищами и их участниками и задавайте постоянные правила для аккаунта или хранилища.Справочник API

Лимиты и логи

GET /api/v1/limits
GET /api/v1/logs/{request_id}

Ваши лимиты на число запросов на ключ и на организацию и лог ваших запросов по request id.Справочник ошибок

Ключи и организация

POST /api/v1/device/code
GET /api/v1/org/members
POST /api/v1/workspaces

Вход с устройства для получения ключа, участники и приглашения вашей организации и рабочие пространства.Руководство по аутентификации

Эксплуатация

Лимиты, логи и ошибки, о которых можно рассуждать.

Справочник ошибок

Лимиты, которые можно прочитать

GET /api/v1/limits возвращает ваши лимиты на число запросов к чату на ключ и на организацию для каждого 60-секундного окна, а шлюз отправляет заголовки X-RateLimit. Лимита на токены в минуту нет.

Два вида 429

rate_limited означает, что запросы приходят слишком быстро; он снимается, как только вы замедлитесь. budget_exhausted означает потолок расходов, который одна повторная попытка не снимет.

Логи по request id

Каждый запрос логируется с моделью, числом токенов, стоимостью, временем и статусом, и без промпта и ответа. Прочитайте один через GET /api/v1/logs/{request_id}.

Ключи показываются один раз

Получите ключ через вход с устройства. Он показывается ровно один раз и хранится только как хеш. Секреты при хранении шифруются поле за полем с AES-256-GCM.

Доступно

Cruxy Code

Те же модели, в вашем терминале.

Планирует многошаговые изменения и показывает каждый diff до того, как вы его одобрите
По умолчанию спрашивает перед каждой правкой и каждой командой
Запускает вашу команду тестов, читает сбои и продолжает исправлять
cruxy rollback возвращает дерево к состоянию до любого хода
cruxy pr открывает pull request после одного одобрения

npm i -g @cruxy/cliПодробнее о Cruxy Code

~/web · Cruxy Code

$cruxy run "fix the failing tests in the auth module"
cruxy › fix the failing tests in the auth module
! cruxy wants to run tests: pnpm test (destructive)
  $ pnpm test
  in /home/dev/web
  [y] once · [a] always allow test runs of exactly `pnpm test` this session · [t] reject & instruct · [n] no: a
✗ tests failed · 2 of 42 failed · 3.1s · pnpm test
  ✗ signs a session token src/auth/session.test.ts:18
      expected  "ok"
      received  undefined
  ✗ rejects an expired token src/auth/session.test.ts:41
  why (inferred)  TOKEN_SECRET is not set in the test environment
✓ read_file      8ms  src/test/setup.ts
? cruxy wants to edit: src/test/setup.ts (mutate)

Настоящий сеанс, обрезанный. Вывод CLI настоящий; ответы модели приведены для примера.

Цены API

За токен, в USD. Без платы за подключение и без минимума.

Цены API полностью

Fast· Mira

Короткие вызовы в больших объёмах, где задержка и стоимость важнее всего.

ВВОД: $0.20 / 1M
ВЫВОД: $0.40 / 1M

Контекст: 64K
Макс. вывод: 2K

Balanced· Vaani

Повседневные вызовы: высокое качество при меньшей задержке и стоимости.

ВВОД: $0.65 / 1M
ВЫВОД: $1.30 / 1M

Контекст: 128K
Макс. вывод: 4K

Deep· Kavi

Самые сложные задачи: глубокие рассуждения и самый большой бюджет вывода.

ВВОД: $0.76 / 1M
ВЫВОД: $1.52 / 1M

Контекст: 256K
Макс. вывод: 8K

USD за 1M токенов, с учётом по каждому запросу. Цены API указаны без GST. Для аккаунтов с оплатой из Индии добавляется 18% GST (доступен вычет входного налога). С auto вы платите по ставке модели, которая обслужила вызов.

Вопросы

Полезно знать.

Модерация с любым ключомПроверяйте ввод с cruxy-guard до того, как он попадёт в чат. API модерации принимает любой ключ на любом тарифе.

Да, для чата и списка моделей. https://api.cruxy.ai/v1 обслуживает /v1/chat/completions и /v1/models в форматах OpenAI, так что существующие клиенты и фреймворки для оценки работают после смены базового URL и ключа. Остальной API, от файлов до evals, собственный у Cruxy и живёт под /api/v1.

Смените базовый URL. Оставьте свой код.

Начните бесплатно, платите за токен и читайте каждый лимит до того, как упрётесь в него.

Начать бесплатно Справочник API

Создавайте то, что будет дальше.

import OpenAI from 'openai'; const cruxy = new OpenAI({ baseURL: 'https://api.cruxy.ai/v1', apiKey: process.env.CRUXY_API_KEY, }); const res = await cruxy.chat.completions.create({ model: 'auto', messages: [{ role: 'user', content: 'Summarize this ticket' }], });

import os from openai import OpenAI cruxy = OpenAI( base_url="https://api.cruxy.ai/v1", api_key=os.environ["CRUXY_API_KEY"], ) res = cruxy.chat.completions.create( model="auto", messages=[{"role": "user", "content": "Summarize this ticket"}], )

curl https://api.cruxy.ai/v1/chat/completions \ -H "Authorization: Bearer $CRUXY_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "auto", "messages": [{"role": "user", "content": "Summarize this ticket"}]}'

{ "id": "chatcmpl-8f3a1c2d", "object": "chat.completion", "choices": [ { "index": 0, "message": { "role": "assistant", "content": "Checkout fails on UPI when the cart holds a gift card. Steps to reproduce and a fix are below." }, "finish_reason": "stop" } ], "usage": { "prompt_tokens": 212, "completion_tokens": 96, "total_tokens": 308 } }

const stream = await cruxy.chat.completions.create({ model: 'auto', stream: true, messages: [{ role: 'user', content: 'Draft the release note' }], }); for await (const chunk of stream) { process.stdout.write(chunk.choices[0]?.delta?.content ?? ''); }

stream = cruxy.chat.completions.create( model="auto", stream=True, messages=[{"role": "user", "content": "Draft the release note"}], ) for chunk in stream: print(chunk.choices[0].delta.content or "", end="")

curl -N https://api.cruxy.ai/v1/chat/completions \ -H "Authorization: Bearer $CRUXY_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "auto", "stream": true, "messages": [{"role": "user", "content": "Draft the release note"}]}'

$cruxy run "fix the failing tests in the auth module" cruxy › fix the failing tests in the auth module ! cruxy wants to run tests: pnpm test (destructive) $ pnpm test in /home/dev/web [y] once · [a] always allow test runs of exactly `pnpm test` this session · [t] reject & instruct · [n] no: a ✗ tests failed · 2 of 42 failed · 3.1s · pnpm test ✗ signs a session token src/auth/session.test.ts:18 expected "ok" received undefined ✗ rejects an expired token src/auth/session.test.ts:41 why (inferred) TOKEN_SECRET is not set in the test environment ✓ read_file 8ms src/test/setup.ts ? cruxy wants to edit: src/test/setup.ts (mutate)

Создавайте то, что будет дальше.

Всё, на чём можно строить. Всё доступно, всё задокументировано.

Два маршрута, один набор моделей. Используйте тот, на котором уже говорит ваш клиент.

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

Чат Cruxy

Каждый маршрут, по одной строке. Пути такие, как их перечисляет справочник.

Лимиты, логи и ошибки, о которых можно рассуждать.

Лимиты, которые можно прочитать

Два вида 429

Логи по request id

Ключи показываются один раз

Те же модели, в вашем терминале.

За токен, в USD. Без платы за подключение и без минимума.

Полезно знать.

Совместим ли API с OpenAI?

Как получить ключ API?

Какую модель передавать?

Есть ли у вас SDK?

Используются ли мои данные для обучения?

Смените базовый URL. Оставьте свой код.

Создавайте то, что будет дальше.

Всё, на чём можно строить. Всё доступно, всё задокументировано.

Два маршрута, один набор моделей. Используйте тот, на котором уже говорит ваш клиент.

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

Чат Cruxy

Каждый маршрут, по одной строке. Пути такие, как их перечисляет справочник.

Лимиты, логи и ошибки, о которых можно рассуждать.

Лимиты, которые можно прочитать

Два вида 429

Логи по request id

Ключи показываются один раз

Те же модели, в вашем терминале.

За токен, в USD. Без платы за подключение и без минимума.

Полезно знать.

Совместим ли API с OpenAI?

Как получить ключ API?

Какую модель передавать?

Есть ли у вас SDK?

Используются ли мои данные для обучения?

Смените базовый URL. Оставьте свой код.