NeuralSpace API

Язык: Русский · English · العربية · 简体中文

Документация для разработчиков и ИИ-агентов. Эта страница доступна без авторизации и предназначена в том числе для автоматического чтения.

Базовый URL: https://neuralspace.pro. Оплата — токенами баланса аккаунта (1 токен = 1 ₽), без подписок и иностранных карт. Эндпоинты текста и чата совместимы с Anthropic и OpenAI SDK — достаточно поменять base_url и ключ.

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

Создайте API-ключ в личном кабинете: https://neuralspace.pro/api-keys. Ключ имеет вид nsk-... и показывается один раз. Передавайте его в заголовке:

x-api-key: nsk-ваш_ключ

Допустим и заголовок Authorization: Bearer nsk-... (для OpenAI-совместимых клиентов).

• Лимит запросов: 60 в минуту на ключ.
• Минимальный баланс для доступа к текстовым моделям: 50 токенов.
• Стриминг (stream: true) поддерживается на /v1/messages и /v1/chat/completions: ответ приходит через Server-Sent Events в формате соответствующего SDK (Anthropic / OpenAI). С stream: false — обычный JSON-ответ.

MCP-сервер — подключите NeuralSpace к своему ИИ-агенту

Всё, что умеет этот API (генерация картинок/видео/музыки, чат с LLM, синтез и распознавание речи, баланс, цены), доступно и как MCP-сервер (Model Context Protocol) — его можно подключить к Claude Code, Claude Desktop, Cursor и любому другому MCP-клиенту, и ваш ИИ-агент будет сам генерировать контент от имени вашего аккаунта.

Эндпоинт (Streamable HTTP, без сессий): https://neuralspace.pro/mcp. Авторизация — тот же ключ nsk-... в заголовке Authorization: Bearer или x-api-key.

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

// Cursor / Claude Desktop и другие клиенты с streamable-http
{
  "mcpServers": {
    "neuralspace": {
      "type": "http",
      "url": "https://neuralspace.pro/mcp",
      "headers": { "Authorization": "Bearer nsk-ваш_ключ" }
    }
  }
}

// Клиенты, умеющие только stdio — через мост mcp-remote
{
  "mcpServers": {
    "neuralspace": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://neuralspace.pro/mcp",
               "--header", "Authorization: Bearer nsk-ваш_ключ"]
    }
  }
}

Инструменты MCP-сервера: list_models (модели и живые цены), get_balance (баланс), chat (LLM), generate_image, generate_video + check_video, generate_music + check_music, text_to_speech, transcribe_audio. Тарификация и возвраты — ровно как у прямых вызовов API; успешные генерации появляются карточками в вашем кабинете. Для синхронной генерации изображений (до ~2 минут) увеличьте таймаут MCP-инструментов в клиенте, если он меньше.

GET /v1/balance и GET /v1/models — сервисные эндпоинты

GET /v1/balance — текущий баланс токенов владельца ключа: { "balance": N, "currency": "tokens" }. GET /v1/models — машиночитаемый список всех моделей с живыми ценами (JSON-версия этой страницы). Оба требуют ключ.

POST /v1/messages — текстовые модели (формат Anthropic)

Совместим с Anthropic Messages API. Модели: claude-haiku-4-5, claude-sonnet-4-6, claude-sonnet-5, claude-opus-4-6, claude-opus-4-7, claude-opus-4-8, claude-opus-5, claude-fable-5.

Поля тела: model, messages (массив {role, content}, role — user/assistant), max_tokens (1—32000), необязательно system.

curl https://neuralspace.pro/v1/messages \
  -H "x-api-key: nsk-ваш_ключ" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Через Anthropic SDK (Python): Anthropic(base_url="https://neuralspace.pro", api_key="nsk-...").

POST /v1/chat/completions — чат-модели (формат OpenAI)

Совместим с OpenAI Chat Completions API. Модели: gpt-5-6, gpt-5-6-balanced, gpt-5-6-fast, gpt-5-mini, gpt-5-4-mini, grok-4-6, grok-4-5, grok-4-3, kimi-k2.6, kimi-k3, glm-5.2, deepseek-v4-flash, deepseek-v4-pro.

Поля тела: model, messages (role — system/user/assistant), max_tokens или max_completion_tokens, необязательно reasoning_effort (для gpt-5-6 / gpt-5-6-balanced / gpt-5-6-fast, grok-4-5).

curl https://neuralspace.pro/v1/chat/completions \
  -H "Authorization: Bearer nsk-ваш_ключ" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5-6-balanced",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Через OpenAI SDK: OpenAI(base_url="https://neuralspace.pro/v1", api_key="nsk-...").

Голос в реальном времени

Grok Think Fast доступна по WebSocket, говорит и слушает в одном потоке. Лимит сессии — 120 минут. Цена считается по фактической длительности входящего и исходящего аудио, точная сумма — в таблице цен выше.

const ws = new WebSocket(
  "wss://neuralspace.pro/v1/realtime?model=grok-voice-think-fast-2.0&lang=ru",
  { headers: { Authorization: "Bearer nsk-ваш_ключ" } }
);

POST /v1/images/generations — генерация изображений

Синхронный: ответ содержит готовый URL. Токены списываются только при успехе. Модели: nano-banana, nano-banana-pro, nano-banana-2, nano-banana-2-lite, flux-2-pro, gpt-image-15, gpt-image-2, gpt-image-2-pro, seedream-45, seedream-5-lite, seedream-5-pro, grok-image, grok-imagine-image-2, ns-image, z-image, ideogram, midjourney.

Поля тела: model, prompt (до 5000 символов), необязательно aspect_ratio (у gpt-image-2-pro — 1:1/3:2/2:3), resolution (1K/2K/4K — где поддерживается), output_format (jpeg/png — nano-banana-pro; jpeg/png/webp — gpt-image-2-pro), quality (medium/high — gpt-image-15; low/medium/high — gpt-image-2-pro), mode (relaxed/fast/turbo — midjourney), image_urls (массив — включает режим редактирования/image-to-image).

curl https://neuralspace.pro/v1/images/generations \
  -H "x-api-key: nsk-ваш_ключ" \
  -H "content-type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "Кот в космосе, цифровая иллюстрация",
    "resolution": "2K"
  }'

Ответ: { "data": [{ "url": "https://..." }], "usage": { "tokens": N } }.

POST /v1/videos/generations — генерация видео (асинхронно)

Видео генерируется минутами, поэтому асинхронно: POST создаёт задачу и списывает токены, затем опрашивайте GET /v1/videos/generations/<id>. При ошибке/таймауте токены возвращаются. Модели: seedance-2.0, veo-3.1, veo-3.1-fast, veo-3.1-lite, sora-2, sora-2-pro, kling-o3, kling-3.0, kling-3-0-turbo, grok-imagine, wan-2.6.

Поля тела: model, prompt, необязательно duration, resolution, speed (seedance), mode (kling/grok), quality (sora-2-pro), audio (kling), aspect_ratio, image_urls, multi_shots (раскадровка — kling-3.0 и wan-2.6).

Дополнительно для kling-3.0:

• multi_shots (true) + shots — раскадровка из 2—5 кадров; каждый кадр строкой-промптом или объектом {prompt, duration} (при multi_shots допустимо не более одного изображения в image_urls);
• elements — массив (до 4) консистентных персонажей/объектов; на элемент ссылаются в промпте как @element_<name>. Каждый элемент: { "name": "...", "description": "...", "image_urls": [2—4 фото] } либо вместо фото "video_url": "..." (1 видео).

# 1. создать задачу
curl https://neuralspace.pro/v1/videos/generations \
  -H "x-api-key: nsk-ваш_ключ" \
  -H "content-type: application/json" \
  -d '{"model": "seedance-2.0", "prompt": "Закат над океаном", "duration": 5}'
# ответ: { "id": "task_...", "status": "pending", "poll_url": "..." }

# 2. опрашивать статус, пока status != completed/failed
curl https://neuralspace.pro/v1/videos/generations/task_... \
  -H "x-api-key: nsk-ваш_ключ"
# при completed: { "status": "completed", "data": [{ "url": "https://..." }] }

POST /v1/music/generations — генерация музыки (асинхронно)

Музыка (Suno) генерируется минутами, поэтому асинхронно: POST создаёт задачу и списывает токены, затем опрашивайте GET /v1/music/generations/<id>. При ошибке/таймауте токены возвращаются. За одну генерацию обычно возвращается 2 трека. Модели: V5_5, V5, V4_5PLUS, V4_5, V4.

Поля тела: model, prompt (описание музыки; в режиме custom_mode с вокалом — текст песни), необязательно instrumental (без вокала), custom_mode (требует style и title), style, title, negative_tags, vocal_gender (m/f), duration — длительность трека в секундах, от 10 до 360 (доступна только для модели V5_5 вместе с custom_mode: true; без неё длительность выбирает модель).

# 1. создать задачу
curl https://neuralspace.pro/v1/music/generations \
  -H "x-api-key: nsk-ваш_ключ" \
  -H "content-type: application/json" \
  -d '{"model": "V5", "prompt": "Энергичный синтвейв про ночной город"}'
# ответ: { "id": "task_...", "status": "pending", "poll_url": "..." }

# 2. опрашивать статус, пока status != completed/failed
curl https://neuralspace.pro/v1/music/generations/task_... \
  -H "x-api-key: nsk-ваш_ключ"
# при completed: { "status": "completed", "data": [{ "url": "https://...", "title": "...", "duration": 123 }] }

POST /v1/audio/speech — синтез речи (формат OpenAI)

Совместим с OpenAI Audio Speech API. Синхронный: ответ содержит готовый URL аудиофайла. Токены списываются только при успехе, по числу символов. Модели: tts-1, tts-1-hd.

Поля тела: model, input (текст, до 4096 символов), необязательно voice (alloy/echo/fable/onyx/nova/shimmer), response_format (mp3/opus/aac/flac/wav).

curl https://neuralspace.pro/v1/audio/speech \
  -H "Authorization: Bearer nsk-ваш_ключ" \
  -H "content-type: application/json" \
  -d '{
    "model": "tts-1",
    "voice": "alloy",
    "input": "Привет! Это синтез речи NeuralSpace."
  }'

POST /v1/audio/transcriptions — транскрипция аудио (формат OpenAI)

Совместим с OpenAI Audio Transcriptions API (Whisper). Файл передаётся как multipart/form-data. Синхронный: ответ содержит распознанный текст. Токены списываются только при успехе, по длительности аудио (оценка по размеру файла). Модели: whisper-large-v3, whisper-1. Лимит файла — 25 МБ.

Поля формы: file (аудио: mp3/mp4/mpeg/mpga/m4a/wav/webm/ogg/flac), model (whisper-large-v3; легаси whisper-1 принимается и исполняется как large-v3), необязательно language (ISO-код, напр. ru/en), prompt (подсказка контекста).

curl https://neuralspace.pro/v1/audio/transcriptions \
  -H "Authorization: Bearer nsk-ваш_ключ" \
  -F model="whisper-large-v3" \
  -F file="@audio.mp3"
# ответ: { "text": "...", "model": "whisper-large-v3", "usage": { "tokens": 0.2 } }

Ответ: { "text": "распознанный текст", "model": "whisper-large-v3", "usage": { "tokens": 0.2 } }.

POST /v1/characters — создать персонажа / голосового ассистента

Создаёт ИИ-персонажа или голосового ассистента в вашем кабинете (доступен в разделе «Персонажи»). Без image_url создаётся голосовой ассистент (voice_only) с пресет-голосом — быстро и дёшево. С image_url (публичный URL фото) создаётся персонаж с видео-аватаром. Стоимость — 10 токенов, списываются при успехе.

Поля: name (обязательно), instruction (характер/системная инструкция), voice (для голосового: alloy, echo, shimmer, sage, verse, coral, ash, ballad; по умолчанию alloy), start_script (приветствие), image_url (фото для видео-аватара), language (ru/en).

curl https://neuralspace.pro/v1/characters \
  -H "Authorization: Bearer nsk-ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Мой ассистент", "instruction": "Дружелюбный помощник по продукту", "voice": "verse" }'
# ответ: { "character": { "id": "voice-...", "name": "...", "characterType": "voice_only", "voice": {...} } }

GET /v1/characters — список ваших персонажей

Возвращает { "data": [{ "id", "name", "characterType", "voice", "isVoiceOnly", ... }] }.

Модели и цены

Цены — в токенах сайта (1 токен = 1 ₽). Тарифы динамические и могут меняться; эта страница всегда отражает актуальные значения.

Цена плавающая: за каждый запрос списывается его фактическая стоимость, поэтому цифры в таблицах — ориентир, а не прейскурант. Там, где цена модели меняется в течение дня, под ней показан разброс за последние сутки.

Текстовые модели (за 1М токенов)

Чат-модели (за 1М токенов)

Изображения (за изображение)

Видео

Музыка

Синтез речи (за 1000 символов)

Транскрипция аудио (за 1 минуту)

Ошибки

Текстовый эндпоинт возвращает ошибки в формате Anthropic ({ "type": "error", "error": { "type", "message" } }), чат — в формате OpenAI ({ "error": { "message", "type" } }). Коды: 401 — нет/неверный ключ, 403 — аккаунт заблокирован, 429 — превышен лимит, 400 — неверный запрос или мало токенов.

Поддержка и пополнение баланса: https://neuralspace.pro/payment. Управление ключами: https://neuralspace.pro/api-keys.