SacredAI и Heretic через привычный OpenAI-совместимый API.
Подключай SacredAI или sacredai-heretic через привычный формат OpenAI. Меняются только Base URL и ключ.
01 — Документация без стены текста
Первый запрос — за несколько минут
https://sacredgpt.pro/v101Быстрый стартКлюч, переменная окружения и первый cURL
- Посмотри тарифыОкна 5 ч / 7 дней задаёт тариф чата. Это единицы квоты, не цена токена.
- Начни с бесплатных оконБесплатный SacredAI: 10 000 / 5 ч и 50 000 / 7 дней. У Heretic 10 запросов навсегда. Обычный ключ делит эти окна с чатом и браузерным Agent. Hosted Hermes — отдельная подписка со своей квотой; тариф чата для него не нужен.
- Включи 2FAСоздание ключа защищено одноразовым кодом.
- Выбери тариф, если окон не хватаетПлатный тариф чата даёт отдельные окна каждой модели. Разовых пополнений баланса нет.
- Создай и сохрани ключ
SACREDGPT_KEY=sg_live_… - Отправь cURLИспользуй стабильный ID модели.
curl https://sacredgpt.pro/v1/chat/completions \
-H "Authorization: Bearer $SACREDGPT_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sacredai-heretic",
"messages": [{"role": "user", "content": "Привет!"}]
}'02OpenAI SDK и список моделейPython · TypeScript · GET /v1/models
Официальные SDK OpenAI работают без адаптера. Укажи Base URL SacredGPT и свой ключ; доступные стабильные ID возвращает GET /v1/models.
from openai import OpenAI
client = OpenAI(
base_url="https://sacredgpt.pro/v1",
api_key="sg_live_...",
)
response = client.chat.completions.create(
model="sacredai-heretic",
messages=[{"role": "user", "content": "Привет!"}],
)
print(response.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://sacredgpt.pro/v1",
apiKey: process.env.SACREDGPT_KEY,
});
const response = await client.chat.completions.create({
model: "sacredai-heretic",
messages: [{ role: "user", content: "Привет!" }],
});
console.log(response.choices[0].message.content);GET /v1/models — модели, доступные конкретному ключу, и их контекстное окно.
| Имя модели | Model ID |
|---|---|
| SacredAI | sacredgpt-auto |
| SacredAI Heretic | sacredai-heretic |
03StreamingОтвет частями через Server-Sent Events
Добавь stream: true. SDK вернёт асинхронный поток с дельтами ответа.
const stream = await client.chat.completions.create({
model: "sacredai-heretic",
messages: [{ role: "user", content: "Объясни этот код" }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}04Tools & Structured OutputФункции и ответы по JSON Schema
- Передавай tools и tool_choice в формате OpenAI; вызванные функции возвращаются в tool_calls.
- Для структурированного ответа используй response_format. Поддержка зависит от текущего маршрута Heretic.
- SacredGPT не выполняет функции за тебя: tool_calls обрабатывает твой код и отправляет результат обратно модели.
05Приватность APIХранение зависит от текущего маршрута Heretic
Содержимое API-запросов не добавляется в историю чатов; сохраняются только технические данные для расчётов, лимитов и безопасности. К запросу Heretic применяются условия хранения текущего провайдера.
06Квоты и лимитыОкна аккаунта, бюджеты ключа, RPM и TPM
- Обычный Public API делит окна модели с чатом: бесплатный SacredAI и 10 запросов Heretic навсегда, затем окна активного платного тарифа. Цена токена в рублях не применяется.
- Если лимит закончился, доступ вернётся, когда окно 5 часов или 7 дней обновится. Больше запросов даёт платный тариф чата.
- В текущем интерфейсе задаются дневной и месячный бюджеты. RPM, TPM и число потоков ограничиваются сервером; расширенная настройка пока недоступна в кабинете.
- GET /v1/usage со scope usage:read возвращает расход этого API-ключа и отдельно помеченный общий статус Heretic аккаунта. Управляемые ключи Hermes общий статус владельца не получают.
- Для sacredai-heretic точная последняя пользовательская команда /usage или heretic usage в Chat Completions возвращает общий статус без вызова модели, расхода квоты и списания. Локальная команда клиента с таким именем может перехватить ввод до HTTP — сервер не может это переопределить; используй GET /v1/usage как надёжный вариант.
GET /v1/usage · x-ratelimit-limit-* · x-ratelimit-remaining-* · x-ratelimit-reset-*
07ОшибкиКоды, которые стоит обработать в приложении
| HTTP | Code | Что произошло |
|---|---|---|
| 400 | invalid_request | Неверное тело запроса или параметры |
| 401 | invalid_api_key | Ключ неверен, истёк или не имеет нужного scope |
| 402 | insufficient_balance | Нет активной квоты или окно модели исчерпано |
| 429 | rate_limit_exceeded | Превышен RPM, TPM или лимит потоков |
| 502 | provider_error | Временный сбой провайдера модели |
| 503 | model_unavailable | Для модели сейчас нет подходящего маршрута |
Нашёл баг? Покажи нам.
Опиши, что произошло и чего ты ожидал. Адрес страницы и браузер помогут быстрее воспроизвести проблему.
