Быстрый старт
ЦАРЬ РОУТЕР - агрегатор российских и open-source нейросетей с единым OpenAI-совместимым API. Один ключ, один формат: меняете base_url - и весь код на OpenAI SDK работает без изменений. Не нужно регистрироваться в Yandex Cloud, Cloud.ru, GigaChat или MWS - ЦАРЬ РОУТЕР берёт это на себя.
Предупреждение
Сервис ЦАРЬ РОУТЕР находится на стадии бета-тестирования.
- Если вы сталкиваетесь с ошибками в том числе 429 (превышение лимитов), то сообщите нам по почте support@tsarrouter.ru
- Действуют лимиты запросов по уровням (Tier) - подробнее на странице Лимиты.
- Что еще находится в работе:
- Добавление новых моделей и отладка текущих моделей.
- Добавление эндпоинтов
- И т.д.
- На странице Истории изменений можно узнать какие модели добавились/изменились/удалились и другие изменения сервиса.
Спасибо, желаем удачного использования!
1. Базовый URL
https://api.tsarrouter.ru/v1Это адрес, который вы подставляете вместо base_url OpenAI. Все эндпоинты совместимы с форматом OpenAI.
2. Ключ
Зарегистрируйтесь в личном кабинете и создайте API-ключ.
Формат: sk-tsar- + 40 hex-символов. Один ключ открывает доступ ко всем моделям всех провайдеров.
Передавайте ключ в заголовке Authorization:
Authorization: Bearer sk-tsar-ваш-ключ3. Первый запрос
from openai import OpenAI
client = OpenAI(
base_url="https://api.tsarrouter.ru/v1",
api_key="sk-tsar-ваш-ключ",
)
response = client.chat.completions.create(
model="yandex/yandexgpt-pro-5.1",
messages=[{"role": "user", "content": "Привет!"}],
)
print(response.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.tsarrouter.ru/v1",
apiKey: "sk-tsar-ваш-ключ",
});
const response = await client.chat.completions.create({
model: "sber/gigachat-2-max",
messages: [{ role: "user", content: "Привет!" }],
});
console.log(response.choices[0].message.content);curl https://api.tsarrouter.ru/v1/chat/completions \
-H "Authorization: Bearer sk-tsar-ваш-ключ" \
-H "Content-Type: application/json" \
-d '{
"model": "yandex/yandexgpt-pro-5.1",
"messages": [{"role": "user", "content": "Привет!"}]
}'4. Названия моделей
Все модели используют формат provider/model:
yandex/yandexgpt-pro-5.1, sber/gigachat-2-max, BAAI/bge-m3.
Регистр имеет значение.
sber/gigachat-2-max≠Sber/gigachat-2-max.
Актуальный каталог моделей с ценами - на странице "Модели", либо запросом:
from openai import OpenAI
client = OpenAI(
base_url="https://api.tsarrouter.ru/v1",
api_key="sk-tsar-ваш-ключ",
)
models = client.models.list()
for model in models.data:
print(model.id)import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.tsarrouter.ru/v1",
apiKey: "sk-tsar-ваш-ключ",
});
const models = await client.models.list();
for (const model of models.data) {
console.log(model.id);
}curl https://api.tsarrouter.ru/v1/models \
-H "Authorization: Bearer sk-tsar-ваш-ключ"