---
title: Быстрый старт Kimi API: K3 и Kimi for Coding
description: "Быстрый старт Kimi API: первый вызов Kimi K3 или Kimi for Coding через curl или Anthropic SDK — авторизация x-api-key, ID вида kimi/*, скидка 50% от тарифов."
url: https://apitoken.sale/ru/docs/learn/kimi-api-quickstart
language: ru
---

# Быстрый старт Kimi API: первый вызов через curl или Anthropic SDK

Этот быстрый старт по Kimi API проведёт вас от свежего аккаунта до рабочего ответа Kimi K3 примерно за пять минут: один base URL, один заголовок x-api-key, один namespaced model ID. Kimi говорит на протоколе Anthropic Messages на роутере apiToken.sale, поэтому официальный Anthropic SDK работает после замены одного base_url. Тот же предоплатный ключ и баланс покрывают Claude, GPT и Gemini.

## Первый запрос к Kimi в три шага

Самый быстрый путь к первому ответу Kimi — один POST на https://router.apitoken.sale/v1/messages с ключом apiToken.sale в заголовке x-api-key и model ID вида kimi/* в теле запроса. Никакого нового SDK и слоя-адаптера: endpoint говорит на протоколе Anthropic Messages, так что любой клиент, который уже работает с Claude, заработает и с Kimi. Использование списывается с того же предоплатного баланса, что и трафик Claude, GPT и Gemini.

1. Создайте бесплатный аккаунт и выпустите один API-ключ — он выглядит как sk-pool-… и сразу покрывает поддерживаемые модели Claude, GPT, Gemini и Kimi.
2. Пополните баланс на любую целую сумму в долларах картой или криптовалютой; для Kimi не нужен отдельный план или баланс по каждому провайдеру.
3. Экспортируйте ключ как APITOKEN_API_KEY и отправьте запрос ниже. JSON-ответ с content-блоками означает, что маршрут работает.

```
curl https://router.apitoken.sale/v1/messages \
  -H "x-api-key: $APITOKEN_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"kimi/k3-256k","max_tokens":256,"messages":[{"role":"user","content":"Reply with exactly: connected"}]}'
```

Ответ — стандартный объект Anthropic Messages, а терминальный блок usage следует форме Anthropic: счётчики входных и выходных токенов плюс кеш-ветки, — поэтому существующие парсеры usage и учёт расходов продолжают работать без изменений.

## Официальному Anthropic SDK нужен один дополнительный аргумент

Поскольку wire-протокол — Anthropic Messages, официальный Python SDK Anthropic работает без изменений. Его переключают два аргумента конструктора: api_key читает ключ из окружения, а base_url направляет клиент на роутер. Держите ключ в серверной переменной окружения — никогда не в клиентском коде и не в закоммиченном файле.

```
import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["APITOKEN_API_KEY"],
    base_url="https://router.apitoken.sale",
)

message = client.messages.create(
    model="kimi/kimi-for-coding",
    max_tokens=512,
    messages=[{"role": "user", "content": "Reply with exactly: connected"}],
)
print(message.content[0].text)
```

> Передавайте голый корень роутера, без пути: SDK сам добавляет /v1/messages, поэтому base_url, заканчивающийся на /v1, даст запросы на /v1/v1/messages и 404. TypeScript SDK принимает тот же корень как baseURL и сам отправляет заголовки x-api-key и anthropic-version.

Системные промпты, многоходовые истории диалога и тела запросов с tool-use сериализуются точно так же, как против api.anthropic.com, — отличаются только model ID и цена за токен.

## Model ID — это алиасы подписки с опубликованными тарифами

Роутер адресует Kimi через namespaced-алиасы подписки, а GET https://router.apitoken.sale/v1/models — авторитетный список для вашего ключа: доступность может зависеть от ёмкости провайдера и политики аккаунта, поэтому читайте каталог, а не хардкодьте имя из внешней документации.

```
curl https://router.apitoken.sale/v1/models \
  -H "Authorization: Bearer $APITOKEN_API_KEY"
```

| Публичный алиас | Контекст | Официально hit / miss / output | Вы платите со скидкой 50% |
| --- | --- | --- | --- |
| kimi/kimi-for-coding | 256K | $0.19 / $0.95 / $4 | $0.095 / $0.475 / $2 |
| kimi/kimi-for-coding-highspeed | 256K | $0.38 / $1.90 / $8 | $0.19 / $0.95 / $4 |
| kimi/k3-256k | 256K | $0.30 / $3 / $15 | $0.15 / $1.50 / $7.50 |
| kimi/k3 · kimi/k3[1m] | 1M | $0.30 / $3 / $15 | $0.15 / $1.50 / $7.50 |

Цифры — за 1 млн токенов. Kimi делит вход на ветки cache-hit и cache-miss, потому что кеширование у него автоматическое; алиас highspeed стоит ровно вдвое дороже базовых тарифов Kimi for Coding за токен, поэтому оставьте его для задач, где latency действительно важна.

> Не подставляйте официальный ID с Open Platform вроде kimi-k2.7-code. Публичный роутер принимает алиасы подписки, которые показывает GET /v1/models, а официальное название тарифа вернёт ошибку модели, хотя выглядит правильным.

[Полные характеристики моделей и цены со скидкой](/models)

## Те же алиасы работают на OpenAI-совместимом контуре

Если ваш стек построен на OpenAI SDK — или на фреймворке, где форма Chat Completions захардкожена, — поверхность Anthropic вам вообще не нужна. Универсальный контур /v1 роутера отдаёт те же алиасы kimi/* через Chat Completions:

```
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APITOKEN_API_KEY"],
    base_url="https://router.apitoken.sale/v1",
)

completion = client.chat.completions.create(
    model="kimi/kimi-for-coding",
    messages=[{"role": "user", "content": "Reply with exactly: connected"}],
)
print(completion.choices[0].message.content)
```

> Подберите заголовок авторизации под контур: OpenAI-совместимая поверхность /v1 ждёт Authorization: Bearer sk-pool-…, а отправленный туда x-api-key вернёт 401. Поверхность Anthropic Messages — зеркальная: обязателен x-api-key, Bearer отклоняется.

## Учёт использования, стриминг и правила биллинга

- Терминальный usage приходит в форме ответа Anthropic на каждый вызов, поэтому учёт токенов и расходов по запросам не требует изменений.
- У Kimi нет отдельной цены за запись в кеш: только что закешированный токен тарифицируется как cache-miss, а повторный контекст автоматически возвращается по более дешёвой ветке cache-hit.
- Токены рассуждений — подмножество output и тарифицируются по ставке output: отдельным классом токенов они не считаются.
- Маршрут принимает stream: true, но инкрементальность чанков на upstream и публичной границе ещё проходит live-проверку. Если для вашего UX важно время появления чанков, используйте нестриминговый режим.
- Ответ 402 означает, что предоплатный баланс нужно пополнить; списанное использование по каждому запросу видно в дашборде, а общий лимит расходов на ключ ограничивает, сколько может сжечь один ключ.

Каждый вызов тарифицируется по официальным токен-ставкам Kimi из таблицы выше, затем перед списанием с баланса вычитается ваша фиксированная скидка 50% — то же правило биллинга, что действует для Claude, GPT и Gemini на этом ключе.

[Кеш-ветки, маппинг алиасов и контроль расходов в гайде по ценам](/docs/learn/kimi-api-pricing)

## Один ключ подключается к любому кодинг-агенту

Endpoint и ключ, которые вы только что проверили, — те же учётные данные, что используются в настройках кодинг-агентов, поэтому при переходе от скриптов к агентному циклу ничего покупать или провизионировать заново не нужно. У каждого агента свой контракт конфигурации, и для каждого есть отдельный гайд:

- Claude Code нативно говорит на Anthropic Messages — направьте его на роутер и закрепите все внутренние модельные тиры за одним алиасом Kimi.
- Kimi Code принимает OpenAI-совместимый блок провайдера в config.toml и адресует модели как kimi/k3, openai/* или google/* на той же записи.
- OpenCode получает живой каталог роутера, привязанный к ключу, через плагин apiToken.sale, поэтому выведенные алиасы не задерживаются в локальном конфиге.

[Запустите Kimi K3 и Kimi for Coding в Claude Code](/docs/learn/kimi-api-for-claude-code)

[Подключите Kimi Code к единому каталогу](/docs/learn/kimi-api-for-kimi-code)

[Используйте Kimi API в OpenCode](/docs/learn/kimi-api-for-opencode)

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

### Можно ли использовать Anthropic SDK с Kimi?

Да. Направьте его base_url на https://router.apitoken.sale и выберите model ID вида kimi/* из каталога, привязанного к ключу, — импорты, код стриминга и обработка ошибок останутся прежними.

### С какого model ID начать?

Возьмите kimi/kimi-for-coding как экономичный вариант по умолчанию для кода или kimi/k3-256k, когда нужен reasoning K3 без полного окна в 1M. Сначала подтвердите доступность для вашего ключа через GET /v1/models.

### Можно ли передать stream: true на маршруте Kimi?

Маршрут принимает этот параметр, но инкрементальность чанков на upstream и публичной границе ещё проверяется в live-режиме. Если важно время появления чанков, используйте нестриминговый режим.

### Почему роутер отклоняет официальные имена моделей Kimi?

Публичный роутер принимает алиасы подписки из GET /v1/models, а не ID с Open Platform вроде kimi-k2.7-code. Официальное название тарифа вернёт ошибку модели, хотя выглядит правильным.

### Сколько стоит Kimi for Coding за миллион токенов?

Официальные ставки замещения — $0.19 за 1 млн cache-hit токенов, $0.95 за 1 млн cache-miss токенов и $4 за 1 млн output токенов; apiToken.sale берёт половину. Алиас highspeed — ровно вдвое дороже базовых ставок.

### Делит ли Kimi баланс с Claude, GPT и Gemini?

Да. Один ключ sk-pool и один предоплатный баланс покрывают всех четырёх провайдеров; пополняйте на любую целую сумму в долларах картой или криптовалютой, и каждый провайдер будет тратить из общего пула.

---
Get a key: https://apitoken.sale/register
More guides: https://apitoken.sale/ru/docs/learn