Выберите провайдера OpenAI Compatible
Шестерёнка Cline → API Provider → OpenAI Compatible. Не путайте с провайдером OpenAI: у того base URL зашит и поля адреса нет.
Cline: настройка API через OpenAI Compatible и что значит API request failed
Cline подключается к любому API тремя полями, и большинство ошибок — это опечатка в одном из них. Разбираем, что куда вписать и как читать ответ сервера в ошибке.
Коротко: Cline — это агент внутри VS Code, который сам читает файлы, пишет код и запускает команды в терминале, спрашивая разрешение на каждый шаг. Своих моделей у него нет: он ходит в тот API, который вы укажете в настройках. Для любого OpenAI-совместимого сервиса выбирается провайдер OpenAI Compatible, и дальше нужны ровно три поля: Base URL, API Key и Model ID.
/ Подробнее
Что важно знать
Base URL — адрес сервера вместе с /v1, без /chat/completions на конце. API Key — ключ от этого сервера, не от OpenAI. Model ID — имя модели точно в том написании, которое понимает ваш API: у разных сервисов одна и та же модель называется по-разному, и это самая частая причина ошибки.
Когда что-то не так, Cline показывает «API request failed» и ниже — тело ответа сервера как есть. В нём и лежит ответ: 401 — ключ, 404 — путь или модель, 402 — баланс, 429 — частота. Читать нужно именно эту часть, а не первую строку.
/ На kosareva.cloud
Cline со всеми моделями по одному ключу
В Cline выберите OpenAI Compatible и вставьте наш адрес, ключ и имя модели. Под Cline можно выпустить отдельный ключ с лимитом, чтобы агент не потратил весь баланс.
- DeepSeek V4 Flash
- 47,52 ₽ вход, 143 ₽ выход за 1 млн токенов
- Claude Sonnet 5
- 216 ₽ вход, 1 080 ₽ выход за 1 млн токенов
- Оплата
- Карта РФ или СБП от 50 ₽, компаниям — по счёту
- Доступ
- Без VPN, запросы идут с российских IP
from openai import OpenAI client = OpenAI( api_key="ВАШ_API_КЛЮЧ", base_url="https://api.kosareva.cloud/v1", ) response = client.chat.completions.create( model="gpt-5-6", messages=[{"role": "user", "content": "Привет!"}], stream=True, )
import OpenAI from "openai"; const client = new OpenAI({ apiKey: "ВАШ_API_КЛЮЧ", baseURL: "https://api.kosareva.cloud/v1", }); const response = await client.chat.completions.create({ model: "gpt-5-6", messages: [{ role: "user", content: "Привет!" }], stream: true, });
curl https://api.kosareva.cloud/v1/chat/completions \ -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \ -H "Content-Type: application/json" \ -d '{"model":"gpt-5-6","messages":[{"role":"user","content":"Привет!"}],"stream":true}'
/ Почему
Откуда берётся ошибка
Base URL без /v1 или с лишним хвостом
Cline сам добавляет /chat/completions, поэтому адрес должен кончаться на /v1. Иначе 404.
Ключ не от того сервиса
Ключ OpenAI с чужим base URL или наоборот. Ответ 401 authentication_error.
Model ID не в том написании
С точкой вместо дефиса, с лишним префиксом, старое имя. Ответ 404 model_not_found или 400.
Контекст больше, чем у модели
Cline отправляет много: системный промпт, файлы, историю. У модели с коротким контекстом это упирается в 400 context_length_exceeded.
Баланс или частота
402 при пустом счёте, 429 при залпе запросов от агента в длинной задаче.
/ Что делать
Порядок действий
Заполните три поля
Base URL с /v1, ключ от того же сервера, Model ID как в каталоге сервера. Пример для нашего шлюза:
Проверьте те же три значения curl
Если curl отвечает, а Cline нет, проблема в полях Cline: чаще всего пробел в конце ключа или адреса.
Прочитайте тело ошибки
В «API request failed» разверните текст ниже: там JSON с полями type, code и message. По code ищите страницу в справочнике: invalid_api_key, model_not_found, context_length_exceeded.
Подберите модель под задачу
Для длинных агентских задач берите модель с большим контекстом и не самую дорогую: агент делает десятки запросов за одну задачу, и выходные токены стоят в 5 раз дороже входных.
/ По инструментам
Где это чинится в разных инструментах
Cline в VS Code
Настройки хранятся в самом расширении, ключ — в защищённом хранилище VS Code. При переустановке расширения поля нужно заполнить заново.
Cline в Cursor и других форках VS Code
Те же три поля, тот же провайдер. Работоспособность самого редактора — отдельный вопрос.
Roo Code и другие ответвления Cline
Провайдер называется так же, поля те же, иногда добавлено поле для контекста модели — его стоит выставить руками.
Наше расширение VS Code
Готовит значения для Cline и кладёт их в буфер обмена, вставлять всё равно в поля Cline.
/ FAQ
Частые вопросы
Cline пишет API request failed без текста ниже. Что делать?
Значит, ответа от сервера не было вовсе: неверный адрес, нет сети или прокси не пропускает. Проверьте base URL и curl до того же адреса.
Можно ли в Cline держать несколько моделей?
Да, через профили конфигурации: у каждого свой провайдер, ключ и Model ID. Удобно держать дешёвую модель для рутины и сильную для сложного.
Почему Cline тратит так много токенов?
Он передаёт в каждый запрос файлы, историю и результаты команд. Следите за расходом по ключу и ставьте лимит на ключ для агента.
Работает ли Cline в России без VPN?
Сам Cline — да: это открытое расширение из магазина VS Code, и для работы со своим провайдером вход в аккаунт Cline не нужен. Всё решает API, который вы впишете: прямые ключи OpenAI и Anthropic из России не работают, а наш base URL отвечает без VPN.
Что такое режимы Plan и Act в Cline?
Это два режима одного агента. В Plan Cline читает проект и обсуждает с вами план, ничего не меняя, а в Act правит файлы и запускает команды. В настройках режимам можно назначить разные модели: сильную на планирование и подешевле на исполнение, так длинные задачи обходятся дешевле.
/ Дальше
Рядом в справочнике
Ключ, который работает из России
OpenAI-совместимый адрес, оплата в рублях, ключ сразу после регистрации. Пополнение картой от 50 ₽.