NeuralSpace API

语言： Русский · English · العربية · 简体中文

本页面为开发者和AI智能体提供的文档，无需身份验证即可访问，也支持自动化读取。

基础URL：https://neuralspace.pro。使用账户余额中的token付费（1 token = 1 ₽），无需订阅或国外银行卡。文本与对话接口兼容Anthropic和OpenAI的SDK——只需更改base_url和密钥即可。

身份验证

请在账户中创建API密钥：https://neuralspace.pro/api-keys。密钥形如nsk-...，仅显示一次。请在请求头中传递：

x-api-key: nsk-your_key

也支持使用Authorization: Bearer nsk-...请求头（适用于兼容OpenAI的客户端）。

• 速率限制：每个密钥每分钟60次请求。
• 使用文本模型所需的最低余额：50 token。
• /v1/messages和/v1/chat/completions均支持流式传输（stream: true）：响应以对应SDK（Anthropic / OpenAI）格式的Server-Sent Events方式返回。设置stream: false则返回常规JSON响应。

MCP服务器——将NeuralSpace接入你的AI智能体

本API的所有能力（图像/视频/音乐生成、与LLM对话、语音合成与识别、余额查询、价格查询）也以MCP服务器（Model Context Protocol）形式提供——你可以将其接入Claude Code、Claude Desktop、Cursor及其他任意MCP客户端，让你的AI智能体以你的账户身份自主生成内容。

接入地址（Streamable HTTP，无会话）：https://neuralspace.pro/mcp。身份验证方式与直接调用API相同，在Authorization: Bearer或x-api-key请求头中传入同样的nsk-...密钥。

# Claude Code
claude mcp add --transport http neuralspace https://neuralspace.pro/mcp \
  --header "Authorization: Bearer nsk-your_key"

// Cursor / Claude Desktop and other streamable-http clients
{
  "mcpServers": {
    "neuralspace": {
      "type": "http",
      "url": "https://neuralspace.pro/mcp",
      "headers": { "Authorization": "Bearer nsk-your_key" }
    }
  }
}

// Clients that only speak stdio — via the mcp-remote bridge
{
  "mcpServers": {
    "neuralspace": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://neuralspace.pro/mcp",
               "--header", "Authorization: Bearer nsk-your_key"]
    }
  }
}

MCP服务器提供的工具：list_models（模型列表及实时价格）、get_balance（余额）、chat（LLM对话）、generate_image、generate_video + check_video、generate_music + check_music、text_to_speech、transcribe_audio。计费与退款规则与直接调用API完全一致；成功生成的内容会以卡片形式出现在你的账户中。若客户端的MCP工具超时时间较短，建议为同步图像生成（最长约2分钟）适当延长该超时时间。

GET /v1/balance 与 GET /v1/models——服务接口

GET /v1/balance——查询密钥所属账户的当前token余额：{ "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-your_key" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

通过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-your_key" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5-6-balanced",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

通过OpenAI SDK调用：OpenAI(base_url="https://neuralspace.pro/v1", api_key="nsk-...")。

Realtime voice

Grok Think Fast is available over WebSocket for native speech-to-speech. Sessions are limited to 120 minutes. Billing uses the actual duration of input and output audio; the exact amount is in the price table above.

const ws = new WebSocket(
  "wss://neuralspace.pro/v1/realtime?model=grok-voice-think-fast-2.0&lang=zh",
  { headers: { Authorization: "Bearer nsk-your_key" } }
);

POST /v1/images/generations——图像生成

同步接口：响应中直接返回可用的图像URL。仅在生成成功时扣除token。可用模型：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（数组——开启编辑/图生图模式）。

curl https://neuralspace.pro/v1/images/generations \
  -H "x-api-key: nsk-your_key" \
  -H "content-type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "太空中的一只猫，数字插画",
    "resolution": "2K"
  }'

响应：{ "data": [{ "url": "https://..." }], "usage": { "tokens": N } }。

POST /v1/videos/generations——视频生成（异步）

视频生成通常需要数分钟，因此采用异步方式：POST创建任务并扣除token，随后轮询GET /v1/videos/generations/<id>获取结果。若出错或超时，token将被退还。可用模型：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字符串，或形如{prompt, duration}的对象（启用multi_shots时，image_urls中最多允许提供1张图片）；
• elements——一致性角色/物体的数组（最多4个）；在prompt中通过@element_<name>引用某个元素。每个元素的格式为：{ "name": "...", "description": "...", "image_urls": [2—4张照片] }，或用"video_url": "..."（1个视频）代替照片。

# 1. 创建任务
curl https://neuralspace.pro/v1/videos/generations \
  -H "x-api-key: nsk-your_key" \
  -H "content-type: application/json" \
  -d '{"model": "seedance-2.0", "prompt": "海洋上的日落", "duration": 5}'
# response: { "id": "task_...", "status": "pending", "poll_url": "..." }

# 2. 轮询状态，直到status不再是completed/failed
curl https://neuralspace.pro/v1/videos/generations/task_... \
  -H "x-api-key: nsk-your_key"
# when completed: { "status": "completed", "data": [{ "url": "https://..." }] }

POST /v1/music/generations——音乐生成（异步）

音乐生成（Suno）通常需要数分钟，因此采用异步方式：POST创建任务并扣除token，随后轮询GET /v1/music/generations/<id>获取结果。若出错或超时，token将被退还。一次生成通常会返回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-your_key" \
  -H "content-type: application/json" \
  -d '{"model": "V5", "prompt": "关于夜色都市的动感合成器浪潮音乐"}'
# response: { "id": "task_...", "status": "pending", "poll_url": "..." }

# 2. 轮询状态，直到status不再是completed/failed
curl https://neuralspace.pro/v1/music/generations/task_... \
  -H "x-api-key: nsk-your_key"
# when completed: { "status": "completed", "data": [{ "url": "https://...", "title": "...", "duration": 123 }] }

POST /v1/audio/speech——语音合成（OpenAI格式）

兼容OpenAI Audio Speech API。同步接口：响应中直接返回可用的音频文件URL。仅在生成成功时按字符数扣除token。可用模型：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-your_key" \
  -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格式发送。同步接口：响应中直接返回识别出的文本。仅在识别成功时按音频时长（根据文件大小估算）扣除token。可用模型：whisper-large-v3, whisper-1。文件大小限制——25 MB。

表单字段：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-your_key" \
  -F model="whisper-large-v3" \
  -F file="@audio.mp3"
# response: { "text": "...", "model": "whisper-large-v3", "usage": { "tokens": 0.2 } }

响应：{ "text": "识别出的文本", "model": "whisper-large-v3", "usage": { "tokens": 0.2 } }。

POST /v1/characters——创建角色/语音助手

在你的账户中创建一个AI角色或语音助手（可在“角色”版块中查看）。若不提供image_url，则会创建一个使用预设音色的语音助手（voice_only）——速度快、成本低。若提供image_url（一张公开可访问的照片URL），则会创建带视频形象的角色。费用为10 token，成功后扣除。

字段：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-your_key" \
  -H "Content-Type: application/json" \
  -d '{ "name": "My assistant", "instruction": "A friendly product assistant", "voice": "verse" }'
# response: { "character": { "id": "voice-...", "name": "...", "characterType": "voice_only", "voice": {...} } }

GET /v1/characters——获取你的角色列表

返回{ "data": [{ "id", "name", "characterType", "voice", "isVoiceOnly", ... }] }。

模型与价格

价格单位为站内token（1 token = 1 ₽）。价格为动态浮动价，可能随时调整；本页面始终展示当前实时价格。

价格是浮动的：每次请求都按实际发生的成本计费，因此表格中的数字仅供参考，并非固定价格。若某模型的价格在一天内发生波动，将在其下方显示过去24小时内的价格区间。

文本模型（每100万token）

对话模型（每100万token）

图像（每张）

视频

音乐

语音合成（每1000字符）

音频转录（每1分钟）

错误

文本接口返回Anthropic格式的错误（{ "type": "error", "error": { "type", "message" } }），对话接口返回OpenAI格式的错误（{ "error": { "message", "type" } }）。错误代码：401——密钥缺失或无效，403——账户已被暂停，429——超出速率限制，400——请求无效或token余额不足。

技术支持与余额充值：https://neuralspace.pro/payment。管理密钥：https://neuralspace.pro/api-keys。