Claude API: ключ, эндпоинт /v1/messages и выбор версии модели

16.09.2026

Светящийся цифровой ключ доступа рядом с парящими объёмными блоками текста на тёмном фоне

Claude API — это способ вызывать модели Claude из своего кода, а не из окна чата: бота поддержки на сайте, скрипта разбора заявок, автодополнения в редакторе, интеграции с CRM. На NeuralSpace ключ создаётся в личном кабинете за минуту, запрос уходит на Anthropic-совместимый эндпоинт POST /v1/messages, а оплата идёт токенами баланса — без подписки. Ниже пошагово: как получить ключ, как выглядит первый вызов и как выбрать версию модели — Haiku, Sonnet, Opus или Fable.

Что такое Claude API и чем он отличается от чата

Claude — семейство языковых моделей Anthropic. В окне чата вы общаетесь с моделью вручную; через API то же самое делает ваш код: отправляет массив сообщений, получает сгенерированный ответ и использует его в продукте — показывает пользователю, кладёт в базу, обрабатывает дальше. Типовые сценарии: чат-боты поддержки, суммаризация писем и документов, извлечение структурированных данных, генерация черновиков, автоматизация рутины в скриптах. Ключевое отличие от чата — предсказуемость: вы сами задаёте системную инструкцию, лимит ответа и версию модели, а расход видите в токенах.

Шаг 1. Получить ключ

Зарегистрируйтесь на NeuralSpace по email — это меньше минуты. Новым пользователям начисляются стартовые токены, на них можно выполнить первые запросы без пополнения.
Откройте страницу «API-ключи» в личном кабинете, введите название ключа (например, «Мой бот») и нажмите «Создать».
Ключ имеет вид nsk-… и показывается только один раз — скопируйте его сразу в менеджер паролей или переменную окружения, а не в код репозитория.
Проверьте баланс: для текстовых моделей на счету нужно минимум 50 токенов (1 токен = 1 ₽). Пополнение — в кабинете, без иностранных карт и абонентской платы.

Страница API-ключей NeuralSpace: создание ключа и быстрый старт для Claude

Шаг 2. Первый запрос к /v1/messages

Текстовые модели Claude живут на Anthropic-совместимом эндпоинте POST https://neuralspace.pro/v1/messages. В теле — модель, массив messages с ролями user/assistant, лимит ответа max_tokens (от 1 до 32000) и необязательная системная инструкция system. Минимальный запрос через curl:

curl https://neuralspace.pro/v1/messages \
  -H "x-api-key: nsk-ваш_ключ" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "system": "Ты кратко отвечаешь на технические вопросы.",
    "messages": [{"role": "user", "content": "Чем стриминг отличается от обычного ответа?"}]
  }'

Ответ приходит в формате Anthropic: текст — в content[0].text, фактический расход — в поле usage. Авторизация — заголовком x-api-key: nsk-…; для клиентов, которые умеют только Bearer, подойдёт и Authorization: Bearer nsk-….

Шаг 3. Подключить Anthropic SDK

Если у вас уже есть код на официальном SDK Anthropic, менять нужно ровно два значения — base_url и ключ:

from anthropic import Anthropic

client = Anthropic(
    base_url="https://neuralspace.pro",
    api_key="nsk-ваш_ключ",
)

resp = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="Ты кратко отвечаешь на технические вопросы.",
    messages=[{"role": "user", "content": "Придумай три названия для канала про нейросети"}],
)
print(resp.content[0].text)

Для чат-интерфейсов полезен стриминг: добавьте "stream": true — ответ пойдёт порциями через Server-Sent Events, и пользователь увидит первые слова ещё до конца генерации.

Какую версию модели выбрать

В публичном каталоге NeuralSpace четыре версии Claude, и разница между ними — в балансе «скорость и цена против глубины рассуждений». Цены ниже — в токенах сайта за миллион API-токенов, вход и выход считаются отдельно (на момент публикации, тарифы плавающие):

Claude Haiku 4.5 (claude-haiku-4-5) — 41 / 213. Самая быстрая и дешёвая: классификация, короткие ответы, массовая обработка текстов, черновая разметка.
Claude Sonnet 5 (claude-sonnet-5) — 152,5 / 767. Рабочая лошадка: код, длинные инструкции, диалоги с контекстом. Разумный выбор по умолчанию.
Claude Opus 5 (claude-opus-5) — 359 / 1794,5. Для сложных задач: многошаговые рассуждения, разбор больших документов, тонкая логика.
Claude Fable 5 (claude-fable-5) — 718 / 3589,5. Флагман для самых требовательных сценариев, когда важнее качество, чем цена.

Практичное правило: начинайте с Haiku или Sonnet, а на Opus и Fable переключайтесь точечно — там, где ответов первых двух действительно не хватает. Версия задаётся одним полем model в запросе, так что сравнить их можно на одном и том же промпте.

Стриминг, лимиты и служебные эндпоинты

Два ограничения, о которые спотыкаются на старте: лимит 60 запросов в минуту на ключ и минимальный баланс 50 токенов для текстовых моделей. Текущий баланс отдаёт GET /v1/balance, а машиночитаемый список моделей с живыми ценами — GET /v1/models. Оба требуют ключ. Актуальные тарифы всегда видны в таблице на странице документации API.

Claude API и MCP: подключить к Claude Code

Тем же ключом NeuralSpace подключается к ИИ-агентам как MCP-сервер: агент сам вызывает чат, генерацию картинок, видео и музыки от имени вашего аккаунта. Для Claude Code это одна команда:

claude mcp add --transport http neuralspace https://neuralspace.pro/mcp \
  --header "Authorization: Bearer nsk-ваш_ключ"

Если API пока не нужен, те же модели доступны в интерфейсе — в чате можно выбрать Claude и общаться без кода, а баланс общий и для чата, и для API.

Частые вопросы

Нужен ли аккаунт Anthropic или зарубежная карта?

Нет. Ключ выдаётся в личном кабинете NeuralSpace, оплата — токенами баланса: 1 токен = 1 ₽, без подписки и без облачного биллинга.

Чем эндпоинт /v1/messages отличается от /v1/chat/completions?

Это два формата одного API. /v1/messages повторяет Anthropic Messages API (поля model, messages, system, max_tokens) и подходит для моделей Claude и Anthropic SDK. /v1/chat/completions — формат OpenAI для чат-моделей GPT и Grok. Меняется только адрес и структура тела.

Сколько стоит вызов Claude API?

Только за фактические токены: у Claude Sonnet 5 на момент написания — 152,5 токена за миллион входных и 767 за миллион выходных. Запрос на пару тысяч токенов — порядка 1 ₽. Актуальные цены — в GET /v1/models и в таблице документации.

Есть ли бесплатный тариф?

Бесплатных генераций на платформе нет. Новым пользователям начисляются стартовые токены — их хватает на первые пробы, дальше оплата по токенам без абонентской платы.