API SacredGPT

SacredAI и Heretic через привычный OpenAI-совместимый API.

Подключай SacredAI или sacredai-heretic через привычный формат OpenAI. Меняются только Base URL и ключ.

https://sacredgpt.pro/v1OpenAI compatibleJSON · SSE · Tools

01 — Документация без стены текста

Первый запрос — за несколько минут

Base URL
https://sacredgpt.pro/v1
Основной методPOST /chat/completions
АвторизацияBearer sg_live_…
01Быстрый стартКлюч, переменная окружения и первый cURL
  1. Посмотри тарифыОкна 5 ч / 7 дней задаёт тариф чата. Это единицы квоты, не цена токена.
  2. Начни с бесплатных оконБесплатный SacredAI: 10 000 / 5 ч и 50 000 / 7 дней. У Heretic 10 запросов навсегда. Обычный ключ делит эти окна с чатом и браузерным Agent. Hosted Hermes — отдельная подписка со своей квотой; тариф чата для него не нужен.
  3. Включи 2FAСоздание ключа защищено одноразовым кодом.
  4. Выбери тариф, если окон не хватаетПлатный тариф чата даёт отдельные окна каждой модели. Разовых пополнений баланса нет.
  5. Создай и сохрани ключSACREDGPT_KEY=sg_live_…
  6. Отправь cURLИспользуй стабильный ID модели.
cURL
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.

Python
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)
TypeScript
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 вернёт асинхронный поток с дельтами ответа.

TypeScript
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ОшибкиКоды, которые стоит обработать в приложении
HTTPCodeЧто произошло
400invalid_requestНеверное тело запроса или параметры
401invalid_api_keyКлюч неверен, истёк или не имеет нужного scope
402insufficient_balanceНет активной квоты или окно модели исчерпано
429rate_limit_exceededПревышен RPM, TPM или лимит потоков
502provider_errorВременный сбой провайдера модели
503model_unavailableДля модели сейчас нет подходящего маршрута
Прямая линия

Нашёл баг? Покажи нам.

Опиши, что произошло и чего ты ожидал. Адрес страницы и браузер помогут быстрее воспроизвести проблему.