Kilo Code API: ключ провайдера и ключ Kilo

Запрос «Kilo Code API: ключ провайдера и ключ Kilo» покрывает несколько разных сценариев: вход в аккаунт при установке расширения, свой ключ провайдера модели в настройках, ключ Kilo для внешних SDK и локальную модель без ключа. Ниже — что подключать под каждую задачу.

Два ключа и случаи без ключа

В Kilo Code ключи расходятся по назначению. Ключ провайдера модели — это ваш собственный ключ от Anthropic, OpenAI, OpenRouter и других сервисов; он вводится внутри расширения. Ключ Kilo — это ключ шлюза Kilo AI Gateway, он нужен, когда вы обращаетесь к моделям из внешнего кода: через Vercel AI SDK, OpenAI SDK, Python или cURL.

Есть и третий случай — работа вообще без ключа. В документации Kilo Code сказано, что при установке расширения вам предлагают войти или создать бесплатный аккаунт, и это автоматически настраивает всё нужное для старта. Войти можно по email, через ChatGPT, Google, Apple, GitHub, GitLab, Discord, LinkedIn, Anaconda или корпоративный single sign-on.

Встроенный провайдер Kilo Code даёт доступ к моделям через простую регистрацию, и управлять ключами от нескольких поставщиков не требуется. В веб-IDE шаг авторизации отличается: вместо перехода в VS Code ключ API при регистрации копируется вручную.

Итого три пути: вход в аккаунт без ключа, свой ключ провайдера внутри расширения, ключ Kilo для внешнего кода. Дальше — пошагово по каждому.

Вход в аккаунт при установке расширения

При первом открытии Kilo Code в VS Code расширение предлагает войти. Нажимаете Sign In и проходите браузерный сценарий авторизации — вход действует на всех поверхностях расширения, включая боковую панель и Agent Manager.

Отдельно стоит вход через ChatGPT. В документации указано, что ChatGPT можно использовать для входа в Kilo, для подключения подписки к запросам моделей или для того и другого сразу. Это разные опции, и ни одна из них не требует ключа OpenAI API.

Что это даёт на практике: после входа расширение готово к работе, а настройка провайдеров и ключей не нужна. Agent Manager не требует отдельной настройки провайдера или авторизации Kilo CLI — те же настройки применяются по всему расширению.

Если вы предпочитаете собственные ключи или у вас уже есть подписка, документация предлагает более 30 провайдеров. Среди популярных вариантов: ChatGPT Go/Plus/Pro использует существующую подписку и ключ не требует; OpenRouter даёт доступ к множеству моделей по одному ключу; Anthropic — прямой доступ к моделям Claude; OpenAI — доступ к моделям GPT. Из этих четырёх вариантов ключ не нужен только для ChatGPT.

Свой ключ провайдера модели

Свой ключ вводится в настройках расширения. Порядок по документации: откройте Kilo Code в VS Code, нажмите иконку шестерёнки в интерфейсе расширения, перейдите на вкладку Providers, выберите провайдера и введите ключ, затем выберите модель.

Где брать ключ у конкретных провайдеров — в документации даны примеры. OpenRouter: войти на openrouter.ai, перейти в раздел API keys и создать новый ключ. Anthropic: войти на console.anthropic.com и скопировать ключ сразу — повторно он не показывается. OpenAI: войти на platform.openai.com.

Список провайдеров шире этих трёх: Google Gemini, DeepSeek, Mistral, Ollama для локальных моделей, AWS Bedrock, Google Vertex и другие. Полный перечень — в разделе AI Providers документации.

Один нюанс про хранение: ключ Anthropic показывается один раз при создании. Если вы его не сохранили, придётся выпускать новый — старый восстановить нельзя.

Ключ Kilo для внешних SDK

Ключ Kilo нужен, когда вы работаете со шлюзом Kilo AI Gateway вне расширения — например, с Vercel AI SDK или OpenAI SDK. Порядок получения по документации:

1. Перейдите на app.kilo.ai.
2. Откройте Your Profile в личном аккаунте (не в организации).
3. Прокрутите страницу до низа.
4. Скопируйте API key.

Для работы с ключом нужен аккаунт Kilo с кредитами: их добавляют из панели аккаунта на kilo.ai. Ключ Kilo расходует кредиты вашего аккаунта.

Дальше — подключение. В документации шлюза приведён пример на Vercel AI SDK: создаётся проект, ставятся зависимости ai, @ai-sdk/openai и dotenv, в файл .env добавляется переменная KILO_API_KEY. В коде клиент создаётся с указанием base URL и ключа из переменной окружения:

import "dotenv/config"
import { streamText } from "ai"
import { createOpenAI } from "@ai-sdk/openai"

const kilo = createOpenAI({
  baseURL: "https://ai-gateway.kilo.ai/api/v1",
  apiKey: process.env.KILO_API_KEY,
})

async function main() {
  const result = streamText({
    model: kilo.chat("anthropic/claude-sonnet-4.5"),
    prompt: "Invent a new holiday and describe its traditions.",
  })

  for await (const textPart of result.textStream) {
    process.stdout.write(textPart)
  }

  console.log()
  console.log("Token usage:", await result.usage)
  console.log("Finish reason:", await result.finishReason)
}

main().catch(console.error)

Модель anthropic/claude-sonnet-4.5 взята из примера документации. По документации код сохраняется в файл index.mjs и запускается командой node index.mjs, после чего ответ модели выводится в терминал потоком. Ключ читается из переменной окружения и в логи не выводится.

Base URL и совместимость с OpenAI SDK

Шлюз Kilo AI Gateway предоставляет API, совместимый с OpenAI. Все эндпоинты используют базовый адрес https://ai-gateway.kilo.ai/api/v1. Авторизация — через заголовок Bearer с ключом из переменной KILO_API_KEY.

Основной эндпоинт — POST /chat/completions. В теле запроса обязательны model и messages; дополнительно доступны stream, max_tokens, temperature, top_p, stop, frequency_penalty, presence_penalty, tools, tool_choice, response_format, user, seed.

Совместимость с OpenAI SDK означает, что клиент OpenAI можно направить на адрес Kilo. В документации приведён пример:

import OpenAI from "openai"

const client = new OpenAI({
  apiKey: process.env.KILO_API_KEY,
  baseURL: "https://ai-gateway.kilo.ai/api/v1",
})

const response = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-4.5",
  messages: [{ role: "user", content: "Why is the sky blue?" }],
})

console.log(response.choices[0].message.content)

Тот же запрос через cURL выглядит так:

curl -X POST "https://ai-gateway.kilo.ai/api/v1/chat/completions" \
  -H "Authorization: Bearer $KILO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4.5",
    "messages": [
      {
        "role": "user",
        "content": "Why is the sky blue?"
      }
    ],
    "stream": false
  }'

Список моделей доступен по GET /models без авторизации, список провайдеров — по GET /providers. Тело запроса ограничено 20 МБ; при превышении шлюз возвращает HTTP 413. Частая причина — длинная история с крупными inline-картинками в base64.

BYOK внутри Kilo Gateway

BYOK расшифровывается как bring your own key — свой ключ провайдера. В расширении Kilo Code этот сценарий описан на вкладке Providers. Внутри шлюза Kilo Gateway BYOK настраивается отдельно, и документация шлюза указывает раздел Authentication & BYOK как источник по управлению ключами.

Запросы к шлюзу при этом авторизуются ключом Kilo: в примерах документации шлюза, включая FIM-запрос с поддержкой BYOK, заголовок Bearer несёт $KILO_API_KEY. Документация провайдера Kilo Code прямо указывает, что запросы идут через Kilo Gateway для доступа к моделям, учёта использования и организационных контролей, а по настройке BYOK, маршрутизации провайдеров и полному списку моделей источником истины служат документы Gateway.

Отдельный случай — FIM-дополнения (fill-in-the-middle) для генерации кода. Они работают на моделях Mistral Codestral, и BYOK там поддерживается с типом ключа codestral. Эндпоинт — POST /fim/completions, модель должна иметь идентификатор, начинающийся с mistralai/.

Сторонний конфиг OpenClaw

Сторонние клиенты подключают Kilo Gateway по-своему. В документации OpenClaw (docs.openclaw.ai) описан провайдер kilocode: при запуске клиент запрашивает GET https://api.kilo.ai/api/gateway/models, используется один ключ KILOCODE_API_KEY и модель kilocode/kilo/auto.

Здесь важно расхождение с вендорской документацией. Адрес api.kilo.ai/api/gateway/ и переменная KILOCODE_API_KEY относятся к конфигу OpenClaw. В документации Kilo Gateway базовый адрес — https://ai-gateway.kilo.ai/api/v1, а переменная — KILO_API_KEY. Если вы настраиваете внешний SDK, берите вендорские значения; если конфигурируете OpenClaw, следуйте его документации.

Другой пример стороннего шлюза — Coder AI Gateway. В его документации подключение Kilo Code описано через centralized API key с провайдерами OpenAI Compatible и Anthropic, а про BYOK сказано, что интеграция с AI Gateway пока работает ненадёжно. Это чужой шлюз, и ключа Kilo в нём нет.

Локальная модель без ключа

Локальные модели через Ollama входят в список поддерживаемых провайдеров Kilo Code. Для локальной модели ключ провайдера не нужен: модель работает на вашем железе, и обращаться к внешнему сервису за авторизацией не требуется.

Настройка идёт тем же путём: Settings → Providers, выбор провайдера, выбор модели. Отличие в том, что на шаге ввода ключа ничего вводить не нужно — Ollama обслуживает запросы локально.

Если вы держите локальную модель для черновых задач, а премиальные модели подключаете через аккаунт Kilo, оба пути сосуществуют в одном расширении: настройки применяются по всему интерфейсу, включая боковую панель и Agent Manager.

Таблица выбора: задача → ключ

Таблица покрывает пять сценариев. Для внешнего SDK ключ Kilo работает с кредитами аккаунта — их добавляют из панели на kilo.ai. Чем различаются кредиты Kilo, свой ключ и локальная модель по доступу и ограничениям, разобрано в материале Kilo Code в России: доступ и ограничения.

Частые вопросы

Чем ключ провайдера отличается от ключа Kilo?
Ключ провайдера — ваш собственный ключ от Anthropic, OpenAI, OpenRouter и подобных сервисов; он вводится в настройках расширения на вкладке Providers. Ключ Kilo — ключ шлюза Kilo AI Gateway, он нужен для обращения к моделям из внешнего кода через Vercel AI SDK, OpenAI SDK, Python или cURL. Первый работает внутри расширения, второй — вне его.

Нужен ли ключ при установке расширения Kilo Code?
Нет. При первом открытии расширения в VS Code вам предлагают войти или создать бесплатный аккаунт, и это автоматически настраивает всё нужное. Войти можно по email, через ChatGPT, Google, Apple, GitHub, GitLab, Discord, LinkedIn, Anaconda или корпоративный single sign-on.

Где взять ключ Kilo для внешнего SDK?
Перейдите на app.kilo.ai, откройте Your Profile в личном аккаунте (не в организации), прокрутите страницу до низа и скопируйте API key. Для работы с ключом нужен аккаунт с кредитами — их добавляют из панели аккаунта на kilo.ai.

Какой base URL подставлять в OpenAI SDK?
https://ai-gateway.kilo.ai/api/v1. Шлюз Kilo AI Gateway предоставляет API, совместимый с OpenAI, поэтому клиент OpenAI направляется на этот адрес, а ключ читается из переменной KILO_API_KEY. Авторизация идёт через заголовок Bearer.

Можно ли работать с локальной моделью без ключа?
Да. Локальные модели через Ollama входят в список поддерживаемых провайдеров, и ключ провайдера для них не нужен. Настройка идёт через Settings → Providers, но на шаге ввода ключа ничего вводить не требуется.