← جميع المقالات

واجهة Claude API: المفتاح ونقطة النهاية /v1/messages واختيار إصدار النموذج

مفتاح وصول رقمي متوهج بجانب كتل نصية مجسمة تطفو على خلفية داكنة

واجهة Claude API هي طريقة استدعاء نماذج Claude من كودك بدلاً من نافذة الدردشة: بوت دعم على موقعك، سكربت يفرز التذاكر، إكمال الكود في المحرر، تكامل مع نظام CRM. على NeuralSpace يُنشأ المفتاح في لوحة الحساب خلال دقيقة، ويذهب الطلب إلى نقطة النهاية POST /v1/messages المتوافقة مع Anthropic، والدفع من رصيد الرموز — دون اشتراك. فيما يلي خطوة بخطوة: كيف تحصل على المفتاح، وكيف يبدو أول استدعاء، وكيف تختار إصدار النموذج — Haiku أو Sonnet أو Opus أو Fable.

ما هي واجهة Claude API وكيف تختلف عن الدردشة

Claude هي عائلة نماذج اللغة من Anthropic. في نافذة الدردشة تتحدث مع النموذج يدوياً؛ وعبر الواجهة يفعل كودك الشيء نفسه: يرسل مصفوفة رسائل، ويستلم رداً مولَّداً ويستخدمه في منتجك — يعرضه للمستخدم أو يخزنه أو يعالجه لاحقاً. الاستخدامات النموذجية: بوتات الدعم، تلخيص البريد والمستندات، استخراج بيانات منظمة، صياغة المسودات، أتمتة الروتين في السكربتات. الفرق الجوهري عن الدردشة هو القابلية للضبط: أنت تحدد تعليمات النظام وحد الرد وإصدار النموذج، وترى الاستهلاك بالرموز.

الخطوة 1. الحصول على المفتاح

  1. سجّل في NeuralSpace بالبريد الإلكتروني — أقل من دقيقة. يحصل المستخدم الجديد على رموز ابتدائية تكفي لأول الطلبات دون شحن.
  2. افتح صفحة «مفاتيح API» في لوحة الحساب، وأدخل اسم المفتاح (مثلاً «بوتي») واضغط «إنشاء».
  3. المفتاح بالشكل nsk-… ويُعرض مرة واحدة فقط — انسخه فوراً إلى مدير كلمات المرور أو متغير بيئة، لا إلى كود المستودع.
  4. تحقق من الرصيد: تحتاج النماذج النصية إلى 50 رمزاً على الأقل في الحساب. الشحن يتم في لوحة الحساب، دون اشتراك شهري.
صفحة مفاتيح API في NeuralSpace: إنشاء مفتاح والبدء السريع مع Claude

الخطوة 2. أول طلب إلى /v1/messages

تعمل نماذج Claude النصية على نقطة النهاية POST https://neuralspace.pro/v1/messages المتوافقة مع Anthropic. يحمل الجسم النموذج، ومصفوفة messages بأدوار user/assistant، وحد الرد max_tokens (من 1 إلى 32000)، وتعليمات نظام اختيارية system. أبسط طلب عبر curl:

curl https://neuralspace.pro/v1/messages \
  -H "x-api-key: nsk-مفتاحك" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "system": "تجيب على الأسئلة التقنية بإيجاز.",
    "messages": [{"role": "user", "content": "كيف يختلف البث عن الرد العادي؟"}]
  }'

تأتي الاستجابة بصيغة Anthropic: النص في content[0].text، والاستهلاك الفعلي في حقل usage. المصادقة عبر رأس x-api-key: nsk-…؛ وللعملاء الذين يدعمون Bearer فقط يصلح Authorization: Bearer nsk-….

الخطوة 3. توصيل Anthropic SDK

إذا كان لديك كود جاهز على SDK الرسمي من Anthropic، فستغيّر قيمتين فقط — base_url والمفتاح:

from anthropic import Anthropic

client = Anthropic(
    base_url="https://neuralspace.pro",
    api_key="nsk-مفتاحك",
)

resp = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="تجيب على الأسئلة التقنية بإيجاز.",
    messages=[{"role": "user", "content": "اقترح ثلاثة أسماء لقناة عن الذكاء الاصطناعي"}],
)
print(resp.content[0].text)

لواجهات الدردشة يفيد البث: أضف "stream": true ليصل الرد على دفعات عبر Server-Sent Events، فيرى المستخدم الكلمات الأولى قبل انتهاء التوليد.

أي إصدار نموذج تختار

يضم كتالوج NeuralSpace العام أربعة إصدارات من Claude، والفرق بينها في الموازنة بين السرعة والسعر من جهة وعمق الاستدلال من جهة أخرى. الأسعار أدناه بالرموز لكل مليون رمز API، ويُحسب الإدخال والإخراج منفصلين (وقت النشر، والأسعار متغيرة):

  • Claude Haiku 4.5 (claude-haiku-4-5) — 41 / 213. الأسرع والأرخص: التصنيف، الردود القصيرة، المعالجة الجماعية للنصوص، الوسم الأولي.
  • Claude Sonnet 5 (claude-sonnet-5) — 152.5 / 767. حصان العمل: الكود، التعليمات الطويلة، الحوارات ذات السياق. الخيار الافتراضي المعقول.
  • Claude Opus 5 (claude-opus-5) — 359 / 1794.5. للمهام الصعبة: الاستدلال متعدد الخطوات، تحليل المستندات الكبيرة، المنطق الدقيق.
  • Claude Fable 5 (claude-fable-5) — 718 / 3589.5. الرائد لأكثر السيناريوهات تطلباً، حيث الجودة أهم من السعر.

قاعدة عملية: ابدأ بـHaiku أو Sonnet، وانتقل إلى Opus وFable بشكل انتقائي — فقط حيث يقصّر الأولان فعلاً. يُحدَّد الإصدار بحقل واحد model في الطلب، فيمكنك مقارنتها على نفس المطالبة.

البث والحدود ونقاط الخدمة

حدّان يتعثر بهما المبتدئون: 60 طلباً في الدقيقة لكل مفتاح، وحد أدنى للرصيد 50 رمزاً للنماذج النصية. الرصيد الحالي يعيده GET /v1/balance، وقائمة النماذج القابلة للقراءة آلياً مع الأسعار الحية يعيدها GET /v1/models. كلاهما يتطلب مفتاحاً. الأسعار الحالية معروضة دائماً في الجدول على صفحة توثيق API.

Claude API وMCP: التوصيل بـClaude Code

بنفس المفتاح يتصل NeuralSpace بوكلاء الذكاء الاصطناعي كخادم MCP: يستدعي الوكيل بنفسه الدردشة وتوليد الصور والفيديو والموسيقى باسم حسابك. مع Claude Code يكفي أمر واحد:

claude mcp add --transport http neuralspace https://neuralspace.pro/mcp \
  --header "Authorization: Bearer nsk-مفتاحك"

وإذا لم تكن بحاجة إلى الواجهة بعد، فالنماذج نفسها متاحة في الواجهة الرسومية — في الدردشة يمكنك اختيار Claude والتحدث دون كود، والرصيد مشترك بين الدردشة والواجهة.

أسئلة شائعة

هل أحتاج حساب Anthropic أو بطاقة أجنبية؟

لا. يُصدر المفتاح في لوحة حساب NeuralSpace، والدفع من رصيد الرموز — دون اشتراك ودون إعداد فوترة سحابية.

ما الفرق بين /v1/messages و/v1/chat/completions؟

هما صيغتان للواجهة نفسها. /v1/messages تحاكي Anthropic Messages API (الحقول model وmessages وsystem وmax_tokens) وتناسب نماذج Claude وAnthropic SDK. أما /v1/chat/completions فهي صيغة OpenAI لنماذج الدردشة GPT وGrok. يتغير العنوان وبنية الجسم فقط.

كم يكلّف استدعاء Claude API؟

فقط مقابل الرموز الفعلية: Claude Sonnet 5 وقت الكتابة — 152.5 رمزاً لكل مليون إدخال و767 لكل مليون إخراج. طلب ببضعة آلاف من الرموز يكلّف نحو 1 ₽. الأسعار الحالية في GET /v1/models وفي جدول التوثيق.

هل توجد باقة مجانية؟

لا توجد توليدات مجانية على المنصة. يحصل المستخدم الجديد على رموز ابتدائية تكفي للتجارب الأولى، وبعدها الدفع بالرموز دون اشتراك شهري.