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.
Что доступно через один ключ:
- текстовые модели OpenAI, Anthropic, Google, DeepSeek, Moonshot, Zhipu, xAI, Meta, Alibaba, MiniMax;
- генерация изображений — GPT Image, Seedream, Nano Banana, Grok Imagine;
- видео — Kling, Seedance, WAN, Veo, MiniMax Hailuo, HeyGen Video;
- озвучка — MiniMax, от 1 000 до 50 000 символов за запрос;
- цифровые аватары HeyGen (Video 1, 480p, 10 и 30 секунд).
Всего 110 позиций. Полный список с ценами — на странице модели и цены.
Шаг 1. Регистрация и ключ
Регистрация в кабинете даёт $0.20 стартового баланса: примерно 400 тысяч входных токенов GPT-4o-mini или четыре тестовых видео по пять секунд в дешёвых моделях. Порядок:
- Создайте аккаунт, подтвердите почту.
- В разделе «Токены» нажмите «Создать ключ».
- Скопируйте строку sk-… — второй раз она не показывается.
- Проверьте баланс на главной странице кабинета.
Ключ один на все модели. Отдельные ключи под видео или картинки не нужны: доступ определяет баланс, а не тип ключа.
Шаг 2. Base URL и совместимость
Замените адрес в клиенте или SDK:
- было: https://api.openai.com/v1
- стало: https://kiree.net/v1
Всё остальное — заголовок 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, код активации приходит в чат заказа и активируется в кабинете. Удобно тем, у кого нет зарубежной карты.
Три цифры для планирования:
- GPT-4o-mini — $0.30 за 1M входных токенов;
- DeepSeek Flash — $0.48 за 1M;
- Claude Sonnet 5 — $0.72 за 1M, Claude Opus 4.6 — $2.40 за 1M.
Видео на порядок дороже текста: один пятисекундный ролик стоит как 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 — защита от «бесконечного» ответа и счёта на сотни долларов.
Чек-лист запуска
- Аккаунт создан, ключ сохранён в переменной окружения.
- Base URL заменён на https://kiree.net/v1.
- Тестовый запрос к gpt-4o-mini вернул ответ.
- Клиент (Cherry Studio / Cursor / свой код) видит список моделей.
- Лимит max_tokens и таймауты выставлены.
- Для дорогих медиа-вызовов есть подтверждение или дневной лимит.
- Баланс пополнен на прогнозируемый объём, а не «на всё сразу».
Частые вопросы
Нужен ли VPN для Kiree.net?+
Нет. Шлюз принимает запросы из России напрямую; VPN не требуется ни для запросов, ни для кабинета.
Ключ один или на каждую модель?+
Один ключ на аккаунт. Доступ определяет баланс, а не ключ: доступны все 110 позиций каталога.
Можно ли использовать ключ в мобильном приложении?+
Да, подойдёт любой клиент с настройкой «OpenAI-совместимый провайдер»: нужно указать Base URL и ключ.
Регистрация занимает минуту: $0.20 на тест, Base URL https://kiree.net/v1, оплата из РФ.