PrimeAPIPrimeAPI

Как подключиться к PrimeAPI

Пошагово и по-человечески. Это OpenAI- и Anthropic-совместимый API: меняешь адрес и ключ в своём инструменте — и пользуешься Claude и GPT. Работает в Claude Code, Cursor, VS Code (Cline) и любом коде.

Claude Code — одной командой

Установит CLI, подставит ключ и запустит. Скопируй → вставь в терминал.

bash / zsh
npm i -g @anthropic-ai/claude-code && \
export ANTHROPIC_BASE_URL=https://api.primeapi.ru && \
export ANTHROPIC_AUTH_TOKEN=sk-ВАШ_КЛЮЧ && \
export ANTHROPIC_MODEL=claude-opus-4.8 && \
export ANTHROPIC_SMALL_FAST_MODEL=claude-haiku-4.5 && \
claude
Сначала создай API-ключ — он автоматически подставится в команду.

Быстрый старт за 3 шага

1. Получи ключ. Войди в @PrimeApi_bot или через сайт → создай API-ключ (начинается с sk-).
2. Пополни баланс. Крипта или СБП, от $0.50. Платишь только за реально использованные токены.
3. Подключи инструмент. Выбери ниже свой (Claude Code, Cursor…) и следуй шагам.

Инструкции по инструментам

Какой формат выбрать

У нас два совместимых API. Один и тот же ключ работает в обоих — выбери под свой инструмент.

OpenAI-формат
https://api.primeapi.ru/v1
  • Авторизация: Authorization: Bearer ВАШ_КЛЮЧ
  • Эндпоинт: POST /v1/chat/completions
  • Инструменты: Cursor, Cline, Continue, Zed, OpenAI SDK
  • Бери его по умолчанию — его понимают почти все инструменты.
Anthropic-формат
https://api.primeapi.ru
  • Авторизация: x-api-key: ВАШ_КЛЮЧ
  • Эндпоинт: POST /v1/messages
  • Инструменты: Claude Code, Anthropic SDK
  • Только для нативных инструментов Anthropic.
Инструмент умеет оба? Бери OpenAI-формат — он шире поддерживается. Claude Code и Anthropic SDK — только Anthropic-формат.

Claude Code

Anthropic-формат

Официальный CLI Anthropic для агентного кодинга в терминале. Подключается одной командой (см. блок вверху).

Рекомендуем: Anthropic-формат — это нативный CLI Anthropic.
  1. Установи Node.js 18+ — скачай с nodejs.org (кнопка LTS).
  2. Используй блок «Claude Code одной командой» вверху страницы — он уже с твоим адресом и ключом.
  3. Либо вручную: установи CLI и задай 4 переменные окружения (адрес, ключ, модели), затем запусти claude в папке проекта.
  4. Чтобы не вводить переменные каждый раз — добавь блок export в ~/.zshrc (Mac) или ~/.bashrc (Linux).
1) Установка (любая ОС)
npm install -g @anthropic-ai/claude-code
2) Mac / Linux (терминал)
export ANTHROPIC_BASE_URL=https://api.primeapi.ru
export ANTHROPIC_AUTH_TOKEN=ВАШ_КЛЮЧ
export ANTHROPIC_MODEL=claude-opus-4.8
export ANTHROPIC_SMALL_FAST_MODEL=claude-haiku-4.5

claude
2) Windows (PowerShell)
$env:ANTHROPIC_BASE_URL=class="text-emerald-400">"https://api.primeapi.ru"
$env:ANTHROPIC_AUTH_TOKEN=class="text-emerald-400">"ВАШ_КЛЮЧ"
$env:ANTHROPIC_MODEL=class="text-emerald-400">"claude-opus-4.8"
$env:ANTHROPIC_SMALL_FAST_MODEL=class="text-emerald-400">"claude-haiku-4.5"

claude

Cursor

OpenAI-формат

AI-редактор. ВАЖНО: имена вроде claude-opus-4.8 Cursor отклоняет («AI Model Not Found») — он принимает только нейтральные алиасы. Вписывай алиас из таблицы ниже, гейтвей сам свяжет его с нужной моделью.

Рекомендуем: В Cursor вписывай НАШ АЛИАС (cursor48, cursorgpt55…), а не claude-opus-4.8. Cursor спокойно принимает алиасы, а наши «настоящие» имена отклоняет.
  1. Нужен план Cursor Pro — бесплатный пробный НЕ работает с кастомным API.
  2. Settings (Ctrl/Cmd + ,) → вкладка «Models».
  3. Вставь свой ключ PrimeAPI в поле «OpenAI API Key».
  4. Включи «Override OpenAI Base URL» и впиши: https://api.primeapi.ru/v1
  5. «Add model» → впиши АЛИАС из таблицы ниже (например cursor48 = Opus 4.8). НЕ вписывай claude-opus-4.8 — Cursor его не примет.
  6. Если раньше добавил claude-opus-4.8 (или другое наше «настоящее» имя) — удали его из списка моделей Cursor.
  7. Выбери алиас — работает и в обычном чате, и в Агенте/Композере (Ctrl/Cmd + I).
Base URL для Cursor
https://api.primeapi.ru/v1
Алиасы для Cursor (впиши ИХ в «Add model»)
cursor48      →  Claude Opus 4.8    (⭐ лучшая для кода)
cursor46s     →  Claude Sonnet 4.6  (быстрее, дешевле)
cursor45h     →  Claude Haiku 4.5   (самая дешёвая)
cursorgpt55   →  GPT-5.5
cursorgpt54   →  GPT-5.4
cursor47      →  Claude Opus 4.7
cursor46      →  Claude Opus 4.6

Cline (VS Code)

OpenAI-формат

Агент-кодер в VS Code. Подключается как OpenAI-совместимый провайдер.

Рекомендуем: OpenAI-формат — выбери провайдера «OpenAI Compatible».
  1. Установи расширение Cline из Marketplace VS Code.
  2. Открой настройки Cline → API Provider → выбери «OpenAI Compatible».
  3. Base URL — адрес ниже; API Key — твой ключ PrimeAPI.
  4. Model ID — например claude-opus-4.8.
Base URL (OpenAI Compatible)
https://api.primeapi.ru/v1

Continue.dev

OpenAI-формат

Ассистент для VS Code и JetBrains. Настраивается через config.json.

Рекомендуем: OpenAI-формат — провайдер «openai» с нашим apiBase.
  1. Установи расширение Continue.
  2. Открой config.json (иконка шестерёнки в панели Continue).
  3. Добавь модель в блок models (см. пример) — provider: openai, apiBase — наш адрес.
  4. Сохрани — модель появится в выпадающем списке Continue.
config.json
{
  class="text-emerald-400">"models": [
    {
      class="text-emerald-400">"title": class="text-emerald-400">"Claude Opus 4.8",
      class="text-emerald-400">"provider": class="text-emerald-400">"openai",
      class="text-emerald-400">"model": class="text-emerald-400">"claude-opus-4.8",
      class="text-emerald-400">"apiBase": class="text-emerald-400">"https://api.primeapi.ru/v1",
      class="text-emerald-400">"apiKey": class="text-emerald-400">"ВАШ_КЛЮЧ"
    }
  ]
}

Aider (CLI)

OpenAI-формат

Терминальный парный программист. Работает по OpenAI-совместимому API.

Рекомендуем: OpenAI-формат — задаётся через переменные окружения.
  1. Установи: pip install aider-install && aider-install (или pipx install aider-chat).
  2. Задай переменные окружения (адрес и ключ) — см. ниже.
  3. Запусти aider с нужной моделью в папке проекта.
Mac / Linux
export OPENAI_API_BASE=https://api.primeapi.ru/v1
export OPENAI_API_KEY=ВАШ_КЛЮЧ

aider --model openai/claude-opus-4.8

OpenAI SDK (Python / Node)

OpenAI-формат

Любой код на OpenAI SDK работает без переписывания — только адрес и ключ.

Рекомендуем: OpenAI-формат — меняешь только base_url и ключ.
  1. Установи SDK: pip install openai (Python) или npm i openai (Node).
  2. Создай клиент с нашим base_url и своим ключом.
  3. Дальше — как обычно: chat.completions.create(...).
Python
from openai import OpenAI

client = OpenAI(base_url=class="text-emerald-400">"https://api.primeapi.ru/v1", api_key=class="text-emerald-400">"ВАШ_КЛЮЧ")
resp = client.chat.completions.create(
    model=class="text-emerald-400">"claude-opus-4.8",
    messages=[{class="text-emerald-400">"role": class="text-emerald-400">"user", class="text-emerald-400">"content": class="text-emerald-400">"Привет!"}],
)
print(resp.choices[0].message.content)
Node.js
import OpenAI from class="text-emerald-400">"openai";

const client = new OpenAI({ baseURL: class="text-emerald-400">"https://api.primeapi.ru/v1", apiKey: class="text-emerald-400">"ВАШ_КЛЮЧ" });
const r = await client.chat.completions.create({
  model: class="text-emerald-400">"claude-opus-4.8",
  messages: [{ role: class="text-emerald-400">"user", content: class="text-emerald-400">"Привет!" }],
});
console.log(r.choices[0].message.content);

Anthropic SDK (Python / Node)

Anthropic-формат

Нативный SDK Anthropic — просто поменяй base_url на наш.

Рекомендуем: Anthropic-формат — base_url без /v1, max_tokens обязателен.
  1. Установи: pip install anthropic (Python) или npm i @anthropic-ai/sdk (Node).
  2. Создай клиент с base_url = наш адрес (без /v1) и своим ключом.
  3. max_tokens обязателен. Эндпоинт — messages.create(...).
Python
from anthropic import Anthropic

client = Anthropic(base_url=class="text-emerald-400">"https://api.primeapi.ru", api_key=class="text-emerald-400">"ВАШ_КЛЮЧ")
resp = client.messages.create(
    model=class="text-emerald-400">"claude-opus-4.8",
    max_tokens=1024,
    messages=[{class="text-emerald-400">"role": class="text-emerald-400">"user", class="text-emerald-400">"content": class="text-emerald-400">"Привет!"}],
)
print(resp.content[0].text)

curl (быстрая проверка)

оба формата

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

Рекомендуем: Любой формат — удобно проверить ключ из терминала.
  1. Подставь свой ключ и выполни команду в терминале.
OpenAI-формат
curl https://api.primeapi.ru/v1/chat/completions \
  -H class="text-emerald-400">"Authorization: Bearer ВАШ_КЛЮЧ" \
  -H class="text-emerald-400">"Content-Type: application/json" \
  -d class="text-emerald-400">'{"model":"claude-opus-4.8","messages":[{"role":"user","content":"Привет!"}]}'
Anthropic-формат
curl https://api.primeapi.ru/v1/messages \
  -H class="text-emerald-400">"x-api-key: ВАШ_КЛЮЧ" \
  -H class="text-emerald-400">"anthropic-version: 2023-06-01" \
  -H class="text-emerald-400">"Content-Type: application/json" \
  -d class="text-emerald-400">'{"model":"claude-opus-4.8","max_tokens":1024,"messages":[{"role":"user","content":"Привет!"}]}'

Доступные модели

Указывай имя модели в поле model. opus — максимум мощности, sonnet — баланс, haiku — самая быстрая и дешёвая.

Загрузка списка…

Основные параметры

modelИмя модели, напр. claude-opus-4.8 (список ниже)
messagesМассив сообщений [{ role, content }] — role: system / user / assistant
max_tokensМаксимум токенов в ответе. Для Anthropic-формата (/v1/messages) обязателен
temperatureКреативность 0–2 (опц.). Не задаёшь — модель решает сама
streamtrue — потоковый ответ (печатает по мере генерации). Рекомендуем — ответ появляется сразу

Коды ошибок

401invalid_api_keyКлюч неверный или отозван — проверь, что скопировал полностью
402insufficient_quotaНедостаточно баланса — пополни счёт в боте
404model_not_foundНеизвестное имя модели — сверься со списком ниже
429rate_limitСлишком много запросов — подожди и повтори
Остались вопросы? Пиши в @PrimeApi_bot — поможем подключиться.