Документация

Толк — один OpenAI-совместимый API ко всем нейросетям. Рубли, без VPN, документы.

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

Получи ключ на странице регистрации, пополни баланс в кабинете и поменяй одну строку base_url:

from openai import OpenAI

client = OpenAI(
    base_url="https://usetolk.ru/v1",
    api_key="sk-tolk-...",
)
resp = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "Привет!"}],
)
print(resp.choices[0].message.content)

Работает с OpenAI SDK, LangChain, n8n и любым инструментом, понимающим OpenAI API.

Эндпоинты

POST /v1/chat/completions — генерация (поддерживает stream: true)
GET /v1/models — список моделей
GET /v1/me — баланс и план (заголовок Authorization: Bearer <ключ>)

Модели

model	что это
`auto`	роутер — сам выберет самую дешёвую модель
`gigachat` · `gigachat-pro` · `gigachat-max`	GigaChat (Сбер)
`yandexgpt-lite` · `yandexgpt`	YandexGPT (Яндекс)
`deepseek` · `deepseek-reasoner`	DeepSeek V3 / R1 (Китай)
`kimi`	Kimi · Moonshot (Китай)
`glm-4-plus` · `glm-4-flash`	GLM-4 · Zhipu (Китай)
`qwen-max` · `qwen-plus` · `qwen-turbo`	Qwen API · Alibaba (Китай)
`qwen3-14b` · `qwen3-32b` · `qwen3-72b`	Qwen (открытые, на нашем GPU)

Параметры запроса

model — имя из таблицы выше или auto
messages — массив {role, content}
stream — true для потоковой выдачи (SSE)
temperature, max_tokens — как в OpenAI API

Коды ошибок

код	значение
401	неверный или отсутствует API-ключ
402	недостаточно средств — пополни баланс
429	слишком много запросов
502 / 503	провайдер недоступен или не настроен

Оплата и документы

Баланс пополняется в рублях картой РФ и через СБП. Списание — по факту использования. Юрлицам доступны закрывающие документы (договор, счёт, акт) — на тарифе Pro/Бизнес.

→ Получить ключ и начать