# Обзор API

> Базовый URL, аутентификация и быстрые примеры подключения на Python, Node.js и curl для API LLMoxy.

LLMoxy предоставляет полностью совместимый интерфейс Anthropic Messages API. Достаточно изменить базовый URL, чтобы без проблем использовать официальный SDK.

## Базовый URL

```txt
https://llmoxy.com/v1
```

> **ПОДСКАЗКА**
> Инструменты вроде Claude Code используют адрес **без** `/v1`, то есть `https://llmoxy.com`. Вызовы SDK включают `/v1`.

## Аутентификация

### Способ 1: x-api-key (рекомендуется)

```http
x-api-key: YOUR_API_KEY
```

### Способ 2: Authorization

```http
Authorization: Bearer YOUR_API_KEY
```

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

### Python

```python
from anthropic import Anthropic

client = Anthropic(
api_key="YOUR_API_KEY",
base_url="https://llmoxy.com/v1"
)

message = client.messages.create(
model="claude-opus-5-5",
max_tokens=1024,
messages=[
{"role": "user", "content": "Привет!"}
]
)

print(message.content[0].text)
```

### Node.js

```js
import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
apiKey: 'YOUR_API_KEY',
baseURL: 'https://llmoxy.com/v1'
});

const message = await client.messages.create({
model: 'claude-opus-5-5',
max_tokens: 1024,
messages: [
{ role: 'user', content: 'Привет!' }
]
});

console.log(message.content[0].text);
```

### Совместимость с OpenAI (Chat Completions)

#### curl

```bash
curl https://llmoxy.com/v1/chat/completions \
  -H "Authorization: Bearer <LLMOXY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "messages": [
      { "role": "user", "content": "Say hello in one short sentence." }
    ]
  }'
```

#### TypeScript

```ts
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.LLMOXY_API_KEY,
  baseURL: "https://llmoxy.com/v1",
});

const response = await client.chat.completions.create({
  model: "grok-4.7",
  messages: [{ role: "user", content: "Write a haiku about routers." }],
});

console.log(response.choices[0]?.message?.content);
```

#### Python

```py
from openai import OpenAI

client = OpenAI(
    api_key="<LLMOXY_API_KEY>",
    base_url="https://llmoxy.com/v1",
)

response = client.chat.completions.create(
    model="grok-4.7",
    messages=[{"role": "user", "content": "Write a haiku about routers."}],
)

print(response.choices[0].message.content)
```

## Потоковый вывод

Установите `stream: true` в запросах Chat или Responses, и LLMoxy вернёт поток SSE, совместимый с OpenAI.

```bash
curl https://llmoxy.com/v1/chat/completions \
  -H "Authorization: Bearer <LLMOXY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "stream": true,
    "messages": [
      { "role": "user", "content": "Count from one to five." }
    ]
  }'
```

## Поддерживаемые модели

### Серия Claude (доступные группы: Claude)

| Модель | Описание |
| --- | --- |
| claude-fable-5-2 | Максимальная производительность |
| claude-opus-5-5 | Сбалансированный выбор |

### Серия Gemini (доступная группа: Gemini)

| Модель | Описание |
| --- | --- |
| gemini-4-argon | Максимальная производительность |
| gemini-3.8-flash | Быстрый ответ |

> **Актуальный список моделей**
> Точный список доступных моделей см. на [официальной площадке](https://llmoxy.com/).

## Тарификация

Оплата по фактическому расходу токенов (включая запись и чтение кэша). Цены различаются в зависимости от модели. Подробности см. в разделе [Группы и тарифы](https://ru.llmoxy.com/docs/get-started/recharge-and-pricing).

## Следующие шаги

- [Формат Anthropic](https://ru.llmoxy.com/docs/api-reference/anthropic-format) — параметры запроса, формат ответа, примеры кода
- [Chat Completions](https://ru.llmoxy.com/docs/api-reference/chat-completions) — формат запросов, совместимый с OpenAI
- [Маршрутизация, тарификация и ошибки](https://ru.llmoxy.com/docs/api-reference/routing-billing-errors) — узнайте о стоимости и кодах ошибок

Это markdown-версия страницы https://ru.llmoxy.com/docs/api-reference/api-overview.
