NeuralSpace API

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

وثائق موجهة للمطورين ووكلاء الذكاء الاصطناعي. هذه الصفحة متاحة دون الحاجة إلى مصادقة، وهي مُعدّة، ضمن أمور أخرى، لتُقرأ تلقائيًا.

عنوان URL الأساسي: https://neuralspace.pro. تدفع باستخدام توكنات رصيد الحساب (1 توكن = 1 ₽)، دون اشتراكات أو بطاقات أجنبية. نقاط النهاية الخاصة بالنصوص والمحادثة متوافقة مع SDK لكل من Anthropic و OpenAI — فقط غيّر base_url والمفتاح.

المصادقة

أنشئ مفتاح API في حسابك: https://neuralspace.pro/api-keys. يبدو المفتاح على شكل nsk-... ويُعرض مرة واحدة فقط. مرّره في الترويسة:

x-api-key: nsk-your_key

يُقبل أيضًا ترويسة Authorization: Bearer nsk-... (للعملاء المتوافقين مع OpenAI).

• حد الطلبات: 60 طلبًا في الدقيقة لكل مفتاح.
• الحد الأدنى للرصيد للوصول إلى نماذج النصوص: 50 توكن.
• البث (stream: true) مدعوم على /v1/messages و/v1/chat/completions: تصل الاستجابة عبر Server-Sent Events بصيغة SDK المقابلة (Anthropic / OpenAI). مع stream: false تحصل على استجابة JSON عادية.

خادم MCP — ربط NeuralSpace بوكيل الذكاء الاصطناعي الخاص بك

كل ما يمكن أن تقوم به هذه الواجهة البرمجية (توليد الصور/الفيديو/الموسيقى، والمحادثة مع نماذج اللغة الكبيرة، وتحويل النص إلى كلام والتعرّف عليه، والرصيد، والأسعار) متاح أيضًا كـخادم MCP (بروتوكول سياق النموذج) — يمكنك ربطه بـ 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-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 (نماذج اللغة الكبيرة)، generate_image، generate_video + check_video، generate_music + check_music، text_to_speech، transcribe_audio. تعمل الفوترة والمبالغ المستردة بنفس الطريقة المعتمدة في الاستدعاءات المباشرة للواجهة البرمجية؛ وتظهر عمليات التوليد الناجحة كبطاقات في حسابك. بالنسبة لتوليد الصور المتزامن (حتى نحو 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.

حقول النص (Body): model، messages (مصفوفة من {role, content}، والدور — 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 (الدور — 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-...").

الصوت في الوقت الفعلي

يتوفر Grok Think Fast عبر WebSocket للاستماع والتحدث في تدفق واحد. الحد الأقصى للجلسة 120 دقيقة. تُحسب التكلفة حسب مدة الصوت الفعلية الواردة والصادرة، والمبلغ الدقيق في جدول الأسعار أعلاه.

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

POST /v1/images/generations — توليد الصور

متزامن: تحتوي الاستجابة على رابط جاهز. يتم خصم الرموز فقط عند النجاح. النماذج: 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، resolution (1K/2K/4K — حيثما كان مدعومًا)، output_format (jpeg/png — nano-banana-pro)، quality (medium/high — gpt-image-15)، 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 مهمة ويخصم الرموز، ثم يتم الاستعلام عبر 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 — قصة مصورة (storyboard) من 2—5 لقطات؛ كل لقطة هي نص وصفي (prompt) أو كائن {prompt, duration} (مع multi_shots يُسمح بصورة واحدة على الأكثر في image_urls)؛
• elements — مصفوفة (حتى 4 عناصر) من الشخصيات/الأشياء الثابتة؛ يُشار إلى العنصر داخل النص الوصفي بالصيغة @element_<name>. كل عنصر: { "name": "...", "description": "...", "image_urls": [2—4 صور] } أو بدلًا من الصور، "video_url": "..." (فيديو واحد).

# 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 مهمة ويخصم الرموز، ثم يتم الاستعلام عبر GET /v1/music/generations/<id>. في حال حدوث خطأ أو انتهاء المهلة، تُسترد الرموز. عادةً ما تُعيد عملية إنشاء واحدة مقطعين صوتيين. النماذج: 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": "موسيقى synthwave نشيطة عن مدينة ليلية"}'
# response: { "id": "task_...", "status": "pending", "poll_url": "..." }

# 2. استقصاء الحالة حتى تختلف عن 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. متزامن: تحتوي الاستجابة على رابط ملف صوتي جاهز. يتم خصم الرموز فقط عند النجاح، بحسب عدد الأحرف. النماذج: 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. متزامن: تحتوي الاستجابة على النص المُتعرّف عليه. يتم خصم الرموز فقط عند النجاح، بحسب مدة الصوت (تُقدَّر من حجم الملف). النماذج: 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-your_key" \
  -F model="whisper-large-v3" \
  -F file="@audio.mp3"
# response: { "text": "...", "model": "whisper-large-v3", "usage": { "tokens": 0.2 } }

الاستجابة: { "text": "recognized text", "model": "whisper-large-v3", "usage": { "tokens": 0.2 } }.

POST /v1/characters — إنشاء شخصية / مساعد صوتي

تُنشئ شخصية ذكاء اصطناعي أو مساعدًا صوتيًا في حسابك (متوفر في قسم "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-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", ... }] }.

النماذج والأسعار

الأسعار بوحدة توكنات الموقع (1 توكن = 1 ₽). الأسعار ديناميكية وقد تتغير؛ هذه الصفحة تعرض دائمًا القيم الحالية.

الأسعار متغيّرة: يُحتسب كل طلب بتكلفته الفعلية، لذا فإن الأرقام في الجداول مرجعية وليست سعرًا ثابتًا. حيثما يتغير سعر نموذج خلال اليوم، يظهر أسفله النطاق خلال آخر 24 ساعة.

نماذج النصوص (لكل 1M توكن)

نماذج المحادثة (لكل 1M توكن)

الصور (لكل صورة)

الفيديو

الموسيقى

تحويل النص إلى كلام (لكل 1000 حرف)

تفريغ الصوت (لكل دقيقة واحدة)

الأخطاء

تُعيد نقطة النهاية الخاصة بالنصوص الأخطاء بصيغة Anthropic ({ "type": "error", "error": { "type", "message" } })، بينما نقطة نهاية المحادثة تُعيدها بصيغة OpenAI ({ "error": { "message", "type" } }). الرموز: 401 — مفتاح مفقود أو غير صالح، 403 — الحساب موقوف، 429 — تجاوز حد معدل الطلبات، 400 — طلب غير صالح أو توكنات غير كافية.

الدعم وشحن الرصيد: https://neuralspace.pro/payment. إدارة المفاتيح: https://neuralspace.pro/api-keys.