NeuralSpace API

Sprache: Русский · English · العربية · 简体中文 · ko · ja · Deutsch · Français · Español · Italiano · Svenska · עברית · ייִדיש · हिन्दी · Nederlands · Português · Română · Polski

Dokumentation für Entwickler und KI-Agenten. Diese Seite ist ohne Authentifizierung zugänglich und unter anderem dafür gedacht, automatisch gelesen zu werden.

Zuletzt aktualisiert: 7. September 2026

Basis-URL: https://neuralspace.pro. Bezahlt wird mit Tokens vom Kontoguthaben (1 Token = 1 ₽), ohne Abonnements oder ausländische Karten. Die Text- und Chat-Endpunkte sind mit den SDKs von Anthropic und OpenAI kompatibel — es genügt, base_url und den Schlüssel zu ändern.

Authentifizierung

Erstellen Sie einen API-Schlüssel in Ihrem Konto: https://neuralspace.pro/api-keys. Der Schlüssel sieht aus wie nsk-... und wird nur einmal angezeigt. Übergeben Sie ihn im Header:

x-api-key: nsk-your_key

Der Header Authorization: Bearer nsk-... wird ebenfalls akzeptiert (für OpenAI-kompatible Clients).

• Ratenbegrenzung: 60 Anfragen pro Minute und Schlüssel.
• Mindestguthaben für den Zugriff auf die Textmodelle: 50 Tokens.
• Streaming (stream: true) wird von /v1/messages und /v1/chat/completions unterstützt: Die Antwort kommt über Server-Sent Events im Format des jeweiligen SDK (Anthropic / OpenAI). Mit stream: false erhalten Sie eine normale JSON-Antwort.

MCP-Server — NeuralSpace mit Ihrem KI-Agenten verbinden

Alles, was diese API kann (Bild-/Video-/Musikgenerierung, Chatten mit LLMs, Sprachsynthese und -erkennung, Guthaben, Preise), steht auch als MCP-Server (Model Context Protocol) zur Verfügung — Sie können ihn mit Claude Code, Claude Desktop, Cursor und jedem anderen MCP-Client verbinden, und Ihr KI-Agent generiert Inhalte selbst im Namen Ihres Kontos.

Endpunkt (Streamable HTTP, sessionlos): https://neuralspace.pro/mcp. Autorisierung — derselbe nsk-...-Schlüssel im Header Authorization: Bearer oder x-api-key.

# 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"]
    }
  }
}

Tools des MCP-Servers: list_models (Modelle und aktuelle Preise), get_balance (Guthaben), chat (LLM), generate_image, generate_video + check_video, generate_music + check_music, text_to_speech, transcribe_audio. Abrechnung und Rückerstattungen funktionieren genau wie bei direkten API-Aufrufen; erfolgreiche Generierungen erscheinen als Karten in Ihrem Konto. Für die synchrone Bildgenerierung (bis zu ~2 Minuten) erhöhen Sie das Timeout des MCP-Tools in Ihrem Client, falls es niedriger ist.

GET /v1/balance und GET /v1/models — Service-Endpunkte

GET /v1/balance — das aktuelle Token-Guthaben des Schlüsselinhabers: { "balance": N, "currency": "tokens" }. GET /v1/models — eine maschinenlesbare Liste aller Modelle mit aktuellen Preisen (die JSON-Version dieser Seite). Beide erfordern einen Schlüssel.

POST /v1/messages — Textmodelle (Anthropic-Format)

Kompatibel mit der Anthropic Messages API. Modelle: claude-haiku-4-5, claude-sonnet-5, claude-opus-5, claude-fable-5.

Felder im Body: model, messages (Array aus {role, content}, role — user/assistant), max_tokens (1—32000), optional system.

curl https://neuralspace.pro/v1/messages \
  -H "x-api-key: nsk-your_key" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Über das Anthropic SDK (Python): Anthropic(base_url="https://neuralspace.pro", api_key="nsk-...").

POST /v1/chat/completions — Chat-Modelle (OpenAI-Format)

Kompatibel mit der OpenAI Chat Completions API. Modelle: gpt-5-6, gpt-5-6-balanced, gpt-5-6-fast, gpt-6-astra, gpt-5-mini, gpt-5-4-mini, grok-4-3, grok-4-5, grok-4-6, gemini-3-8-flash, deepseek-v4.1-flash, deepseek-v4-pro, glm-5.3-flash, glm-5.3, kimi-k2.6, kimi-k3.

Felder im Body: model, messages (role — system/user/assistant), max_tokens oder max_completion_tokens, optional reasoning_effort (für GPT-5.6, GPT-6 Astra und 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!"}]
  }'

Über das 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=de",
  { headers: { Authorization: "Bearer nsk-your_key" } }
);

POST /v1/images/generations — Bildgenerierung

Synchron: Die Antwort enthält eine fertige URL. Tokens werden nur bei Erfolg berechnet. Modelle: 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, gpt-image-25, seedream-45, seedream-5-lite, seedream-5-pro, grok-image, grok-imagine-image-2, ns-image, z-image, ideogram, midjourney.

Felder im Body: model, prompt (bis zu 5000 Zeichen), optional 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 nur mit 1K), resolution (1K/2K/4K), variant (flare/sunburst — 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 (Array — aktiviert den Bearbeitungs- bzw. Image-to-Image-Modus).

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": "Eine Katze im Weltraum, digitale Illustration",
    "resolution": "2K"
  }'

Antwort: { "data": [{ "url": "https://..." }], "usage": { "tokens": N } }.

POST /v1/videos/generations — Videogenerierung (asynchron)

Die Videogenerierung dauert Minuten und ist daher asynchron: POST erstellt eine Aufgabe und bucht Tokens ab, danach fragen Sie GET /v1/videos/generations/<id> ab. Bei Fehler/Timeout werden die Tokens zurückerstattet. Modelle: 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, grok-imagine, wan-2.6, gemini-omni-flash-1-1, gemini-omni-1.

Felder im Body: model, prompt, optional duration, resolution, speed (seedance), mode (kling/grok), quality (sora-2-pro), audio (kling), aspect_ratio, image_urls, multi_shots (Storyboard — kling-3.0 und wan-2.6).

Zusätzlich für kling-3.0:

• multi_shots (true) + shots — ein Storyboard aus 2—5 Einstellungen; jede Einstellung ist ein Prompt-String oder ein Objekt {prompt, duration} (mit multi_shots ist höchstens ein Bild in image_urls erlaubt);
• elements — ein Array (bis zu 4) konsistenter Figuren/Objekte; referenzieren Sie ein Element im Prompt als @element_<name>. Jedes Element: { "name": "...", "description": "...", "image_urls": [2—4 Fotos] } oder statt Fotos "video_url": "..." (1 Video).

# 1. Aufgabe erstellen
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": "Sonnenuntergang über dem Ozean", "duration": 5}'
# response: { "id": "task_...", "status": "pending", "poll_url": "..." }

# 2. Status abfragen, bis 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 — Musikgenerierung (asynchron)

Die Musikgenerierung (Suno) dauert Minuten und ist daher asynchron: POST erstellt eine Aufgabe und bucht Tokens ab, danach fragen Sie GET /v1/music/generations/<id> ab. Bei Fehler/Timeout werden die Tokens zurückerstattet. Eine Generierung liefert in der Regel 2 Tracks. Modelle: V6, V6_WILD, V6_MINI, V5_5, V5, V4_5PLUS, V4_5, V4.

Felder im Body: model, prompt (Beschreibung der Musik; im custom_mode mit Gesang — der Songtext), optional instrumental (ohne Gesang), custom_mode (erfordert style und title), style, title, negative_tags, vocal_gender (m/f), duration — Tracklänge in Sekunden, von 10 bis 360 (für die Modelle V5_5, V6, V6_MINI und V6_WILD zusammen mit custom_mode: true verfügbar; ohne diese Angabe wählt das Modell die Länge).

# 1. Aufgabe erstellen
curl https://neuralspace.pro/v1/music/generations \
  -H "x-api-key: nsk-your_key" \
  -H "content-type: application/json" \
  -d '{"model": "V5", "prompt": "Energiegeladener Synthwave über eine nächtliche Stadt"}'
# response: { "id": "task_...", "status": "pending", "poll_url": "..." }

# 2. Status abfragen, bis 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 — Sprachsynthese (OpenAI-Format)

Kompatibel mit der OpenAI Audio Speech API. Synchron: Die Antwort enthält die URL einer fertigen Audiodatei. Tokens werden nur bei Erfolg berechnet, nach Anzahl der Zeichen. Modelle: tts-1, tts-1-hd.

Felder im Body: model, input (Text, bis zu 4096 Zeichen), optional 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": "Hallo! Das ist die Sprachsynthese von NeuralSpace."
  }'

POST /v1/audio/transcriptions — Audiotranskription (OpenAI-Format)

Kompatibel mit der OpenAI Audio Transcriptions API (Whisper). Die Datei wird als multipart/form-data gesendet. Synchron: Die Antwort enthält den erkannten Text. Tokens werden nur bei Erfolg berechnet, nach Audiodauer (geschätzt anhand der Dateigröße). Modelle: whisper-large-v3, whisper-1. Dateilimit — 25 MB.

Formularfelder: file (Audio: mp3/mp4/mpeg/mpga/m4a/wav/webm/ogg/flac), model (whisper-large-v3; das veraltete whisper-1 wird akzeptiert und als large-v3 ausgeführt), optional language (ISO-Code, z. B. ru/en), prompt (Kontexthinweis).

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 } }

Antwort: { "text": "erkannter Text", "model": "whisper-large-v3", "usage": { "tokens": 0.2 } }.

POST /v1/characters — Charakter / Sprachassistenten erstellen

Erstellt einen KI-Charakter oder Sprachassistenten in Ihrem Konto (verfügbar im Bereich „Charaktere“). Ohne image_url wird ein Sprachassistent (voice_only) mit einer voreingestellten Stimme erstellt — schnell und günstig. Mit image_url (öffentliche Foto-URL) wird ein Charakter mit Video-Avatar erstellt. Kosten — 10 Tokens, werden bei Erfolg berechnet.

Felder: name (erforderlich), instruction (Persona / Systemanweisung), voice (für den Sprachassistenten: alloy, echo, shimmer, sage, verse, coral, ash, ballad; Standard alloy), start_script (Begrüßung), image_url (Foto für einen Video-Avatar), 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 — Ihre Charaktere auflisten

Gibt { "data": [{ "id", "name", "characterType", "voice", "isVoiceOnly", ... }] } zurück.

Modelle und Preise

Die Preise sind in Site-Tokens angegeben (1 Token = 1 ₽). Die Tarife sind dynamisch und können sich ändern; diese Seite zeigt immer die aktuellen Werte.

Die Preise schwanken: Jede Anfrage wird mit ihren tatsächlichen Kosten berechnet, die Zahlen in den Tabellen sind also ein Richtwert und kein fester Tarif. Wenn sich ein Modellpreis im Laufe des Tages bewegt, wird darunter die Spanne der letzten 24 Stunden angezeigt.

Textmodelle (pro 1M Tokens)

Chat-Modelle (pro 1M Tokens)

Bilder (pro Bild)

Video

Musik

Sprachsynthese (pro 1000 Zeichen)

Audiotranskription (pro 1 Minute)

Fehler

Der Text-Endpunkt liefert Fehler im Anthropic-Format ({ "type": "error", "error": { "type", "message" } }), Chat — im OpenAI-Format ({ "error": { "message", "type" } }). Codes: 401 — fehlender/ungültiger Schlüssel, 403 — Konto gesperrt, 429 — Ratenbegrenzung überschritten, 400 — ungültige Anfrage oder zu wenige Tokens.

Support und Guthabenaufladung: https://neuralspace.pro/payment. Schlüssel verwalten: https://neuralspace.pro/api-keys.

Ready-to-copy settings for OpenCode, Claude Code, Cursor, Harness and MCP.