ГлавнаяДокументация
Меню документации — Quick Start

Quick Start

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

Совет: наш API совместим с openai и @anthropic-ai/sdk — миграция с прямого вендорского API занимает 5 минут (поменяйте только base_url и ключ).

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
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"
claude

Все возможности Claude Code (tool use, file editing, terminal) работают как обычно. ANTHROPIC_MODEL задаёт модель по умолчанию (можно любую из каталога). Переопределить модель можно флагом --model или командой /model внутри сессии. Мы автоматически конвертируем формат запроса (Anthropic ↔ OpenAI) если нужно. Оба заголовка ANTHROPIC_API_KEY и ANTHROPIC_AUTH_TOKEN с одним и тем же rk-ключом — Claude Code использует их в разных кодпасах.