NeuralSpace API

Язык: Русский · English · العربية · 简体中文 · ko · ja · Deutsch · Français · Español · Italiano · Svenska · עברית · ייִדיש · हिन्दी · Nederlands · Português · Română · Polski · Čeština · Ελληνικά · Slovenčina · Magyar · Bahasa Indonesia · Bahasa Melayu · Dansk · Suomi · Norsk · Hrvatski · sr

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

Дата обновления: 7 сентября 2026 г.

Базовый 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-haiku-5-5, claude-sonnet-5, claude-sonnet-5-5, claude-opus-5, claude-opus-5-5, claude-fable-5, claude-fable-5-1.

Поля тела: 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-5",
    "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-6-astra, gpt-6-sol, gpt-6-luna, gpt-6-1-sol, gpt-6-1-sol-pro, gpt-6-1-terra, gpt-6-1-terra-pro, gpt-5-mini, gpt-5-4-mini, grok-4-3, grok-4-5, grok-4-6, grok-4-7, gemini-3-8-flash, gemini-4-argon, deepseek-v4.1-flash, deepseek-v4.1-flash-1017, deepseek-v4-pro, glm-5.3-flash, glm-5.3, glm-5.3-flashx-legal, kimi-k2.6, kimi-k3, kimi-k3.1-pro.

Поля тела: model, messages (role — system/user/assistant), max_tokens или max_completion_tokens, необязательно reasoning_effort (для GPT-5.6, GPT-6 Astra и 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 Voice 3 доступна по WebSocket, говорит и слушает в одном потоке. Лимит сессии — 120 минут. Цена считается по фактической длительности входящего и исходящего аудио, точная сумма — в таблице цен выше.

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

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

Синхронный: ответ содержит готовый URL. Токены списываются только при успехе. Модели: nano-banana, nano-banana-pro, nano-banana-2, nano-banana-2-lite, nano-banana-2-1, flux-2-pro, gpt-image-15, gpt-image-2, gpt-image-2-pro, gpt-image-25, gpt-image-26, seedream-45, seedream-5-lite, seedream-5-flash, 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; у gpt-image-25 — auto/1:1/3:2/2:3/16:9/9:16/4:3/3:4/21:9, а 27:16/16:27/9:8/8:9 только в 1K), resolution (1K/2K/4K), variant (flare/sunburst — gpt-image-25), background (transparent/opaque/auto — gpt-image-25), 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 } }.

Входные изображения: ссылка или Base64

Каждый элемент image_urls — либо ссылка, либо Base64: data-URL вида data:image/png;base64,... или «голый» base64 без префикса. Изображение декодируется, проверяется и сохраняется на сервере, дальше модели получают его как обычную ссылку — ответ и списание не отличаются от передачи по ссылке. Форматы: PNG/JPEG/WebP; до 10 МБ на изображение и до 72 МБ медиа на запрос. Неверный формат, несовпадение заявленного типа и содержимого файла или превышение лимита — ошибка 400, токены не списываются.

# 2. image_urls ссылкой ИЛИ base64 (data:image/png;base64,...)
curl https://neuralspace.pro/v1/images/generations \
  -H "x-api-key: nsk-ваш_ключ" \
  -H "content-type: application/json" \
  -d '{
    "model": "nano-banana-2-1",
    "prompt": "make the cat wear a space helmet",
    "image_urls": ["data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."]
  }'

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

Видео генерируется минутами, поэтому асинхронно: POST создаёт задачу и списывает токены, затем опрашивайте GET /v1/videos/generations/<id>. При ошибке/таймауте токены возвращаются. Модели: seedance-2.0, seedance-2.5, 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, kling-4-0, kling-4-0-flash, grok-1.5, grok-imagine, wan-2.6, gemini-omni-flash-1-1, gemini-omni-flash-1-2, gemini-omni-1, vidu-q4.

Поля тела: 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). Grok Imagine Video 1.5: model: "grok-1.5", 1–15 секунд, 480p/720p/1080p; enable_audio (true/false), first_frame_url, last_frame_url, loop_url (один кадр в начале и конце), keyframes: [{"url":"https://example.com/frame.jpg","timestamp_s":3}]. До 4 промежуточных кадров: разные целые секунды больше 0 и меньше duration. Описание можно не передавать, если есть хотя бы один кадр. Изображения — URL или Base64.

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

kling-4-0: duration — целое 3–30, resolution — 720p/1080p, aspect_ratio — auto/16:9/9:16/1:1/21:9. В режиме reference: до 10 image_urls, 5 video_urls, 7 elements ({name, image_urls или video_url, tag, description, voice_url}) и 3 voices ({name, audio_url}); вместе не более 15 фото/видео-референсов. Медиа в этих полях принимается URL или Base64. keep_original_sound доступен с входным видео. В режиме keyframe: first_frame_url, last_frame_url и до 8 keyframe_urls; режимы не совмещаются. Дополнительно доступен kling-4-0-flash: быстрая версия — duration целое от 3 до 20, только resolution 720p, voices и keep_original_sound не поддерживаются, в режиме keyframe принимается единственный first_frame_url.

gemini-omni-flash-1-2 (Gemini Omni 1.2 Flash): duration — целое 3–15, resolution — 360p/720p/1080p/4k, aspect_ratio — 16:9/9:16, seed 0…2147483647; звук генерируется всегда. До 7 image_urls (референсы) и единственный first_frame_url (первое изображение из image_urls, если задан флаг); видео- и аудио-входа нет.

• 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://..." }] }

Входное видео: ссылка или Base64

Входные видео тоже можно передавать Base64: элементы video_urls/reference_video_urls, video_list[].url, elements[].video_url — либо ссылка, либо data-URL data:video/mp4;base64,... или «голый» base64. Форматы: MP4/WebM/MOV; до 64 МБ на видео (в суммарный лимит 72 МБ медиа на запрос). Проверки те же: сигнатура файла, несовпадение заявленного типа и содержимого — ошибка 400 без списания.

# референс-видео ссылкой ИЛИ base64 (data:video/mp4;base64,...)
curl https://neuralspace.pro/v1/videos/generations \
  -H "x-api-key: nsk-ваш_ключ" \
  -H "content-type: application/json" \
  -d '{"model": "seedance-2.5", "prompt": "продолжи этот ролик", "duration": 5,
       "video_urls": ["data:video/mp4;base64,AAAAIGZ0eXBpc29t..."]}'

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

Музыка (Suno) генерируется минутами, поэтому асинхронно: POST создаёт задачу и списывает токены, затем опрашивайте GET /v1/music/generations/<id>. При ошибке/таймауте токены возвращаются. За одну генерацию обычно возвращается 2 трека. Модели: V6, V6_WILD, V6_MINI, 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, V6, V6_MINI и V6_WILD вместе с 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 } }.

Видео-аватары

Говорящие видео-аватары и связанные режимы. Справочники: GET /v1/avatars (avatar_id), GET /v1/avatars/voices?language=en (voice_id), GET /v1/avatars/languages (языки перевода), /v1/avatars/styles, /v1/avatars/templates, /v1/avatars/assets, /v1/avatars/brand-kits. Генерация асинхронная: POST /v1/avatars/generations с полем type, затем опрос GET /v1/avatars/generations/<id>. Токены списываются при создании и возвращаются при ошибке.

curl https://neuralspace.pro/v1/avatars/voices?language=en \
  -H "x-api-key: nsk-ваш_ключ"

curl https://neuralspace.pro/v1/avatars/generations \
  -H "x-api-key: nsk-ваш_ключ" \
  -H "content-type: application/json" \
  -d '{"type": "talking_avatar", "avatar_id": "avatar_...", "voice_id": "voice_...", "script": "Hello!"}'
# ответ: { "id": "task_...", "status": "pending", "poll_url": "..." }

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 минуту)

Видео-аватары

3D-модели (Tripo)

3D-генерация и обработка моделей: 18 операций (3D по тексту/фото/видам, сплат, картинки, текстуры, разбивка, достройка, ретопология, UV, конвертация формата, скелет, анимации). Коды операций и параметры: GET /v1/tripo/tools; цены в токенах — по живому курсу. Создание асинхронное: POST /v1/tripo/tasks (tool, prompt, params, image_urls, animations), затем опрос GET /v1/tripo/tasks/<id>. Результаты хранятся на нашем хранилище (постоянные ссылки). Токены списываются при создании и возвращаются при ошибке.

curl https://neuralspace.pro/v1/tripo/tools \
  -H "x-api-key: nsk-ваш_ключ"

curl https://neuralspace.pro/v1/tripo/tasks \
  -H "x-api-key: nsk-ваш_ключ" \
  -H "content-type: application/json" \
  -d '{"tool": "text-to-3d", "prompt": "деревянный стул"}'
# ответ: { "id": "...", "status": "pending", "poll_url": "/v1/tripo/tasks/..." }

Ошибки

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

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

Готовые настройки для OpenCode, Claude Code, Cursor, Harness и MCP.