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

Единый API для Anthropic Claude в трёх форматах: OpenAI Chat Completions, OpenAI Responses и Anthropic Messages. Подключайтесь через cURL, Claude Code, OpenCode или любой совместимый SDK — переменными окружения, без переписывания кода.

BASE URL
https://api.scarlex.ru
Работает без VPN в РФ
API KEY
sk-scarlex-•••
1M токенов бесплатно при регистрации
→ Открыть кабинет
СОВМЕСТИМОСТЬ
OpenAI · Anthropic
/chat/completions · /responses · /messages
АВТОРИЗАЦИЯ
Authorization: Bearer KEY
или x-api-key для Anthropic endpoint
↳ ПОЛНАЯ ДОКУМЕНТАЦИЯ

Расширенные гайды по всем IDE и SDK

Cursor · Continue · Cline · Aider · OpenCode · Claude Code · LangChain · Vercel AI SDK — с примерами кода, конфигами под каждую среду и пошаговой настройкой. Доступны в личном кабинете.

Открыть в кабинете →

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

Scarlex — это управляемый шлюз, который понимает и /v1/messages от Anthropic, и /v1/chat/completions от OpenAI. Укажи любой SDK на базу ниже, передай ключ как Authorization: Bearer или x-api-key — этого достаточно.

Базовый URL

URL
https://api.scarlex.ru/v1

Твой API-ключ

KEY
sk-scarlex-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Получи ключ в личном кабинете — 1M токенов в подарок при регистрации.

Hello, world

Скопируй в терминал, чтобы проверить round-trip. В примере используется модель Claude.

cURL
curl https://api.scarlex.ru/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-haiku-3.5",
    "max_tokens": 64,
    "messages": [{"role":"user","content":"Say hi in one word."}]
  }'

Соответствующий SDK-гайд в сайдбаре слева показывает зеркальный запрос для выбранного формата.

Какой гайд подходит под мой кейс?

Чат-приложение на Claude
Anthropic SDK
Чат-приложение на GPT
OpenAI SDK
Терминальный кодинг-ассистент (Claude)
Claude Code
Терминальный ассистент + кастомные модели
OpenCode
VS Code / JetBrains
CursorContinue
Next.js-приложение
Vercel AI SDK
Python RAG / агенты
LangChainLlamaIndex
Простой CLI-редактор
Aider

cURL

Прямой запрос к API. Совместим с форматом OpenAI Chat Completions и Anthropic Messages.

OpenAI-формат

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

Anthropic-формат

cURL · /v1/messages
curl https://api.scarlex.ru/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-4.7",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Привет!"}
    ]
  }'

OpenAI Responses API

Stateless: previous_response_id не поддерживается, передавайте всю историю в input.

cURL · /v1/responses
curl https://api.scarlex.ru/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "claude-opus-4.7",
    "instructions": "Ты лаконичный ассистент.",
    "input": "Объясни замыкания одним предложением."
  }'

Полный гайд по Responses API — в личном кабинете.

Streaming

Добавьте "stream": true — ответ придёт в формате Server-Sent Events.

cURL · SSE
curl https://api.scarlex.ru/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4","stream":true,"messages":[{"role":"user","content":"Hi"}]}'

Claude Code CLI

Подключите Scarlex как провайдер Claude Code через файл настроек — переписывать ничего не нужно.

Путь к файлу

Windows: %USERPROFILE%\.claude\settings.json
macOS / Linux: ~/.claude/settings.json

JSON · settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.scarlex.ru",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-opus-4.7",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-3.5",
    "DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

После сохранения перезапустите Claude Code — все запросы пойдут через Scarlex. Биллинг идёт по лимиту вашего API-ключа.

OpenCode

Создайте opencode.json в корне проекта или в ~/.config/opencode/:

JSON · opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "Scarlex/claude-opus-4.7",
  "provider": {
    "Scarlex": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Scarlex",
      "options": {
        "baseURL": "https://api.scarlex.ru",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "claude-opus-4.7": {
          "name": "Claude Opus 4.7",
          "limit": { "context": 200000, "output": 64000 },
          "variants": { "high": {}, "medium": {}, "low": {} }
        },
        "claude-sonnet-4": {
          "name": "Claude Sonnet 4",
          "limit": { "context": 200000, "output": 64000 }
        },
        "claude-sonnet-4-thinking": {
          "name": "Claude Sonnet 4 Thinking",
          "limit": { "context": 200000, "output": 64000 }
        }
      }
    }
  },
  "plugin": ["oh-my-opencode@latest"]
}

oh-my-opencode

Плагин для OpenCode с мульти-агентной системой. Каждый агент получает свою модель — Sisyphus разруливает делегирование.

1 · Подключите плагин

Добавьте в opencode.json:

JSON
"plugin": ["oh-my-opencode@latest"]

2 · Назначьте модели агентам

Создайте oh-my-opencode.json:

JSON · oh-my-opencode.json
{
  "agents": {
    "sisyphus":   { "model": "SCARLEX/claude-opus-4.7" },
    "oracle":     { "model": "SCARLEX/claude-opus-4.7" },
    "librarian":  { "model": "SCARLEX/claude-sonnet-4" },
    "explore":    { "model": "SCARLEX/claude-sonnet-4" },
    "prometheus": { "model": "SCARLEX/claude-opus-4.6" },
    "metis":      { "model": "SCARLEX/claude-haiku-3.5" },
    "momus":      { "model": "SCARLEX/claude-sonnet-4-thinking" }
  },
  "categories": {
    "ultrabrain": { "model": "SCARLEX/claude-opus-4.7" },
    "quick":      { "model": "SCARLEX/claude-haiku-3.5" },
    "deep":       { "model": "SCARLEX/claude-opus-4.6" }
  }
}

Python и Node SDK

Scarlex полностью совместим с официальным openai SDK — достаточно сменить base_url.

Python

Python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.scarlex.ru/v1",
)

resp = client.chat.completions.create(
    model="claude-opus-4.7",
    messages=[{"role": "user", "content": "Привет!"}],
)
print(resp.choices[0].message.content)

Node.js

TypeScript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://api.scarlex.ru/v1",
});

const resp = await client.chat.completions.create({
  model: "claude-opus-4.7",
  messages: [{ role: "user", content: "Привет!" }],
});

console.log(resp.choices[0].message.content);

Anthropic SDK

Установите ANTHROPIC_BASE_URL=https://api.scarlex.ru и используйте свой Scarlex-ключ как ANTHROPIC_AUTH_TOKEN.

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

Все модели доступны через единый API-ключ. Используйте ID в поле "model" запроса.

Claude Anthropic Claude

Claude Opus 4.7
claude-opus-4.7
Claude Opus 4.6
claude-opus-4.6
Claude Sonnet 4.6
claude-sonnet-4.6
Claude Sonnet 4
claude-sonnet-4
Claude Sonnet 4 Thinking
claude-sonnet-4-thinking
Claude Haiku 3.5
claude-haiku-3.5

Нужна помощь с интеграцией?

Поможем подключиться, разберём ошибки и подскажем подходящий тариф.

Перейти → @scarlex_support