Знакомый API. Премиальные модели.

1. Аутентификация

Все API-запросы должны содержать заголовок Authorization с префиксом Bearer и вашим ключом SacredGPT API. Создать ключ можно в личном кабинете после включения 2FA (TOTP).

Authorization: Bearer sg_live_9a8b7c6d5e4f3a2b1c0d

2. Список моделей (GET /v1/models)

Возвращает список всех активных кураторских моделей с их актуальными стабильными идентификаторами и параметрами контекста.

curl https://api.sacredgpt.ru/v1/models \
  -H "Authorization: Bearer $SACREDGPT_KEY"

3. Chat Completions (POST /v1/chat/completions)

Основной эндпоинт генерации ответа. Принимает список сообщений, имя модели и дополнительные параметры.

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    base_url="https://api.sacredgpt.ru/v1",
    api_key="sgpt_live_..."
)

response = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[
        {"role": "system", "content": "You are an expert software architect."},
        {"role": "user", "content": "Explain microservices transaction rollback patterns."}
    ]
)

print(response.choices[0].message.content)

TypeScript (OpenAI Node SDK)

import OpenAI from 'openai';

const openai = new OpenAI({
  baseURL: 'https://api.sacredgpt.ru/v1',
  apiKey: process.env.SACREDGPT_KEY,
});

const completion = await openai.chat.completions.create({
  model: 'claude-sonnet-5',
  messages: [{ role: 'user', content: 'Write a TypeScript generic utility type.' }],
});

console.log(completion.choices[0].message.content);

4. Потоковая передача (Streaming SSE)

Передайте stream: true для получения дельт ответа по протоколу Server-Sent Events (SSE).

const stream = await openai.chat.completions.create({
  model: 'deepseek-v4-pro',
  messages: [{ role: 'user', content: 'Stream prime numbers up to 100.' }],
  stream: true,
});

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

5. Tools / Вызов функций

Поддерживается стандартный формат tools со схемой JSON Schema. Модель возвращает tool_calls для выполнения вашем кодом.

6. Privacy-first маршрутизация

API-запросы по умолчанию используют запрет сбора данных и только маршруты с поддержкой Zero Data Retention. Дополнительный privacy-заголовок не требуется. Если выбранная модель не имеет подходящего маршрута, API вернёт ошибку model_unavailable.

curl https://api.sacredgpt.ru/v1/chat/completions \
  -H "Authorization: Bearer $SACREDGPT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"Sensitive calculation"}]}'

7. Кредиты и списания

1 кредит равен 1 ₽. Перед запросом SacredGPT резервирует верхнюю оценку стоимости, после ответа списывает фактическую стоимость по входным и выходным токенам, а остаток резерва возвращает. API использует отдельный пополняемый баланс; подписочные кредиты чата не расходуются.

8. Лимиты RPM, TPM и потоков

Каждый ключ имеет собственные лимиты запросов и токенов в минуту, числа одновременных потоков, а также необязательные дневной и месячный бюджеты. Текущие значения возвращаются в заголовках x-ratelimit-limit-*, x-ratelimit-remaining-* и x-ratelimit-reset-*.

9. Коды ошибок API