# JustCode API — полная документация
# Источник: https://docs.justcode.live   Обновлено: 2026-11-01
# Базовый адрес API: https://api.justcode.live/v1


==============================================================================
СТРАНИЦА: JustCode API — обзор  (https://docs.justcode.live/)
==============================================================================

# JustCode API

JustCode — шлюз доступа к большим языковым моделям. Один ключ открывает модели
**Claude (Anthropic)**, **GPT (OpenAI)**, **Gemini (Google)**, **Grok (xAI)** и
эмбеддинги, причём сразу по двум протоколам: **Anthropic Messages API** и
**OpenAI Chat Completions API**. Менять код под нас не нужно — достаточно
подставить свой адрес и ключ в официальный SDK.

Сервис работает по российскому IP и принимает оплату в рублях. VPN не нужен ни
для установки, ни для работы.

## Базовый адрес

```
https://api.justcode.live/v1
```

Для Claude Code переменная `ANTHROPIC_BASE_URL` задаётся **без** `/v1` —
он дописывает путь сам: `https://api.justcode.live`

## Первый запрос

```bash
curl https://api.justcode.live/v1/messages \
  -H "x-api-key: $JUSTCODE_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Привет"}]
  }'
```

Тот же ключ работает и по протоколу OpenAI:

```bash
curl https://api.justcode.live/v1/chat/completions \
  -H "Authorization: Bearer $JUSTCODE_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "messages": [{"role": "user", "content": "Привет"}]
  }'
```

## Что дальше

- [Быстрый старт](/quickstart) — получить ключ и настроить клиент одной командой
- [Модели и цены](/models) — полный каталог с ценами и окнами контекста
- [Справочник API](/api) — все эндпоинты, параметры, потоковая передача
- [Настройка клиентов](/clients) — Claude Code, Cursor, Codex, Cline, opencode и другие
- [Тарификация](/pricing) — как считаются деньги, кэш промпта
- [Лимиты](/limits) — окна контекста, размер запроса, таймауты
- [Ошибки](/errors) — коды ответов и что с ними делать

## Для ИИ-агентов

Документация доступна в машиночитаемом виде: [/llms.txt](/llms.txt) (индекс),
[/llms-full.txt](/llms-full.txt) (всё одним файлом),
[/openapi.json](/openapi.json) (спецификация API). У каждой страницы есть
markdown-версия — добавьте `.md` к адресу.


==============================================================================
СТРАНИЦА: Быстрый старт  (https://docs.justcode.live/quickstart)
==============================================================================

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

## 1. Получить ключ

Зарегистрируйтесь на [https://justcode.live](https://justcode.live) и пополните баланс. Ключ выдаётся
автоматически после первого пополнения и виден в личном кабинете. Ключ один на
аккаунт и работает со всеми моделями сразу — отдельных ключей на модель нет.

## 2. Настроить клиент

Одна команда находит установленные у вас AI-клиенты и прописывает доступ в них.
Адрес единый, операционная система определяется автоматически.

Windows (PowerShell):

```powershell
iex (irm https://justcode.live/install)
```

macOS и Linux:

```bash
bash -c "$(curl -fsSL https://justcode.live/install)"
```

Скрипт настраивает Claude Code, Codex CLI, Cursor, opencode, aider, Continue,
Zed, Claude Desktop и другие. Подробности — на странице [Настройка клиентов](/clients).

## 3. Или подключиться из кода

Официальный SDK Anthropic:

```python
from anthropic import Anthropic

client = Anthropic(
    base_url="https://api.justcode.live/v1",
    api_key="ВАШ_КЛЮЧ",
)
msg = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Привет"}],
)
print(msg.content[0].text)
```

Официальный SDK OpenAI:

```python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.justcode.live/v1",
    api_key="ВАШ_КЛЮЧ",
)
r = client.chat.completions.create(
    model="gpt-5.6-terra",
    messages=[{"role": "user", "content": "Привет"}],
)
print(r.choices[0].message.content)
```

Node.js:

```javascript
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.justcode.live/v1",
  apiKey: process.env.JUSTCODE_KEY,
});

const r = await client.chat.completions.create({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "Привет" }],
});
console.log(r.choices[0].message.content);
```

Обратите внимание: модели Claude вызываются и через OpenAI-протокол — шлюз сам
переводит формат. Выбирайте протокол по тому, какой SDK вам удобнее.


==============================================================================
СТРАНИЦА: Модели и цены  (https://docs.justcode.live/models)
==============================================================================

# Модели и цены

Цены указаны в долларах за миллион токенов. Списание идёт с баланса в реальном
времени; как именно считаются входные, выходные и кэшированные токены, описано
на странице [Тарификация](/pricing).

Каталог обновляется автоматически: актуальный список всегда доступен запросом
`GET https://api.justcode.live/v1/models` или на [https://justcode.live](https://justcode.live).

## Claude

Флагманская линейка Anthropic. Лучший выбор для агентов и кода: поддерживают инструменты, кэш промпта, расширенные рассуждения.

| Модель | Цена за 1M | Контекст | Максимум выдачи |
|---|---|---|---|
| `claude-opus-5.5` | $0.136 | 1 000 000 | 128 000 |
| `claude-opus-5` | $0.136 | 1 000 000 | 128 000 |
| `claude-opus-4.8` | $0.136 | 1 000 000 | 128 000 |
| `claude-opus-4.7` | $0.136 | 1 000 000 | 128 000 |
| `claude-opus-4.6` | $0.136 | 1 000 000 | 128 000 |
| `claude-opus-4.5` | $0.136 | 1 000 000 | 128 000 |
| `claude-sonnet-5.5` | $0.068 | 1 000 000 | 128 000 |
| `claude-sonnet-5` | $0.068 | 1 000 000 | 128 000 |
| `claude-sonnet-4.6` | $0.068 | 1 000 000 | 128 000 |
| `claude-sonnet-4.5` | $0.068 | 1 000 000 | 128 000 |
| `claude-sonnet-4` | $0.068 | 1 000 000 | 128 000 |
| `claude-haiku-4.5` | $0.041 | 200 000 | 64 000 |
| `claude-fable-5-1` | $0.32 | 1 000 000 | 128 000 |
| `claude-fable-5` | $0.32 | 1 000 000 | 128 000 |

## GPT

Линейка OpenAI GPT-5.6 в трёх ценовых уровнях: sol (максимум), terra (баланс), luna (эконом).

| Модель | Цена за 1M | Контекст | Максимум выдачи |
|---|---|---|---|
| `gpt-6.1-sol` | $0.49 | 260 000 | 128 000 |
| `gpt-6-sol` | $0.39 | 260 000 | 128 000 |
| `gpt-6-astra` | $1.45 | 260 000 | 128 000 |
| `gpt-5.6-sol` | $0.29 | 260 000 | 128 000 |
| `gpt-5.6-terra` | $0.2 | 260 000 | 128 000 |

## Gemini

Модели Google с окном на миллион токенов и низкой ценой.

| Модель | Цена за 1M | Контекст | Максимум выдачи |
|---|---|---|---|
| `gemini-3-flash` | $0.08 | 1 000 000 | 128 000 |
| `gemini-3.1-pro-preview` | $0.2 | 1 000 000 | 128 000 |
| `gemini-3.1-flash-lite` | $0.02 | 1 000 000 | 128 000 |

## Grok

Модель xAI.

| Модель | Цена за 1M | Контекст | Максимум выдачи |
|---|---|---|---|
| `grok-4.5` | $0.08 | 256 000 | 32 000 |
| `grok-4.7` | $0.08 | 256 000 | 32 000 |

## Эмбеддинги

Векторные представления текста для поиска по смыслу, RAG и индексации кодовой базы. Размерность 384, вход до 512 токенов, мультиязычные.

| Модель | Цена за 1M | Вход, токенов |
|---|---|---|
| `jc-embed-multilingual` | $0.02 | 512 |
| `text-embedding-3-small` | $0.02 | 512 |
| `text-embedding-3-large` | $0.02 | 512 |
| `text-embedding-ada-002` | $0.02 | 512 |
| `text-embedding-004` | $0.02 | 512 |
| `gemini-embedding-001` | $0.02 | 512 |

Все имена в таблице обслуживаются одной моделью с размерностью вектора **384**.
Это важно при переносе готовой базы: векторы разных моделей несовместимы, индекс,
построенный на OpenAI (1536 или 3072 измерения), придётся пересчитать.

## Суффиксы имён

К имени модели можно добавить суффикс — он меняет поведение, но не тариф.

| Суффикс | Что делает | Пример |
|---|---|---|
| `[1m]` | Просит окно на миллион токенов. Нужен Claude Code: без суффикса он рисует свои 200K | `claude-opus-5[1m]` |
| `-fast` | Отключает расширенные рассуждения, ответ приходит быстрее | `claude-opus-5-fast` |
| `-thinking-low` … `-thinking-xhigh` | Задаёт объём рассуждений. Так уровень кодирует Cursor | `claude-opus-5-thinking-high` |

Окно на миллион токенов поддерживают: `claude-opus-5.5`, `claude-opus-5`, `claude-opus-4.8`, `claude-opus-4.7`, `claude-opus-4.6`, `claude-opus-4.5`, `claude-sonnet-5.5`, `claude-sonnet-5`, `claude-sonnet-4.6`, `claude-sonnet-4.5`, `claude-sonnet-4`, `claude-fable-5-1`, `claude-fable-5`.

## Привычные имена работают

Знать наши названия не обязательно. Шлюз понимает стандартные имена OpenAI и
Anthropic и разворачивает их в ближайшую свою модель, тарифицируя по её цене:

| Что прислали | Что отработает |
|---|---|
| `gpt-4o`, `gpt-4.1`, `gpt-4o-mini` | `gpt-5.6-terra` |
| `claude-sonnet-4-5-20250929` | `claude-sonnet-4.5` |
| `claude-haiku-4-5` | `claude-haiku-4.5` |
| `claude-3-5-sonnet-20241022` | ближайшая Sonnet |
| `text-embedding-3-small`, `text-embedding-ada-002` | `jc-embed-multilingual` |

Это сделано, чтобы клиенты на настройках по умолчанию не упирались в ошибку
доступа. Если важно точно знать, какая модель отработает, указывайте наше имя
явно.


==============================================================================
СТРАНИЦА: Справочник API  (https://docs.justcode.live/api)
==============================================================================

# Справочник API

Базовый адрес всех вызовов: `https://api.justcode.live/v1`

Шлюз терпим к форме пути: работают `/v1/messages`, `/messages` и даже
`/v1/v1/messages` — клиенты часто дописывают `/v1` сами.

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

Ключ передаётся любым из двух заголовков, оба принимаются на всех эндпоинтах:

```
x-api-key: ВАШ_КЛЮЧ
Authorization: Bearer ВАШ_КЛЮЧ
```

## POST /v1/messages

Anthropic Messages API. Основной путь для Claude Code и агентов на SDK
`anthropic`.

Параметры — как в оригинальном API: `model`, `messages`, `max_tokens`,
`system`, `temperature`, `stream`, `tools`, `tool_choice`, `thinking`,
`stop_sequences`. Поддерживаются блоки `tool_use` и `tool_result`, изображения,
и `cache_control` для кэша промпта.

```bash
curl https://api.justcode.live/v1/messages \
  -H "x-api-key: $JUSTCODE_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 1024,
    "system": "Отвечай кратко.",
    "messages": [{"role": "user", "content": "Что такое вектор?"}],
    "stream": true
  }'
```

При `"stream": true` ответ приходит событиями Server-Sent Events:
`message_start`, `content_block_start`, `content_block_delta`, `message_delta`,
`message_stop`, между ними — служебные `ping`.

## POST /v1/chat/completions

OpenAI Chat Completions API. Через него доступны **все** модели, включая Claude
и Gemini: шлюз переводит формат в обе стороны.

Параметры: `model`, `messages`, `max_tokens`, `temperature`, `top_p`, `stream`,
`tools`, `tool_choice`, `reasoning_effort`, `stop`.

```bash
curl https://api.justcode.live/v1/chat/completions \
  -H "Authorization: Bearer $JUSTCODE_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [
      {"role": "system", "content": "Отвечай кратко."},
      {"role": "user", "content": "Что такое вектор?"}
    ],
    "stream": true
  }'
```

## POST /v1/responses

OpenAI Responses API — им ходит Codex CLI. Шлюз сам подставляет набор
инструментов, если клиент прислал пустой `tools`: без этого Codex не может
править файлы, потому что рассчитывает получить обвес от сервера.

## POST /v1/embeddings

Векторные представления, формат OpenAI.

```bash
curl https://api.justcode.live/v1/embeddings \
  -H "Authorization: Bearer $JUSTCODE_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": ["первый текст", "второй текст"]
  }'
```

Ответ:

```json
{
  "object": "list",
  "data": [
    {"object": "embedding", "index": 0, "embedding": [0.01, -0.03, "..."]}
  ],
  "model": "jc-embed-multilingual",
  "usage": {"prompt_tokens": 14, "total_tokens": 14}
}
```

Размерность вектора 384. Массивы токенов на входе не поддерживаются — передавайте
текст. За один запрос принимается до 256 текстов.

## GET /v1/models

Каталог доступных моделей с размерами окон.

```bash
curl https://api.justcode.live/v1/models -H "Authorization: Bearer $JUSTCODE_KEY"
```

## POST /v1/messages/count_tokens

Оценка размера запроса до отправки. Считается локально и отвечает за
миллисекунды, деньги не списываются.

## Потоковая передача

Потоковый режим рекомендуется для любых длинных ответов. При выключенном
стриминге клиент ждёт весь ответ молча, и мобильные сети успевают разорвать
простаивающее соединение. Если видите обрывы на длинных ответах — включите
`stream`.


==============================================================================
СТРАНИЦА: Настройка клиентов  (https://docs.justcode.live/clients)
==============================================================================

# Настройка клиентов

Проще всего — [установщик одной командой](/quickstart): он сам находит
установленные клиенты и прописывает адрес с ключом. Ниже — ручная настройка для
тех, кому нужен контроль.

## Claude Code

Подписка Anthropic не нужна: она заменяется нашим ключом.

Файл `~/.claude/settings.json` (Windows: `C:\Users\ИМЯ\.claude\settings.json`):

```json
{
  "model": "claude-opus-5[1m]",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.justcode.live",
    "ANTHROPIC_AUTH_TOKEN": "ВАШ_КЛЮЧ",
    "ANTHROPIC_MODEL": "claude-opus-5[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
  }
}
```

Два важных момента. Адрес здесь **без** `/v1` — Claude Code дописывает
`/v1/messages` сам. Суффикс `[1m]` обязателен, иначе интерфейс покажет окно
200K вместо миллиона.

Если раньше вы входили в Claude Code аккаунтом Anthropic, выполните `/logout` —
иначе он продолжит ходить по сохранённому токену. Проверить активный адрес
можно командой `/status`.

## Codex CLI

`~/.codex/config.toml`:

```toml
model = "gpt-5.6-terra"
model_provider = "justcode"

[model_providers.justcode]
name = "JustCode"
base_url = "https://api.justcode.live/v1"
wire_api = "responses"
requires_openai_auth = true
```

Ключ кладётся в `~/.codex/auth.json`:

```json
{"auth_mode": "apikey", "OPENAI_API_KEY": "ВАШ_КЛЮЧ"}
```

## Cursor

Нужен платный тариф Cursor: на бесплатном выбор модели заблокирован его
собственным ограничением («Free plans can only use Auto»), и обойти это со
стороны ключа нельзя.

1. Settings → Models
2. Включить **Override OpenAI Base URL**, вписать `https://api.justcode.live/v1`
3. В **OpenAI API Key** вставить ключ (название поля говорит «OpenAI», но запрос
   уйдёт к нам)
4. **Выключить все модели Cursor в списке сверху** — иначе проверка ключа уходит
   на их серверы. Этот шаг пропускают чаще всего
5. **+ Add Custom Model**, вписать имя, например `claude-opus-5`

Через ключ работают чат и агент. Tab-автодополнение и Ctrl+K всегда идут через
собственный бэкенд Cursor и ключом не переключаются.

## Cline, Roo Code, Kilo Code

API Provider — **OpenAI Compatible**, Base URL — `https://api.justcode.live/v1`, API Key — ваш ключ,
Model ID — любое имя из [каталога](/models).

## opencode

`~/.config/opencode/opencode.json`:

```json
{
  "provider": {
    "justcode": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "JustCode",
      "options": { "baseURL": "https://api.justcode.live/v1", "apiKey": "ВАШ_КЛЮЧ" },
      "models": { "claude-opus-5": { "name": "claude-opus-5" } }
    }
  }
}
```

## Zed

Settings → `language_models.openai`: `api_url` — `https://api.justcode.live/v1`, ключ в переменной
окружения `OPENAI_API_KEY`.

## aider

`~/.aider.conf.yml`:

```yaml
openai-api-base: https://api.justcode.live/v1
openai-api-key: ВАШ_КЛЮЧ
model: openai/claude-opus-5
```

## Continue

В `~/.continue/config.json` добавьте модель с `provider: "openai"`,
`apiBase: "https://api.justcode.live/v1"` и вашим ключом.

## ChatBox, Cherry Studio, Jan, LM Studio, AnythingLLM

Все они настраиваются одинаково: выбрать провайдера «OpenAI API Compatible»
(в ChatBox можно выбрать и режим Claude), вписать адрес `https://api.justcode.live/v1` и ключ.

## Своё приложение

Подойдёт любой официальный SDK — см. примеры в [быстром старте](/quickstart).


==============================================================================
СТРАНИЦА: Тарификация  (https://docs.justcode.live/pricing)
==============================================================================

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

Деньги списываются с баланса по факту потребления, никаких подписок и абонентской
платы нет. Неизрасходованный баланс не сгорает.

## Категории токенов

Токены одного запроса делятся на четыре категории, и у каждой своя ставка.
Цена в [каталоге](/models) — это базовая ставка, по ней тарифицируется чтение
кэша; вход дороже, выход дороже всего. Так устроено ценообразование у самих
вендоров: генерация стоит кратно дороже чтения.

Действующие ставки в долларах за миллион токенов (на 31.10.2026; точная цена
любой модели — в [каталоге](/models)):

| Модель | Вход | Чтение кэша | Запись кэша | Выход |
|---|---|---|---|---|
| `claude-opus-5` | 0.289 | 0.136 | 0.361 | 1.444 |
| `claude-sonnet-5` | 0.116 | 0.068 | 0.144 | 0.578 |
| `gpt-5.6-sol` | 0.400 | 0.290 | 0.500 | 2.000 |
| `gemini-3-flash` | 0.130 | 0.080 | 0.080 | 0.650 |

## Кэш промпта экономит деньги

Чтение из кэша дешевле свежего входа примерно в десять раз. В агентских
сессиях, где одна и та же история отправляется каждый ход, это основная статья
экономии.

Шлюз **сам расставляет точки кэширования**, если клиент их не прислал: конец
системного промпта и конец предпоследнего сообщения. Ничего настраивать не надо
— достаточно вести диалог в одной сессии. Если ваш клиент проставляет
`cache_control` сам (так делает Claude Code), мы его разметку не трогаем.

Запросы короче примерно трёх тысяч токенов не кэшируются: запись кэша стоит
дороже обычного входа, и на мелочи это была бы переплата.

Кэш живёт на конкретном аккаунте вышестоящего провайдера, поэтому шлюз
закрепляет беседу за одним и тем же каналом — иначе кэш терялся бы на каждом
ходу.

## Пополнение

Пополнить баланс можно в личном кабинете на [https://justcode.live](https://justcode.live) — картой,
криптовалютой и другими способами. Суммы на балансе хранятся в долларах, при
оплате рублями курс берётся из данных Центробанка.

Бонусные начисления (промокоды, реферальные) тратятся на модели наравне с
обычными деньгами, но не выводятся.

## Реферальная программа

Приглашающий получает процент с **каждого** пополнения приглашённого, а не
только с первого. Ссылка и статистика — в разделе кабинета «Приглашайте друзей».

## Изображения

Запросы с картинками обслуживаются отдельным, более дорогим каналом, поэтому к
ним применяется наценка. Документы (PDF, Word) в изображения не входят и пока не
поддерживаются.


==============================================================================
СТРАНИЦА: Лимиты  (https://docs.justcode.live/limits)
==============================================================================

# Лимиты

## Окна контекста

Размер окна зависит от модели — точные значения в [каталоге](/models) и в ответе
`GET https://api.justcode.live/v1/models`. Ориентиры: Claude старших версий и Gemini держат миллион
токенов, GPT-5.6 — 260 тысяч, Grok — 256 тысяч, эмбеддинги принимают 512 токенов
на текст.

Значения намеренно консервативны. Завышать их нельзя: клиент набьёт контекст до
объявленного размера и получит отказ посреди сессии.

Чтобы Claude Code показывал и использовал миллион, имя модели должно быть с
суффиксом `[1m]` — см. [Модели](/models).

## Скорость запросов

Ограничений по числу запросов в минуту или токенов в минуту на клиентских ключах
**нет**. Практический потолок задаёт вышестоящий провайдер; при пиковой нагрузке
шлюз сам распределяет запросы по пулу каналов.

## Размер запроса

На адресе `api.justcode.live` принимается тело до 100 МБ. Старый адрес
`justcode.live/v1` проходит через защитный прокси, который режет запросы тяжелее
примерно 12 МБ.

## Таймауты

На `api.justcode.live` ограничения на длительность ответа нет — длинный ход
дождётся конца. На `justcode.live` защитный прокси разрывает соединение, если
ответ не начал приходить за 120 секунд, поэтому для больших контекстов и
медленного канала используйте `api.`-адрес. Установщик прописывает его сам.

## Что делать с очень большим контекстом

Модели принимают сотни тысяч токенов, но чем больше контекст, тем дороже и
медленнее каждый ход. Если агент раздул историю до сотен тысяч токенов, дешевле
начать новую сессию или сжать контекст средствами клиента (в Claude Code —
команда `/compact`).


==============================================================================
СТРАНИЦА: Ошибки  (https://docs.justcode.live/errors)
==============================================================================

# Ошибки

Ошибки возвращаются в формате того протокола, по которому пришёл запрос. При
потоковой передаче ошибка, случившаяся после начала ответа, приходит событием
внутри потока.

## 401 — ключ не принят

Ключ неверный, отозван или передан не тем заголовком. Проверьте, что ключ
скопирован целиком и стоит в `x-api-key` либо `Authorization: Bearer`.

Отдельный случай: клиент раньше входил аккаунтом Anthropic или OpenAI и ходит по
сохранённому токену вместо нашего. В Claude Code лечится командой `/logout`.

## 403 — модель недоступна для ключа

Имя модели не входит в список разрешённых. Обычно это опечатка либо совсем
незнакомое имя. Проверьте список: `GET https://api.justcode.live/v1/models`. Большинство привычных
чужих имён мы принимаем — см. [псевдонимы](/models).

## 400 — запрос слишком длинный

Контекст превысил окно модели. Сожмите историю или возьмите модель с большим
окном (см. [Лимиты](/limits)). Перебор источников в этом случае не делается:
ошибка в самом запросе, и повтор её не исправит.

## 402 — недостаточно средств

Баланс исчерпан. Пополните его в кабинете на [https://justcode.live](https://justcode.live).

## 502 — источник вернул некорректный ответ

Вышестоящий провайдер оборвал поток или вернул пустой ответ. Шлюз уже перебрал
доступные каналы и не нашёл рабочего. Обычно это кратковременно — повторите
запрос. Ответ без единого токена мы клиенту не отдаём и денег за него не берём.

## 524 или обрыв на середине длинного ответа

Соединение разорвал защитный прокси домена `justcode.live` (потолок 120 секунд).
Перейдите на `api.justcode.live` — там этого потолка нет. Установщик прописывает
правильный адрес автоматически.

## Ответ приходит, но пустой

Такое бывает, когда клиент работает с выключенным стримингом на нестабильной
сети. Включите потоковый режим: он же решает проблему с длинными ответами.

## Куда писать

Если ошибка повторяется — поддержка в личном кабинете на
[https://justcode.live](https://justcode.live). Полезно приложить точное время запроса, имя модели и текст
ошибки: по ним запрос находится в логах.


==============================================================================
СТРАНИЦА: Вопросы и ответы  (https://docs.justcode.live/faq)
==============================================================================

# Вопросы и ответы

## Нужен ли VPN?

Нет. Сервис доступен по российскому IP напрямую. Более того, некоторые VPN режут
длинные потоковые соединения и мешают работе.

## Нужна ли подписка Anthropic или OpenAI?

Нет. Наш ключ заменяет их подписку в клиентах вроде Claude Code и Codex. Мы даём
доступ к моделям; лицензию на сам редактор (например, платный тариф Cursor) это
не заменяет.

## Один ключ на все модели?

Да. Ключ выдаётся один на аккаунт и открывает весь каталог сразу.

## Оба протокола на одном ключе?

Да. Anthropic Messages API и OpenAI Chat Completions API работают одновременно,
на одном адресе и одном ключе. Модели Claude доступны через OpenAI-протокол, и
наоборот.

## Что с моими данными?

Запросы проксируются к вышестоящим провайдерам для получения ответа. Мы храним
метаданные для биллинга: время, модель, количество токенов, стоимость. Их видно
в кабинете, в разделе истории запросов.

## Можно ли перевыпустить ключ?

Да, если ключ утёк. Напишите в поддержку в кабинете — старый ключ сразу
перестанет работать, и во всех клиентах нужно будет прописать новый.

## Поддерживаются ли инструменты и function calling?

Да, в обоих протоколах. Блоки `tool_use` и `tool_result` в Anthropic-формате и
`tools`/`tool_calls` в OpenAI-формате поддерживаются полностью, включая
потоковый режим.

## Работают ли картинки?

Да, на моделях Claude. Отправляйте их стандартными блоками `image` (Anthropic)
или `image_url` (OpenAI). Документы PDF и Word пока не поддерживаются.

## Есть ли эмбеддинги?

Да, см. [каталог](/models) и [справочник API](/api). Размерность 384, вход до
512 токенов, модель мультиязычная.