PrimeAPIPrimeAPI

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

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

Два формата — выбери под свой инструмент

OpenAI-формат
https://api.primeapi.ru/v1

Cursor, Cline, Roo, OpenAI SDK, почти всё. Эндпоинт /chat/completions.

Anthropic-формат
https://api.primeapi.ru

Claude Code, Anthropic SDK. Эндпоинт /v1/messages.

Один и тот же ключ работает в обоих форматах. Авторизация: заголовок Authorization: Bearer ВАШ_КЛЮЧ или x-api-key: ВАШ_КЛЮЧ.

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

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

Пошагово по инструментам

Claude Code

Anthropic-формат

Официальный CLI от Anthropic для агентного кодинга в терминале.

  1. Установи Node.js 18+ (если ещё нет) — скачай с nodejs.org, кнопка LTS.
  2. Установи Claude Code одной командой (см. ниже).
  3. Задай 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=sk-ВАШ_КЛЮЧ
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">"sk-ВАШ_КЛЮЧ"
$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-редактор кода. Подключается за минуту через OpenAI-формат.

  1. Открой Cursor → Settings (Ctrl/Cmd + ,) → вкладка «Models».
  2. Найди поле «OpenAI API Key», вставь свой ключ sk-…
  3. Включи «Override OpenAI Base URL» и впиши адрес ниже.
  4. Нажми «Add model» и впиши имя модели, напр. claude-opus-4.8 (можно добавить несколько).
  5. Сохрани (Verify) и выбери модель в чате (Ctrl/Cmd + L).
Base URL для Cursor
https://api.primeapi.ru/v1

Cline / Roo Code (VS Code)

OpenAI-формат

Агентные расширения для VS Code. Настройка одинаковая.

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

OpenAI SDK (Python / Node)

OpenAI-формат

Свой код или сервис. Меняешь только base_url и ключ — остальное как у OpenAI.

  1. Установи библиотеку: pip install openai (Python) или npm i openai (Node).
  2. Создай клиент с нашим base_url и своим ключом.
  3. Шли запросы как обычно — модель указываешь по имени бренда.
Python
from openai import OpenAI

client = OpenAI(base_url=class="text-emerald-400">"https://api.primeapi.ru/v1", api_key=class="text-emerald-400">"sk-ВАШ_КЛЮЧ")

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">"sk-ВАШ_КЛЮЧ",
});

const resp = 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(resp.choices[0].message.content);

Anthropic SDK (Python)

Anthropic-формат

Если используешь нативный SDK Anthropic — поменяй base_url на наш.

  1. Установи библиотеку: pip install anthropic.
  2. Создай клиент с нашим base_url (без /v1) и своим ключом.
  3. У Anthropic-формата параметр max_tokens обязателен.
Python
from anthropic import Anthropic

client = Anthropic(base_url=class="text-emerald-400">"https://api.primeapi.ru", api_key=class="text-emerald-400">"sk-ВАШ_КЛЮЧ")

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. Подставь свой ключ вместо sk-ВАШ_КЛЮЧ и выполни команду.
  2. OpenAI-формат — для большинства инструментов. Anthropic-формат — для Claude Code и Anthropic SDK.
OpenAI-формат
curl https://api.primeapi.ru/v1/chat/completions \
  -H class="text-emerald-400">"Authorization: Bearer sk-ВАШ_КЛЮЧ" \
  -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: sk-ВАШ_КЛЮЧ" \
  -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 — поможем подключиться.