Весело
Весело

Claude Code и формат Anthropic

Claude Code и SDK Anthropic на открытых моделях за рубли: адрес https://veselo.ai, ключ sk-vsl-… и метод POST /v1/messages в формате Anthropic Messages.

Обновлено:

Программы, которые говорят с нейросетью в формате Anthropic Messages, — Claude Code, SDK Anthropic для Python и JavaScript и другие — работают с Весело без доработок. Им нужны адрес https://veselo.ai, ключ sk-vsl-… и id текстовой модели из списка. Метод — POST https://veselo.ai/v1/messages.

Моделей Claude у нас нет: Anthropic не работает с Россией. Формат тот же, а отвечают открытые модели из каталога — например deepseek/deepseek-v4.1-flash-ultrafast. Запрос с моделью claude-… вернёт 404 model_not_found.

Claude Code

  1. Выпусти в кабинете отдельный ключ для Claude Code и поставь ему месячный лимит: каждый шаг Claude Code — платный запрос.
  2. Пополни API-счёт.
  3. Задай переменные окружения, как в примере ниже, и запусти claude в том же терминале. Или впиши их в блок env файла ~/.claude/settings.json — тогда они действуют всегда.

Терминал

export ANTHROPIC_BASE_URL="https://veselo.ai"
export ANTHROPIC_AUTH_TOKEN="$VESELO_API_KEY"
export ANTHROPIC_API_KEY=""
export ANTHROPIC_MODEL="deepseek/deepseek-v4.1-flash-ultrafast"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek/deepseek-v4.1-flash-ultrafast"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek/deepseek-v4.1-flash-ultrafast"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek/deepseek-v4.1-flash-ultrafast"
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek/deepseek-v4.1-flash-ultrafast"
export CLAUDE_CODE_MAX_CONTEXT_TOKENS="1048576"
claude

settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://veselo.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-vsl-…",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_MODEL": "deepseek/deepseek-v4.1-flash-ultrafast",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek/deepseek-v4.1-flash-ultrafast",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek/deepseek-v4.1-flash-ultrafast",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek/deepseek-v4.1-flash-ultrafast",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek/deepseek-v4.1-flash-ultrafast",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "1048576"
  }
}
  • ANTHROPIC_BASE_URL — без /v1 на конце: Claude Code сам допишет /v1/messages.
  • ANTHROPIC_AUTH_TOKEN — ключ sk-vsl-…, Claude Code передаёт его в заголовке Authorization: Bearer. Пустой ANTHROPIC_API_KEY нужен, чтобы вместо нашего ключа не ушёл другой — например, ключ Anthropic из твоих переменных окружения.
  • Модели — во всех пяти переменных: Claude Code зовёт и «быструю» модель для фоновых задач, и модели помощников. Если какую-то не задать, её запросы уйдут к модели Claude и получат 404 model_not_found.
  • Модели можно взять разные: посильнее — в ANTHROPIC_MODEL, подешевле — в ANTHROPIC_DEFAULT_HAIKU_MODEL. Цены — в каталоге.
  • CLAUDE_CODE_MAX_CONTEXT_TOKENS — сколько токенов модель помнит. Наших моделей Claude Code не знает: он предупредит об этом и будет считать, что их контекст — 200 000 токенов. У DeepSeek V4.1 Flash Ultrafast — 1 048 576. С верным числом Claude Code вовремя сожмёт разговор, а иначе длинная сессия упрётся в ошибку 400. У других моделей число своё.

Claude Code просит ответ до 32 000 токенов, и на время каждого шага удерживается цена такого ответа. Если модель отвечает 400 из-за длины ответа или хочется удерживать меньше, задай CLAUDE_CODE_MAX_OUTPUT_TOKENS, например 8192. Если потолок ответа модели известен (max_output_tokens в GET https://veselo.ai/v1/models), сервер сам уменьшает до него слишком большой max_tokens.

Цену в /cost Claude Code считает сам, по ценам моделей Claude, — с нашей она не совпадает. Сколько стоил запрос на самом деле — usage.cost_rub и расход в кабинете.

Что не работает. Поиск в интернете (WebSearch) Claude Code делает инструментом сервера Anthropic — у нас таких инструментов нет, запрос с ним получит 400 invalid_request. PDF модели не получают: вместо документа в разговор встаёт пометка, что его нет; текст и картинки проходят. Подсчёта токенов (/v1/messages/count_tokens) нет — ответ 404.

MCP-сервер Весело — другое: Claude Code остаётся на своей модели и через MCP сам снимает видео, рисует картинки и спрашивает наши модели. Как подключить — MCP-сервер.

Запрос

POST https://veselo.ai/v1/messages. Ключ — в x-api-key: sk-vsl-…, как у SDK Anthropic, или в Authorization: Bearer sk-vsl-…. Заголовок anthropic-version принимаем любой, но он не обязателен; anthropic-beta не учитываем.

ПолеЧто с ним делаем
modelобязательно: id текстовой модели из GET /v1/models
max_tokensобязательно: потолок длины ответа, от него зависит удержание; больше max_output_tokens модели — уменьшаем до него
messagesроли user, assistant и system; content — строка или блоки text, image (base64 или url), document с текстом, tool_use, tool_result, thinking
systemстрока или блоки text
streamответ потоком SSE в формате Anthropic
temperature, top_p, top_kпередаём модели
stop_sequencesна чём остановиться
toolsсвои инструменты с input_schema; инструменты сервера Anthropic (web_search, code_execution и другие) — 400
tool_choiceauto, any, tool, none и disable_parallel_tool_use
thinkingenabled или adaptive: рассуждения модели, если она их пишет, приходят блоками thinking. Длину рассуждений поле не задаёт — модели думают по-своему
providerнаше поле — выбор провайдера модели, как в разделе Провайдеры

Прочие поля — metadata, cache_control, service_tier и другие — принимаем, но нейросети не передаём. Блоки thinking из прошлых ответов тоже не передаём: нашим моделям их не прочитать. Вместо PDF и других файлов в document модель видит пометку. mcp_servers — 400: MCP-серверы из запроса мы не подключаем.

Сообщения system в середине разговора (так делает Claude Code) многие модели не принимают, поэтому они доходят до модели текстом в сообщении user, в тегах <system-reminder>. Сообщения одной роли подряд склеиваем в одно — так делает и Anthropic.

Ответ

Сообщение Anthropic: id вида msg_req_…, в content — блоки text, tool_use и, если включён thinking, thinking. stop_reason — end_turn, max_tokens, tool_use или refusal (отказ фильтра); stop_sequence — если модель сообщила, на какой строке из stop_sequences остановилась. В usage — input_tokens (без входа из кэша), cache_read_input_tokens, output_tokens и цена в рублях cost_rub; без потока та же цена — в заголовке x-veselo-cost-rub.

curl

curl https://veselo.ai/v1/messages \
  -H "x-api-key: $VESELO_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4.1-flash-ultrafast",
    "max_tokens": 300,
    "messages": [{"role": "user", "content": "Объясни в двух предложениях, что такое API."}]
  }'

Python

import os
import anthropic  # pip install anthropic

client = anthropic.Anthropic(base_url="https://veselo.ai", api_key=os.environ["VESELO_API_KEY"])
msg = client.messages.create(
    model="deepseek/deepseek-v4.1-flash-ultrafast",
    max_tokens=300,
    messages=[{"role": "user", "content": "Объясни в двух предложениях, что такое API."}],
)
print("".join(b.text for b in msg.content if b.type == "text"))

JavaScript

import Anthropic from '@anthropic-ai/sdk'; // npm i @anthropic-ai/sdk

const client = new Anthropic({ baseURL: 'https://veselo.ai', apiKey: process.env.VESELO_API_KEY });
const msg = await client.messages.create({
  model: 'deepseek/deepseek-v4.1-flash-ultrafast',
  max_tokens: 300,
  messages: [{ role: 'user', content: 'Объясни в двух предложениях, что такое API.' }],
});
console.log(msg.content.filter((b) => b.type === 'text').map((b) => b.text).join(''));

Ответ

{
  "id": "msg_req_6f1c…",
  "type": "message",
  "role": "assistant",
  "model": "deepseek/deepseek-v4.1-flash-ultrafast",
  "content": [{ "type": "text", "text": "API — это способ, которым одна программа просит другую что-то сделать…" }],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 18,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 64,
    "cost_rub": 0.01
  }
}

SDK Anthropic сами дописывают /v1/messages к адресу, поэтому в base_url — https://veselo.ai без /v1.

Поток

С stream: true ответ идёт событиями Anthropic: message_start; затем блоки — content_block_start, content_block_delta (text_delta, thinking_delta, input_json_delta) и content_block_stop; потом message_delta с stop_reason и usage и в конце message_stop. Цена в рублях — usage.cost_rub в message_delta. Если долго нет новых событий — например, модель думает молча, — приходят события ping.

Аргументы инструмента приходят одним куском input_json_delta, когда модель дописала вызов. Ошибка посреди потока — событие error, после него событий нет. Оборванный поток стоит столько, сколько модель успела написать, — как у стриминга в формате OpenAI.

Python

with client.messages.stream(
    model="deepseek/deepseek-v4.1-flash-ultrafast",
    max_tokens=1000,
    messages=[{"role": "user", "content": "Напиши короткое стихотворение о Москве."}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

События

event: message_start
data: {"type":"message_start","message":{"id":"msg_req_6f1c…","type":"message","role":"assistant","model":"deepseek/deepseek-v4.1-flash-ultrafast","content":[],"stop_reason":null,"stop_sequence":null,"usage":{"input_tokens":0,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":0}}}

event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"text","text":""}}

event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"Москва"}}

event: content_block_stop
data: {"type":"content_block_stop","index":0}

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{"input_tokens":21,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":48,"cost_rub":0.01}}

event: message_stop
data: {"type":"message_stop"}

В message_start токенов ещё нет — настоящие числа приходят в message_delta, когда модель закончила.

Ошибки

Ошибки /v1/messages — в формате Anthropic, SDK Anthropic понимают их без доработок. Коды и тексты — те же, что в разделе Ошибки: постоянный code лежит внутри error, рядом — param и поля вроде required_rub. Тип — как у Anthropic: 402 — billing_error, 413 — request_too_large, 503 model_unavailable — overloaded_error, 504 — timeout_error.

Ответ 402

{
  "type": "error",
  "error": {
    "type": "billing_error",
    "message": "Не хватает денег на балансе для этого запроса.",
    "code": "insufficient_balance",
    "required_rub": 1.37,
    "available_rub": 0,
    "topup_url": "https://veselo.ai/developer/wallet"
  },
  "request_id": "req_6f1c…"
}

Деньги и лимиты — как у /chat/completions: удержание по max_tokens, списание по факту, ошибка нейросети не стоит денег; 60 запросов в минуту и 10 одновременных на ключ. Подробнее — Цены и списания и Лимиты.

← SDK и программы · Ключ для нейросети →

Вся документация одним текстом · Все модели и цены