Quick Start

Сделайте свой первый запрос к Ranvik API за 60 секунд. Нужны только API-ключ и одна команда.

1. Получите ключ

Зарегистрируйтесь через Ranvik ID, пополните баланс на 50+ ₽, создайте ключ в кабинете → API-ключи.

2. Подключитесь (SDK)

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    api_key="rk_live_...",
    base_url="https://api.ranvik.ru/v1",
)
resp = client.chat.completions.create(
    model="claude-opus-4",
    messages=[{"role": "user", "content": "Привет!"}],
)
print(resp.choices[0].message.content)

Python (Anthropic SDK)

from anthropic import Anthropic

client = Anthropic(api_key="rk_live_...", base_url="https://api.ranvik.ru")
resp = client.messages.create(
    model="claude-opus-4",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Привет!"}],
)
print(resp.content[0].text)

JavaScript / TypeScript

import OpenAI from "openai";

const client = new OpenAI({
    apiKey: "rk_live_...",
    baseURL: "https://api.ranvik.ru/v1",
});
const r = await client.chat.completions.create({
    model: "gpt-4o",
    messages: [{ role: "user", content: "Привет!" }],
});
console.log(r.choices[0].message.content);

cURL

curl https://api.ranvik.ru/v1/chat/completions \
  -H "Authorization: Bearer rk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4",
    "messages": [{"role":"user","content":"Привет!"}]
  }'

Без SDK — raw HTTP (Go / Rust / PHP)

Эндпоинт ровно тот же что у OpenAI / Anthropic. POST /v1/chat/completions или /v1/messages, заголовок Authorization: Bearer rk_live_... (или x-api-key для Anthropic-формата) и JSON-body. Никакой магии.

Claude Code (CLI от Anthropic)

Linux / macOS:

export ANTHROPIC_BASE_URL=https://api.ranvik.ru
export ANTHROPIC_API_KEY=rk_live_...
export ANTHROPIC_AUTH_TOKEN=rk_live_...
export ANTHROPIC_MODEL=claude-opus-4
export ANTHROPIC_SMALL_FAST_MODEL=claude-haiku-4-5
claude

Windows (PowerShell):

$env:ANTHROPIC_BASE_URL = "https://api.ranvik.ru"
$env:ANTHROPIC_API_KEY = "rk_live_..."
$env:ANTHROPIC_AUTH_TOKEN = "rk_live_..."
$env:ANTHROPIC_MODEL = "claude-opus-4"
$env:ANTHROPIC_SMALL_FAST_MODEL = "claude-haiku-4-5"
claude

Все возможности Claude Code (tool use, file editing, terminal) работают как обычно. ANTHROPIC_MODEL задаёт основную модель, ANTHROPIC_SMALL_FAST_MODEL — дешёвую модель для фоновых задач (заголовки чатов, авто-команды, парсинг). Подходит любая claude-модель или OpenAI-совместимая (gpt-4o, deepseek-v4-pro, minimax-m2-7, grok-*) — формат Anthropic ↔ OpenAI конвертируется автоматически. Модели Gemini через Claude Code пока не работают (используйте их через /v1/chat/completions). Без ANTHROPIC_SMALL_FAST_MODEL фоновые запросы пойдут в дефолтный Haiku. Переопределить основную модель можно флагом --model или командой /model внутри сессии. Оба заголовка ANTHROPIC_API_KEY и ANTHROPIC_AUTH_TOKEN с одним и тем же rk-ключом — Claude Code использует их в разных кодпасах.