Подключение и миграция9 мин чтения

OpenAI-совместимый API из России: подключение за 10 минут

Если вы пробовали получить ключ OpenAI из России, то знаете два барьера: оплата зарубежной картой и доступ без VPN. Оба решаются шлюзом-посредником. Ниже — рабочая последовательность: от регистрации до первого ответа модели и настройки популярных клиентов. Проверено на Kiree.net, где один ключ открывает 110 моделей от 17 правообладателей.

Зачем нужен шлюз

Официальные API OpenAI, Anthropic и Google рассчитаны на зарубежные карты и стабильный прямой доступ. Российскому разработчику приходится решать три задачи сразу: чем платить, как обеспечить сетевой доступ и как не заводить пять ключей под пять разных вендоров.

Шлюз закрывает всё это: один адрес https://kiree.net/v1, один ключ формата sk-… и баланс, который тратится на любые модели — текстовые, графические, видео, озвучку. Совместимость с OpenAI SDK сохраняется полностью: код под api.openai.com работает без правок, меняется только base_url.

Что доступно через один ключ:

Всего 110 позиций. Полный список с ценами — на странице модели и цены.

Шаг 1. Регистрация и ключ

Регистрация в кабинете даёт $0.20 стартового баланса: примерно 400 тысяч входных токенов GPT-4o-mini или четыре тестовых видео по пять секунд в дешёвых моделях. Порядок:

  1. Создайте аккаунт, подтвердите почту.
  2. В разделе «Токены» нажмите «Создать ключ».
  3. Скопируйте строку sk-… — второй раз она не показывается.
  4. Проверьте баланс на главной странице кабинета.

Ключ один на все модели. Отдельные ключи под видео или картинки не нужны: доступ определяет баланс, а не тип ключа.

Шаг 2. Base URL и совместимость

Замените адрес в клиенте или SDK:

Всё остальное — заголовок Authorization: Bearer sk-…, структура запроса, формат ответа, стриминг — остаётся прежним. Библиотеки openai (Python, Node.js), LangChain, LlamaIndex, Vercel AI SDK и самописные обёртки работают без изменений в коде.

Список моделей, доступных ключу, отдаёт стандартный GET /v1/models — его же используют клиенты для выпадающего списка.

Шаг 3. Первый запрос

curl

curl https://kiree.net/v1/chat/completions \
  -H "Authorization: Bearer $KIREE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"Привет! Кто ты?"}]}'

Python (официальный SDK)

from openai import OpenAI

client = OpenAI(
    api_key="sk-…",
    base_url="https://kiree.net/v1",
)

r = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "Сократи текст до трёх пунктов: …"}],
    max_tokens=600,
)
print(r.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.KIREE_KEY,
  baseURL: "https://kiree.net/v1",
});

const res = await client.chat.completions.create({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "Напиши 5 заголовков для лендинга" }],
});

Если ответ пришёл — основная интеграция закончена. Дальше имеет смысл настроить клиент под себя, чтобы не дёргать curl каждый раз.

Шаг 4. Готовые клиенты

Почти все популярные приложения поддерживают «OpenAI-совместимый» провайдер. Заполнять нужно четыре поля.

Клиент Что выбрать Значения
Cherry Studio Провайдер → OpenAI или Custom Base URL https://kiree.net/v1, ключ sk-…, модель из каталога
NextChat Настройки → API Endpoint https://kiree.net/v1, ключ, модель
LobeChat Провайдер → OpenAI (Custom) Proxy URL https://kiree.net/v1, ключ
Cursor Settings → Models → Override Base URL https://kiree.net/v1, ключ OpenAI-типа
SillyTavern API → Chat Completion → Custom URL https://kiree.net/v1, ключ, модель

Проверка после сохранения: отправьте короткое сообщение на бонусном балансе и убедитесь, что ответ приходит, а баланс списывается. Если список моделей пустой — ключ не активен или запрос идёт не на /v1.

Шаг 5. Картинки, видео и озвучка

Медиа-запросы отличаются от текстовых только эндпоинтом. Ключ тот же.

Изображения

curl https://kiree.net/v1/images/generations \
  -H "Authorization: Bearer $KIREE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"img-seedream-50-flash-1img","prompt":"рыжий кот идёт по траве, утренний свет","size":"1536x1536"}'

Стоимость фиксированная за изображение: от $0.03 (Seedream Flash) до $0.06 (GPT Image). Разрешение и соотношение сторон задаются в запросе.

Видео

curl -X POST https://kiree.net/v1/videos/generations \
  -H "Authorization: Bearer $KIREE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"kling-v3-std-5s","prompt":"кот идёт по траве","aspect_ratio":"16:9"}'

Генерация асинхронная: POST возвращает идентификатор задачи, дальше вы опрашиваете GET /v1/videos/{id} до статуса «готово», ссылка на файл лежит в метаданных ответа. Ролик рендерится 30–120 секунд, держать соединение открытым бессмысленно.

Цены за ролик: Kling 3.0 — $0.60 за 5 секунд, Seedance 2.5 Flash — $1.60, WAN 2.7 — $0.95, Veo 3.1 Lite — $0.25 за 4 секунды. Подробное сравнение — в статье сколько стоит генерация видео.

Шаг 6. Деньги и лимиты

Баланс пополняется пакетами: 10M токенов за $5, 100M за $12, 1B за $121. Внутри баланса нет разделения «на текст» и «на видео» — списание идёт по тарифу конкретной модели; в каталоге у каждой позиции указана цена за миллион токенов или за вызов.

Оплата из России: карта, СБП, криптовалюта через Plati.market, код активации приходит в чат заказа и активируется в кабинете. Удобно тем, у кого нет зарубежной карты.

Три цифры для планирования:

Видео на порядок дороже текста: один пятисекундный ролик стоит как 100–200 тысяч токенов текста. Поэтому в интерфейсах и ботах лучше ставить подтверждение перед дорогими вызовами.

Типичные ошибки

Код Причина Что делать
401 invalid_api_key ключ не передан, отозван или скопирован с пробелом проверить заголовок Authorization: Bearer sk-…, создать новый ключ
402 insufficient_quota баланс закончился пополнить пакет, проверить расход в кабинете
429 rate_limit слишком частые запросы к конкретной модели снизить параллелизм, добавить ретраи с задержкой
400 model_not_found опечатка в ID или модель снята с продажи сверять ID с каталогом, не хардкодить устаревшие

Безопасность ключа

Ключ — это деньги. Три правила: не коммитить sk-… в публичные репозитории; не вставлять его в клиентский JavaScript (иначе посетитель видит его в Network); для продакшена выпускать отдельные ключи под сервисы и отзывать при утечке. На стороне приложения полезно ограничить max_tokens — защита от «бесконечного» ответа и счёта на сотни долларов.

Чек-лист запуска

  1. Аккаунт создан, ключ сохранён в переменной окружения.
  2. Base URL заменён на https://kiree.net/v1.
  3. Тестовый запрос к gpt-4o-mini вернул ответ.
  4. Клиент (Cherry Studio / Cursor / свой код) видит список моделей.
  5. Лимит max_tokens и таймауты выставлены.
  6. Для дорогих медиа-вызовов есть подтверждение или дневной лимит.
  7. Баланс пополнен на прогнозируемый объём, а не «на всё сразу».

Частые вопросы

Нужен ли VPN для Kiree.net?+

Нет. Шлюз принимает запросы из России напрямую; VPN не требуется ни для запросов, ни для кабинета.

Ключ один или на каждую модель?+

Один ключ на аккаунт. Доступ определяет баланс, а не ключ: доступны все 110 позиций каталога.

Можно ли использовать ключ в мобильном приложении?+

Да, подойдёт любой клиент с настройкой «OpenAI-совместимый провайдер»: нужно указать Base URL и ключ.

Нужен ключ?

Регистрация занимает минуту: $0.20 на тест, Base URL https://kiree.net/v1, оплата из РФ.

Клиенты и интеграции →