Подключение за один адрес

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

Базовый адрес для OpenAI-совместимых клиентов:

Для Anthropic SDK укажите базовый адрес без /v1 — SDK добавит его сам:

Ключ выдаётся после активации токена и начинается с tg_. Он показывается один раз.

Активация токена

После оплаты вы получаете одноразовый токен act_…. Откройте страницу активации, вставьте токен и укажите e-mail, если он не был привязан заранее.

1. Один токен создаёт ровно один API-ключ tg_….
2. Ключ наследует лимит токенов, записанный в токене активации.
3. Повторно активировать тот же токен нельзя.
4. После активации ключ сразу работает через API и открывает кабинет.

Если у вас уже есть API-ключ tg_…, вставьте его на странице активации — откроется кабинет с остатком и расходом.

Авторизация

Передавайте ключ одним из способов:

# OpenAI-совместимые клиенты
Authorization: Bearer tg_...

# Anthropic SDK и клиенты с x-api-key
x-api-key: tg_...

Ключ привязан к одному аккаунту покупателя и имеет собственный лимит токенов. Не публикуйте его в репозиториях и чатах.

Эндпоинты

OpenAI SDK

Установите SDK и замените base_url на адрес шлюза.

pip install openai

from openai import OpenAI

client = OpenAI(
    base_url="https://kateshopik.ru/v1",
    api_key="tg_...",
)

response = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Привет"}],
)

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

Тот же ключ работает в Cursor, Cline, Roo Code, Continue, Chatbox и других клиентах с настройкой OpenAI-совместимого API.

Anthropic SDK

pip install anthropic

from anthropic import Anthropic

client = Anthropic(
    base_url="https://kateshopik.ru",
    api_key="tg_...",
)

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Привет"}],
)

print(message.content[0].text)

Если клиент не передаёт anthropic-version, добавьте заголовок anthropic-version: 2023-06-01 вручную.

Responses API

response = client.responses.create(
    model="gpt-6.1-sol",
    input="Объясни, что такое токен, в двух предложениях.",
)

print(response.output_text)

Ответы в формате Responses поддерживаются и в потоковом режиме. Usage берётся из события response.completed.

Стриминг

Передайте "stream": true как обычно. Шлюз поддерживает SSE для Chat Completions, Responses и Anthropic Messages.

stream = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Напиши короткий план"}],
    stream=True,
)

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

Учёт токенов

Лимит ключа измеряется в базовых токенах. Списание за успешный ответ:

Для моделей Claude кэшированный вход считается с коэффициентом 0.1. Для остальных моделей кэш не уменьшает списание. Вход и выход стоят одинаково.

Шлюз читает usage из ответа upstream. Если upstream вернул ошибку, токены не списываются. При исчерпании лимита следующий запрос получает 402 и не уходит наверх.

В ответах шлюза есть служебные заголовки:

Лимиты

• Размер запроса — до 8 МиБ.
• Ответ upstream — до 4096 токенов за один запрос.
• До 90 запросов в минуту с одного IP на стороне upstream.
• До 5 изображений по 5 МБ на вход. Генерации изображений нет.
• Лимит ключа задаётся в базовых токенах и не имеет дневного сброса.

Ошибки

Шлюз возвращает ошибки в формате OpenAI. Для /v1/messages — в формате Anthropic.

{
  "error": {
    "message": "Лимит токенов исчерпан.",
    "type": "insufficient_quota",
    "code": "insufficient_quota"
  }
}

Модели

Все модели используют общий лимит ключа. Множитель указан относительно базового токена.

Актуальный список также доступен через GET /v1/models с вашим ключом.

Правила использования

• Ключ предназначен для ваших проектов и команды. Не публикуйте его в открытом доступе и не перепродавайте доступ третьим лицам.
• Запрещены попытки обойти лимиты, вмешаться в работу шлюза, сканировать чужие ключи и создавать чрезмерную нагрузку.
• Запрещён контент и действия, нарушающие закон. Ответственность за запросы лежит на владельце ключа.
• При злоупотреблении ключ может быть отключён без возврата неиспользованного объёма.
• Доступность upstream и конкретных моделей не гарантирована круглосуточно: провайдер может менять каталог и лимиты.

Данные и конфиденциальность

• Шлюз хранит e-mail, хэш ключа, лимит, расход, модель и счётчики токенов.
• Содержимое запросов и ответов не сохраняется в базе шлюза.
• Ключ хранится в виде SHA-256 хэша. Показать исходный ключ повторно невозможно.
• Сессия кабинета и админки использует подписанную cookie. Пароль администратора хранится только в переменных окружения.
• Запрос на удаление аккаунта и связанных логов можно отправить на support@kateshopik.ru.