API для ИИ-агентов и кодинга: подключение из России

Коротко: почти все агенты для кода — opencode, Cline, Kilo Code, Roo Code — умеют работать с любым OpenAI-совместимым API (Cursor — частично, см. таблицу). Это значит, что провайдера можно поменять, не трогая код: достаточно подставить другой base_url и ключ. Здесь — как это сделать, что выбрать и во сколько обходятся токены.

Что вообще значит «OpenAI-совместимый»

Формат запроса, который придумала OpenAI для POST /v1/chat/completions, стал де-факто стандартом. Провайдер, который его поддерживает, выглядит для инструмента как OpenAI: тот же JSON на входе, тот же на выходе, тот же протокол потоковой передачи (SSE). Поэтому в настройках агентов и есть пункт OpenAI Compatible — туда подставляется чужой адрес.

Практический вывод: смена провайдера — это две строки конфига, а не переписывание проекта. Если оплата у текущего провайдера перестала проходить, миграция занимает минуты — см. аналоги OpenRouter.

Какой агент что умеет

Сколько это стоит

Агенты для кода расходуют токены неравномерно: на вход уходит весь контекст проекта (много, дёшево), на выход — только патч (мало, дорого). Поэтому цену стоит смотреть парой «вход / выход», а не одним числом.

Ставки Twelver за 1 млн токенов, от самого дешёвого входа:

С чего начать

Порядок такой: сначала ключ — он выдаётся здесь же, — потом руководство по вашему инструменту.

1. Возьмите доступ в блоке выше и выберите серию моделей. Для агента берите auto и поднимайте класс только там, где качества не хватает. Серии с приставкой -flash дешевле по входу, но рассчитаны на простые массовые запросы, а не на правку кода.
2. Откройте руководство по своему инструменту: opencode или Cline — там те же значения вписываются в конфиг агента.
3. Если переезжаете с другого сервиса, сверьтесь с разбором аналогов: ломается при переезде обычно только идентификатор модели.

Один ключ — три API

Стоит сказать прямо, потому что из раздела выше этого не видно: ключ, который вы получили для агента, — это не только прокси к /chat/completions. Тем же заголовком Authorization: Bearer sk-… открываются ещё две поверхности, и платятся они из одного баланса.

Media API: картинки, видео, музыка и речь из кода

Вторая поверхность — генерация медиа тем же ключом. Она асинхронная, и это осознанно: видео рендерится минуты, держать HTTP-соединение всё это время бессмысленно. POST создаёт задачу и сразу возвращает её id, GET по этому id отдаёт статус, а когда он станет completed — ссылки на готовые файлы.

# 1. создать задачу
curl -X POST https://twelver.ru/api/ai/<ваш-config-id>/v1/media/generations \
  -H "Authorization: Bearer sk-<ваш-ключ>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "обложка статьи про API для кодинга, минимализм",
    "toolsets": ["image-generation"]
  }'
# → {"status":"running","id":"..."}

# 2. забрать результат по id
curl https://twelver.ru/api/ai/<ваш-config-id>/v1/media/generations/<task-id> \
  -H "Authorization: Bearer sk-<ваш-ключ>"
# → {"status":"completed","output":{"files":[{"url":"..."}]}}

Точную схему запроса и ответа всегда отдаёт сам сервер — GET /api/ai/<config-id>/v1/media/generations/schema, вместе со списком наборов, которые реально зарегистрированы на бэкенде в этот момент. Это надёжнее любой документации, включая эту страницу.

MCP-серверы: наши инструменты в чужих клиентах

Третья поверхность — единственная, которая работает не с нашей моделью, и поэтому её стоит понять отдельно. MCP — это протокол, которым ИИ-клиент подключает внешние инструменты. Мы отдаём каждый набор инструментов как remote MCP-сервер по адресу вида https://twelver.ru/api/mcp/v1/image-generation. Модель при этом остаётся та, что стоит в клиенте.

Практический смысл: Claude Code и Claude Desktop, которые к нашему /chat/completions подключиться не могут в принципе, к MCP подключаются штатно — по OAuth, без ключа в конфиге. То же и с Cursor, и с любым другим MCP-клиентом. Claude продолжает думать головой Anthropic, но получает веб-поиск, генерацию изображений и видео и остальное из нашего каталога.

Всего на выбор 25 наборов, инструментов в них — 93: генерация изображений — 4, генерация видео — 7, музыка, речь и распознавание — 5, поиск, документы и данные — 9. Разбор с конфигами — на страницах MCP для Claude и MCP для Cursor.

Подписка — это общий баланс, а не отдельный тариф на каждое

Все перечисленное — включая полноценный агентный чат на сайте и в приложении, с собственными агентами, памятью, знаниями и артефактами, — расходует один и тот же баланс токенов. Отдельной подписки на медиа, отдельной на MCP и отдельной на API нет: вы решаете по ходу дела, во что тратить месячный объём.

Чтобы это были не абстрактные миллионы — вот что 3 900 000 токенов плана Basic за 390 ₽ покупают, если потратить их целиком на что-то одно:

Начать можно и без подписки: 250 000 токенов выдаются новому аккаунту бесплатно. Этого хватит, чтобы проверить связку, но не чтобы работать: на агенте для кода это единицы запросов, а самый дешёвый видеоролик в такой объём не влезает вовсе.

Содержание

1. 1.opencode в России: настройка своего провайдера
2. 2.Аналоги OpenRouter в России: что работает в 2026
3. 3.Cline: настройка OpenAI-совместимого API в VS Code

Попробуйте сами

Получите base_url и ключ прямо сейчас

Кнопка на странице API выдаёт адрес и ключ сразу — без регистрации и без привязки карты.

Получить API-ключ

⚡Лендинг по темеAPI для кодаTwelver на AndroidТот же чат в приложении