NeuralSpace API

Sprache: Русский · 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

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-haiku-5-5, claude-sonnet-5, claude-sonnet-5-5, claude-opus-5, claude-opus-5-5, claude-fable-5, claude-fable-5-1.

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-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, kimi-k2.6, kimi-k3, kimi-k3.1-pro.

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, nano-banana-2-1, flux-2-pro, gpt-image-15, gpt-image-2, gpt-image-2-pro, gpt-image-25, seedream-45, seedream-5-lite, seedream-5-flash, 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), 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 (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 } }.

Eingabebilder: URL oder Base64

Jedes Element von image_urls ist entweder eine URL oder Base64: eine Data-URL wie data:image/png;base64,... oder reines Base64 ohne Präfix. Das Bild wird dekodiert, geprüft und auf dem Server gespeichert; die Modelle erhalten es danach als normale URL — Antwort und Abrechnung unterscheiden sich nicht von der Übergabe per Link. Formate: PNG/JPEG/WebP; bis zu 10 MB pro Bild und bis zu 72 MB Medien pro Anfrage. Ungültiges Format, ein deklarierter Typ, der nicht zum Dateiinhalt passt, oder Überschreitung des Limits — Fehler 400, es werden keine Tokens berechnet.

# 2. image_urls als URL ODER base64 (data:image/png;base64,...)
curl https://neuralspace.pro/v1/images/generations \
  -H "x-api-key: nsk-your_key" \
  -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 — 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, kling-4-0, grok-1.5, grok-imagine, wan-2.6, gemini-omni-flash-1-1, gemini-omni-1, vidu-q4.

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:

kling-4-0: duration ist eine ganze Zahl von 3 bis 30, resolution ist 720p/1080p und aspect_ratio ist auto/16:9/9:16/1:1/21:9. Der reference-Modus akzeptiert bis zu 10 image_urls, 5 video_urls, 7 elements ({name, image_urls oder video_url, tag, description, voice_url}) und 3 voices ({name, audio_url}); insgesamt höchstens 15 Bild-/Video-Referenzen. Medien in diesen Feldern können URLs oder Base64 sein. keep_original_sound ist mit Eingabevideo verfügbar. Der keyframe-Modus akzeptiert first_frame_url, last_frame_url und bis zu 8 keyframe_urls; die Modi lassen sich nicht kombinieren.

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

Eingabevideo: URL oder Base64

Eingabevideos können ebenfalls als Base64 übergeben werden: Elemente von video_urls/reference_video_urls, video_list[].url, elements[].video_url — entweder eine URL oder eine Data-URL data:video/mp4;base64,... oder reines Base64. Formate: MP4/WebM/MOV; bis zu 64 MB pro Video (innerhalb des Gesamtlimits von 72 MB Medien pro Anfrage). Dieselben Prüfungen gelten: Dateisignatur, ein deklarierter Typ, der nicht zum Inhalt passt — Fehler 400 ohne Token-Abbuchung.

# Referenzvideo als URL ODER base64 (data:video/mp4;base64,...)
curl https://neuralspace.pro/v1/videos/generations \
  -H "x-api-key: nsk-your_key" \
  -H "content-type: application/json" \
  -d '{"model": "seedance-2.5", "prompt": "continue this clip", "duration": 5,
       "video_urls": ["data:video/mp4;base64,AAAAIGZ0eXBpc29t..."]}'

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

Video-Avatare

Sprechende Video-Avatare und verwandte Modi. Verzeichnisse: GET /v1/avatars (avatar_id), GET /v1/avatars/voices?language=en (voice_id), GET /v1/avatars/languages (Übersetzungssprachen), /v1/avatars/styles, /v1/avatars/templates, /v1/avatars/assets, /v1/avatars/brand-kits. Die Generierung ist asynchron: POST /v1/avatars/generations mit einem type-Feld, danach GET /v1/avatars/generations/<id> abfragen. Tokens werden bei der Erstellung berechnet und bei einem Fehler zurückerstattet.

curl https://neuralspace.pro/v1/avatars/voices?language=en \
  -H "x-api-key: nsk-your_key"

curl https://neuralspace.pro/v1/avatars/generations \
  -H "x-api-key: nsk-your_key" \
  -H "content-type: application/json" \
  -d '{"type": "talking_avatar", "avatar_id": "avatar_...", "voice_id": "voice_...", "script": "Hello!"}'
# response: { "id": "task_...", "status": "pending", "poll_url": "..." }

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)

Video-Avatare

3D models (Tripo)

3D generation and model processing: 18 operations (3D from text/photo/views, splat, images, texture, segmentation, completion, retopology, UV, format conversion, rigging, animations). Operation codes and parameters: GET /v1/tripo/tools; token prices use the live rate. Asynchronous creation: POST /v1/tripo/tasks (tool, prompt, params, image_urls, animations), then poll GET /v1/tripo/tasks/<id>. Results are stored in our storage with permanent links. Tokens are charged on creation and refunded on failure.

curl https://neuralspace.pro/v1/tripo/tools \
  -H "x-api-key: nsk-your_key"

curl https://neuralspace.pro/v1/tripo/tasks \
  -H "x-api-key: nsk-your_key" \
  -H "content-type: application/json" \
  -d '{"tool": "text-to-3d", "prompt": "a wooden chair"}'
# response: { "id": "...", "status": "pending", "poll_url": "/v1/tripo/tasks/..." }

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.