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

Подключите инструмент за минуту.

Любому инструменту нужны две вещи: базовый URL ниже и ваш ключ. Выберите инструмент и следуйте шагам.

Базовый URL · один для всех инструментовhttps://api.tokenlowcost.com/v1
API-ключ · один ключ на модельsk-tlc-…

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

Около минуты
  1. Создать ключ

    В панели выберите модель и нажмите Создать ключ. Сразу скопируйте ключ: он показывается только один раз.

  2. Настройте инструмент

    Найдите свой инструмент ниже. Сразу после создания ключа панель покажет те же шаги с уже подставленным ключом.

  3. Начните работу

    Пользуйтесь инструментом как обычно. Каждый запрос оплачивается с баланса, а панель показывает его стоимость.

Модели

По рейтингу, лучшие — первыми

Каждый ключ работает с одной моделью — той, что вы выбрали при создании. Она отвечает на все запросы с этим ключом, какое бы имя модели ни отправил инструмент. Нужны две модели? Создайте два ключа.

По той же причине GET /v1/models возвращает только модель вашего ключа. Инструменты со списком моделей, например Cline и Roo Code, предложат только её.

Все модели и их цены — на странице цен.

Оплата и лимиты

Предоплата · за токены

Сначала вы пополняете баланс. Новые аккаунты получают приветственный бонус $50 — один на человека. Каждый запрос стоит столько, сколько его токены по цене вашей модели, и эта сумма списывается с баланса. В панели видно каждый запрос с токенами и стоимостью.

Повторный текст дешевле. Если модель недавно видела начало промпта, эти токены оплачиваются по более низкой цене кэша. Инструменты для кода снова и снова отправляют один и тот же контекст, так что экономия большая.

Когда запросы останавливаются

Что случилосьРезультат
Лимит ключа исчерпан402 для этого ключа. Остальные ключи продолжают работать.
Срок ключа истёк403 для этого ключа.
Ключ отозванСразу 401. Это нельзя отменить.
Баланс $0402 для всех ключей, пока вы не пополните баланс. Баланс никогда не уходит в минус.
Аккаунт заблокирован403 для всех ключей, и войти в аккаунт нельзя. Блокируют за нарушение правил.

Контекст и рассуждения

Необязательно, для каждого ключа

При создании ключа можно выбрать и эти две настройки. Диалог покажет, сколько стоит вход промпта, заполняющего выбранное окно.

НастройкаЧто делает
Окно контекстаСколько текста помещается в один запрос: от 128K токенов до максимума модели. Это лимит ключа, сама модель не меняется. Запросы сверх лимита отклоняются и ничего не стоят. Размер оценивается приблизительно, поэтому возможна погрешность в несколько процентов.
Уровень рассужденийНасколько глубоко модель думает перед ответом. При варианте Как в приложении решает ваш инструмент. Фиксированный уровень применяется ко всем запросам с этим ключом. Больше размышлений — больше выходных токенов, а значит, дороже.

Инструкции по настройке в панели передают обе настройки вашему инструменту.

Длинные чаты стоят дороже. Инструменты для кода отправляют весь чат на каждом шаге, поэтому каждый шаг чуть дороже предыдущего, пока инструмент не сократит чат. С меньшим окном контекста это происходит раньше. Некоторые модели также берут больше за очень длинные промпты; с какого размера — видно на странице цен.
Cu

Cursor

Settings → Models
  1. Откройте настройки

    В Cursor откройте Settings → Models и прокрутите вниз до API Keys.

  2. Вставьте ключ и базовый URL

    Вставьте ключ в OpenAI API Key. Включите Override OpenAI Base URL и вставьте базовый URL.

    OpenAI API Key            sk-tlc-your-key
    Override OpenAI Base URL  on
    Base URL                  https://api.tokenlowcost.com/v1
  3. Добавьте имя модели

    Нажмите + Add model, введите имя, например tlc-opus, и включите его. Имя — просто метка: модель определяет ваш ключ. Возьмите имя, которого в Cursor ещё нет, чтобы запрос ушёл с вашим ключом.

  4. Проверьте и общайтесь

    Нажмите Verify рядом с ключом. Затем выберите свою модель в чате.

VS

VS Code

Встроенный чат · без расширений и аккаунта GitHub

Встроенный в VS Code чат может работать с вашим ключом. Нужен VS Code 1.122 или новее. Если при первом запуске VS Code просит войти, нажмите Continue without Signing In.

  1. Добавьте свой эндпоинт

    Нажмите Ctrl + Shift + P (Cmd на Mac) и выполните Chat: Manage Language Models. Нажмите Add Models, затем Custom Endpoint.

  2. Введите имя и ключ

    Назовите его TokenLowCost и вставьте ключ. На шаге API Type просто нажмите Enter.

  3. Вставьте модель

    VS Code откроет файл с пустой моделью. Замените в нём часть "models": [ … ] блоком ниже и сохраните. Панель выдаёт этот блок готовым для вашего ключа сразу после его создания. Копируете отсюда? Берите блок Claude для моделей Claude, другой — для остальных, и поменяйте id и name на свою модель.

    
                  
    
                
  4. Выберите модель

    Откройте чат, нажмите на имя модели в поле ввода и выберите свою модель.

VS Code хранит ключ в защищённом хранилище, а не в файле. Чат работает полностью, включая режим агента. Серые подсказки при наборе текста не поддерживаются: их даёт только GitHub Copilot.

Не вошли в GitHub? Тогда VS Code покажет Set BYOK utility models. Нажмите Configure и выберите Main Agent Model, чтобы названия чатов и сообщения коммитов тоже делала ваша модель. Это небольшие запросы, они оплачиваются как любые другие.

Claude Code или Codex в VS Code

Расширения Claude Code и Codex используют те же настройки, что и их версии для терминала. Сначала вставьте строку для Claude Code или Codex, затем установите расширение и перезапустите VS Code. Для Claude Code также откройте Settings, найдите Claude Code login и отметьте Disable Login Prompt.

CC

Claude Code

Одна строка

Одна строка сохраняет базовый URL, ваш ключ и модель ключа, и каждый новый терминал их подхватывает. Строка ниже — для ключа Claude Opus 5.5, ключ в ней условный. Панель покажет её под ваш ключ: с его моделью, окном контекста и уровнем рассуждений.


          

        
  1. Вставьте строку

    Вставьте её в PowerShell (Windows) или Терминал (macOS, Linux) и нажмите Enter.

  2. Запустите Claude Code

    Запустите claude в том же окне. В первый раз нажимайте Enter на экранах стиля текста и безопасности. Когда он спросит, доверяете ли вы папке, нажмите ↓, чтобы выбрать Yes, I trust this folder, затем Enter: выбранный по умолчанию No, exit закроет Claude Code. Аккаунт Anthropic не нужен.

Ещё нет Claude Code? В PowerShell выполните irm https://claude.ai/install.ps1 | iex, в macOS или Linux — curl -fsSL https://claude.ai/install.sh | bash. Если установщик пишет, что его папки нет в PATH, сделайте то, что он показывает. Если вы работаете в терминале внутри VS Code или Cursor, перезапустите редактор после вставки строки.

Зачем имя модели? Без него Claude Code думает, что общается с Claude Opus 5.5, какая бы модель ни была у ключа. Он так и сообщает модели и подписывает коммиты этим именем. С именем он знает настоящую модель. Если модель не из семейства Claude, Claude Code может написать, что не знает её. Это нормально: по имени он знает только модели Claude, а запросы всё равно работают.

Удобнее через файл? Добавьте это в ~/.claude/settings.json (в Windows — %USERPROFILE%\.claude\settings.json):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.tokenlowcost.com/v1",
    "ANTHROPIC_AUTH_TOKEN": "sk-tlc-your-key",
    "ANTHROPIC_MODEL": "claude-opus-5-5[1m]"
  }
}

Укажите в ANTHROPIC_MODEL модель вашего ключа: claude-opus-5-5, claude-sonnet-5, claude-haiku-4-5, а для других моделей — ID из прайс-листа, например gpt-6-sol. Добавьте в конце [1m], если окно ключа больше 200K.

Claude Code также отправляет небольшие фоновые запросы, например для названий чатов. Они идут на модель вашего ключа и оплачиваются как любые другие.

Cx

Codex

Одна строка

Одна строка записывает файл настроек Codex и сохраняет ваш ключ. Если конфиг Codex уже есть, он сохранится как config.toml.bak. Ключ в этой строке условный; в панели она будет с вашим.


          

        

Вставьте её в PowerShell (Windows) или Терминал (macOS, Linux) и нажмите Enter. Затем запустите codex в том же окне и выберите Trust and continue. Аккаунт ChatGPT не нужен.

Ещё нет Codex? Установите его командой npm install -g @openai/codex. Лучше всего Codex работает с моделями OpenAI, например GPT-6 Sol.

Хотите отредактировать файл сами? Вот что строка записывает в ~/.codex/config.toml. Если добавляете это в существующий файл, первые строки должны стоять выше любой [section].

Codex берёт ключ из переменной окружения TOKENLOWCOST_API_KEY, которую строка тоже задаёт. Задайте её и сами: добавьте export TOKENLOWCOST_API_KEY=sk-tlc-your-key в ~/.zshrc или ~/.bashrc, а в Windows выполните setx TOKENLOWCOST_API_KEY sk-tlc-your-key и откройте новое окно.

Cl

Cline, Roo Code и Continue

Расширения для VS Code и JetBrains

В Cline или Roo Code откройте настройки провайдера и заполните поля ниже. При первом запуске Cline выберите Bring my own API key, чтобы туда попасть. Когда ключ введён, в списке моделей будет только модель вашего ключа — выберите её.

API Provider  OpenAI Compatible
Base URL      https://api.tokenlowcost.com/v1
API Key       sk-tlc-your-key
Model ID      anthropic/claude-opus-5.5

Cline показывает стоимость $0, потому что не знает наших цен. Реальная стоимость — в разделе «Использование» в панели.

Roo Code завис на API Request…? В VS Code 1.122 и новее Roo Code 3.54 не находит инструмент поиска файлов, который VS Code перенёс, с любым провайдером. В этом issue VS Code есть обходное решение. У Cline такой проблемы нет.

Для Continue вставьте это в ~/.continue/config.yaml вместо того, что там есть. Модели там уже есть? Добавьте только запись TokenLowCost в models:. Строка tool_use позволяет режиму Agent редактировать файлы; без неё Continue не поймёт, что у модели есть инструменты.

name: My Config
version: 0.0.1
schema: v1
models:
  - name: TokenLowCost
    provider: openai
    model: tlc-opus
    apiBase: https://api.tokenlowcost.com/v1
    apiKey: sk-tlc-your-key
    capabilities:
      - tool_use

Любой другой инструмент с вариантом OpenAI Compatible настраивается так же.

OA

OpenAI SDK

Python и TypeScript

Укажите базовый URL и ключ. Остальное — обычный код SDK.

from openai import OpenAI

client = OpenAI(
    base_url="https://api.tokenlowcost.com/v1",
    api_key="sk-tlc-your-key",
)

r = client.chat.completions.create(
    model="claude-opus-5.5",
    messages=[{"role": "user", "content": "Hello"}],
)
print(r.choices[0].message.content)
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.tokenlowcost.com/v1",
  apiKey: "sk-tlc-your-key",
});

const r = await client.chat.completions.create({
  model: "claude-opus-5.5",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(r.choices[0].message.content);

Примеры на TypeScript на этой странице — ES-модули: сохраните пример как main.mts и выполните npx tsx main.mts.

Стриминг

Добавьте stream=True. Количество токенов приходит в последнем чанке, в котором может не быть choices, поэтому сначала проверьте chunk.choices.

stream = client.chat.completions.create(
    model="claude-opus-5.5",
    messages=[{"role": "user", "content": "Write a haiku about caching"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices:
        print(chunk.choices[0].delta.content or "", end="")

Responses API тоже работает: client.responses.create(...).

An

Anthropic SDK

Python и TypeScript

Используйте тот же базовый URL, что и везде. SDK добавит к нему /v1/messages, так и должно быть. Некоторые модели присылают блок размышлений перед текстом, поэтому пример выводит только текстовые блоки.

from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.tokenlowcost.com/v1",
    api_key="sk-tlc-your-key",
)

msg = client.messages.create(
    model="claude-opus-5.5",
    max_tokens=512,
    messages=[{"role": "user", "content": "Hello"}],
)
for block in msg.content:
    if block.type == "text":
        print(block.text)
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://api.tokenlowcost.com/v1",
  apiKey: "sk-tlc-your-key",
});

const msg = await client.messages.create({
  model: "claude-opus-5.5",
  max_tokens: 512,
  messages: [{ role: "user", content: "Hello" }],
});
for (const block of msg.content) {
  if (block.type === "text") console.log(block.text);
}
$_

cURL

Обычные HTTP-запросы

Один и тот же ключ работает во всех трёх форматах запросов.

curl https://api.tokenlowcost.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tlc-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-opus-5.5", "messages": [{"role": "user", "content": "Hello"}]}'
curl https://api.tokenlowcost.com/v1/messages \
  -H "x-api-key: sk-tlc-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-opus-5.5", "max_tokens": 256, "messages": [{"role": "user", "content": "Hello"}]}'
curl https://api.tokenlowcost.com/v1/responses \
  -H "Authorization: Bearer sk-tlc-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6-sol", "input": "Hello"}'

Проверить баланс и последние 20 запросов:

curl https://api.tokenlowcost.com/v1/me -H "Authorization: Bearer sk-tlc-your-key"

Ошибки

Что они значат и что делать

Если что-то пошло не так, вы получите код статуса и короткое сообщение.

КодЧто значитЧто делать
401Ключ не указан, неверен или отозван.Проверьте, что вставили ключ целиком.
402Ключ исчерпал лимит расходов или ваш баланс $0.Пополните баланс или создайте ключ с большим лимитом.
403Срок ключа истёк или аккаунт заблокирован. В сообщении сказано, что именно.Если срок истёк, создайте новый ключ. Блокировки описаны в правилах.
400Если в сообщении сказано, что промпт слишком длинный: запрос больше окна контекста ключа. Он не оплачивается.Начните новый чат или используйте ключ с окном побольше.
404Неверный адрес.Проверьте часть после /v1.
ДругиеПередаётся как есть от провайдера модели, например когда он перегружен.Повторите через минуту.

Лимиты расходов и сроки действия задаются для каждого ключа в панели. Баланс — в разделе Оплата.

Готовы подключиться?

Создайте аккаунт, получите $50 на баланс и сделайте первый ключ. Это займёт около минуты.

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