لإجراء أول طلب API لـ Claude، قم بإنشاء مفتاح Claude Console، واحفظه في متغير بيئة، ثم قم باستدعاء نقطة نهاية Messages، واقرأ القيمة المُرجعة الاستخدام الحقول، وحساب تكلفة التوكن. يشرح هذا الدليل هذه الخطوات باستخدام معرّفات النماذج الحالية والأسعار التي تم التحقق منها في 8 سبتمبر 2026.
بمجرد أن تفهم مسار واجهة برمجة التطبيقات (API)، فإن السؤال التالي هو: ما هي نسبة أعمالك اليومية التي تحتاج فعليًّا إلى تكامل مخصص؟ بالنسبة للبحث، والكتابة، والبرمجة، والإنتاج الإبداعي،, جلوبال جي بي تي تي يوفر طريقة أكثر اقتصادية لاستخدام Claude جنبًا إلى جنب مع GPT-5.6 Sol وGemini 3 Pro وKimi K3 وغيرها من الطرز الرائدة. يجمع اشتراك واحد بين النماذج ومجموعة واسعة من أدوات الذكاء الاصطناعي في لوحة تحكم واحدة، بحيث يمكن نقل العمل من الفكرة إلى الناتج دون الحاجة إلى تقسيمه عبر خدمات منفصلة. وعندما تحتاج إلى دمج الذكاء الاصطناعي في بيئة التطوير الخاصة بك، تعمل واجهة سطر الأوامر GlobalGPT على ربط مساحة العمل نفسها بجهازك الطرفي وأدوات الإنتاج الحالية.
ما هي واجهة برمجة التطبيقات Claude؟
واجهة برمجة التطبيقات (API) Claude هي واجهة المطور الخاصة بـ Anthropic، والتي تُستخدم لإرسال طلبات منظمة إلى نماذج Claude من تطبيق أو برنامج نصي أو خدمة خلفية. حيث تقوم بإرسال رسائل إلى نقطة نهاية HTTPS وتستلم استجابة منظمة تحتوي على المحتوى الذي تم إنشاؤه بالإضافة إلى البيانات الوصفية مثل النموذج وسبب الإيقاف واستخدام الرمز المميز.
اشتراكات Claude API مقابل Claude.ai
يخدم الوصول إلى واجهة برمجة التطبيقات (API) واشتراكات Claude.ai أغراضًا مختلفة. تتيح باقة Claude.ai للمستخدم الوصول إلى منتج الدردشة الخاص بـ Anthropic. أما واجهة برمجة التطبيقات (API) فهي عبارة عن وصول محدود للمطورين عبر Claude Console، مع فوترة منفصلة بناءً على الاستخدام. ويشير مركز المساعدة الخاص بـ Anthropic إلى أن باقة Claude Pro لا تشمل استخدام واجهة برمجة التطبيقات (API) الخاصة بـ Console.
إذا كنت بحاجة إلى معرفة الفرق الأوسع نطاقًا بين خطط المستهلكين، ورمز Claude، والفوترة الرمزية، فراجع دليلنا الكامل دليل أسعار Claude. في هذا الدليل التعليمي، النقطة المهمة بسيطة: قم بإنشاء حساب API وتمويله بشكل منفصل عن أي اشتراك في Claude.ai.
مسار من خمس خطوات لتقديم الطلب الأول
- قم بإنشاء مفتاح API في وحدة التحكم Claude.
- قم بتخزينه في
ANTHROPIC_API_KEYمتغير بيئي. - أرسل طلبًا إلى
https://api.anthropic.com/v1/messages. - اقرأ المحتوى الذي تم إرجاعه و
الاستخدامكائن. - اضرب كل فئة من فئات التوكنات في السعر المطبق لكل مليون توكن.
أسعار واجهة برمجة التطبيقات (API) لـ Claude ومعرّفات الطرازات الحالية
تُدرج Anthropic أسعار واجهة برمجة التطبيقات (API) بالدولار الأمريكي لكل مليون توكن، ويُشار إليها غالبًا بالاختصار MTok. ويتم احتساب تكاليف الإدخال والإخراج بشكل منفصل. وتضيف ميزة التخزين المؤقت للطلبات أسعارًا مختلفة لعمليات الكتابة التي تستغرق خمس دقائق، وعمليات الكتابة التي تستغرق ساعة واحدة، وعمليات القراءة من ذاكرة التخزين المؤقت؛ لذا فإن التقدير الموثوق به هو الفصل بين هذه الفئات.
الطرز الحالية ومعرّفات واجهة برمجة التطبيقات (API) الدقيقة
| نموذج | معرّف واجهة برمجة التطبيقات (API) | الإدخال / MTok | الإخراج / MTok |
|---|---|---|---|
| Claude Fable 5.1 | كلود-القصص الخيالية-5-1 | $10 | $50 |
| Claude Opus 5 | كلود - الأوبوس رقم 5 | $5 | $25 |
| كلود سونيت 5 | كلود-سونيت-5 | $2 | $10 |
| كلود هايكو 4.5 | claude-haiku-4-5-20251001 | $1 | $5 |

ما هو النموذج الذي ينبغي عليك استخدامه في هذا الدرس التعليمي؟
دليل البدء السريع الرسمي المستخدم كلود - الأوبوس رقم 5 عندما تم التحقق من صحة هذا الدليل، لذا فإن أمثلة cURL وPython الواردة أدناه تستخدم نفس المعرّف. تعامل مع Opus كنقطة انطلاق لهذا البرنامج التعليمي، ثم اختر نموذج الإنتاج وفقًا لحجم العمل ومتطلبات الجودة وزمن الاستجابة والميزانية. قد تتغير معرّفات النماذج وحالة دورة الحياة، لذا يرجى إعادة التحقق من صفحات «النماذج» و«النماذج التي تم إيقاف دعمها» قبل نشر كود طويل الأمد.

دولار أمريكي لكل مليون توكن. تم توحيد طول الشريط وفقًا للحد الأقصى لمخرجات مؤشر $50.
كلود-القصص الخيالية-5-1كلود - الأوبوس رقم 5كلود-سونيت-5claude-haiku-4-5-20251001ما تحتاجه قبل تقديم طلبك الأول
إنشاء حساب على منصة Claude ومفتاح واجهة برمجة التطبيقات (API)
افتح واجهة Claude Console، وأنشئ المؤسسة المناسبة أو حددها، ثم أنشئ مفتاح API. يُنبه Anthropic إلى أن المفتاح الجديد لا يُعرض إلا مرة واحدة، لذا احفظه في أداة إدارة الأسرار المعتمدة أو في أي مكان آمن آخر فور ظهوره. لا تدرج المفتاح في لقطة شاشة أو مستند مشترك أو مستودع عام أو في جافا سكريبت على جانب المتصفح.

قم بتخزين المفتاح في متغير بيئة
تتطلب الأمثلة المتغير ANTHROPIC_API_KEY. أدخل القيمة الحقيقية فقط في محطة العمل الخاصة بك أو في نظام إدارة الأسرار. يقوم الأمر أدناه بقراءة القيمة دون عرضها على الشاشة، ثم يقوم بتصديرها لجلسة العمل الحالية في شل:
read -s ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY
تقلل متغيرات البيئة من التعرض العرضي للمعلومات السرية، لكنها لا تشكل استراتيجية كاملة لإدارة الأسرار. وينبغي أن تتبع تطبيقات الإنتاج ممارسات منصة الاستضافة المتعلقة بتخزين الأسرار والتحكم في الوصول إليها.
تحقق من الفواتير واختر حدًا آمنًا للاختبار
تُعتبر فواتير واجهة برمجة التطبيقات (API) منفصلة عن اشتراكات Claude.ai. وتشير Anthropic إلى أن معظم المؤسسات تدفع مسبقًا مقابل رصيد الاستخدام، في حين تُعد المؤسسات التي تتلقى فواتير شهرية استثناءً من ذلك. تأكد من أن حسابك على «Console» قادر على إرسال طلبات API، ثم اجعل الطلب الأول صغير الحجم باستخدام max_tokens: 128. هذا الحقل يحدد حجم المخرجات الناتجة؛ وهو لا يحجز أو يضمن 128 توكنًا من المخرجات المفوترة.
أرسل أول طلب API لـ Claude باستخدام cURL
يُعد cURL أداة مفيدة للاطلاع على بنود الطلب مباشرةً. يستخدم المثال أدناه نقطة نهاية «المسرات»، ونوع المحتوى JSON، ورأس مفتاح واجهة برمجة التطبيقات (API)، ورأس إصدار Anthropic، ومعرّف نموذج «Quickstart» الذي تم التحقق منه، ورسالة واحدة من المستخدم.
قبل تشغيل أي من المثالين، أضف مفتاح API الخاص بك وتأكد من تفعيل الفوترة الخاصة بـ API للمؤسسة. يتبع الكود تنسيق الطلب الموثق في Anthropic وقد اجتاز فحوصات الصياغة المحلية، ولكن لم يتم تضمين أي استجابة من الحساب الفعلي هنا.
وظيفة كل رأس وحقل في JSON
| جزء | الغرض |
|---|---|
نوع المحتوى | يُعلم نقطة النهاية بأن نص الطلب مكتوب بتنسيق JSON. |
x-api-key | يقوم بالتحقق من صحة الطلب باستخدام القيمة المخزنة في متغير البيئة. |
النسخة البشرية | يحدد عقد واجهة برمجة التطبيقات (API) الموثق الذي يستخدمه الطلب. |
نموذج | يحدد معرّف نموذج واجهة برمجة التطبيقات (API) Claude بدقة. |
ماكس_توكينز | يحدد الحد الأقصى لعدد الرموز التي يمكن أن يولدها Claude لهذا الرد. |
الرسائل | يقدم مدخلات المحادثة مرتبةً حسب الترتيب، بما في ذلك كل دور وقيمة محتوى. |
إذا أرجع الأمر خطأً، فاقرأ حالة HTTP ونوع الخطأ قبل تعديل الطلب. تتطلب أخطاء المصادقة والفوترة إجراء تصحيح على الحساب، بينما يتطلب JSON غير الصحيح أو معرّف النموذج غير الصحيح تعديل الطلب.
إرسال الطلب نفسه باستخدام حزمة SDK الخاصة بـ Python
تثبيت حزمة أدوات تطوير البرامج (SDK) الرسمية لـ Anthropic
python -m pip install anthropic
استخدم بيئة افتراضية عندما يكون ذلك جزءًا من سير عملك المعتاد في لغة بايثون. يقرأ SDK ANTHROPIC_API_KEY من البيئة عندما anthropic.Anthropic() يتم إنشاؤه بدون مفتاح صريح.
تشغيل طلب Python المكافئ

اقرأ النص الذي تم إرجاعه بأمان
يمكن أن تحتوي استجابة الرسالة على أكثر من كتلة محتوى واحدة، لذا يتحقق المثال من نوع كل كتلة قبل عرض النص. كما يجب على التطبيقات الفعلية الاحتفاظ بمعرّف الطلب متاحًا لأغراض الدعم والتسجيل دون الكشف عنه علنًا، وتسجيل النموذج الذي تم إرجاعه وسبب الإيقاف، والتعامل مع أخطاء واجهة برمجة التطبيقات (API) بشكل صريح.
احتفظ بعلامة تحديد «كتلة المحتوى» حتى عندما تتوقع إجابة نصية قصيرة. فهذا يسهل توسيع المثال عندما تحتوي الإجابة على عدة كتل، وعند الطباعة message.usage يوفر لك الأرقام اللازمة لحساب التكلفة أدناه.
كيفية قراءة الاستهلاك وحساب التكلفة
ابحث عن نص الرد، والنموذج، وسبب الإيقاف، ومعرّف الطلب
يتضمن عقد استجابة واجهة برمجة تطبيقات الرسائل (Messages API) المحتوى الذي تم إنشاؤه، والنموذج الذي عالج الطلب، وسبب الإيقاف. كما تتضمن استجابة HTTP معرّف الطلب الذي يمكن أن يساعد فريق الدعم في Anthropic على تتبع المشكلة. قم بتسجيل المعرّفات بعناية؛ ولا تنشرها مع محتوى العملاء أو بيانات اعتمادهم.
البحث عن استخدام الرموز في المدخلات والمخرجات وذاكرة التخزين المؤقت
إن الاستخدام يُبلغ الكائن عن فئات الرموز المطلوبة لتحليل التكلفة. على الأقل، ابحث عن رموز الإدخال والإخراج. عند استخدام التخزين المؤقت للمطالبات، احرص على الفصل بين عمليات الكتابة إلى ذاكرة التخزين المؤقت التي تتم كل خمس دقائق، وعمليات الكتابة التي تتم كل ساعة، وعمليات القراءة من ذاكرة التخزين المؤقت، نظرًا لاختلاف معدلاتها. يمكن لنقطة نهاية «Token Counting» في Anthropic تقدير الرموز الداخلة قبل الطلب، لكن التقدير قد يختلف قليلاً عن الاستخدام النهائي للرموز الداخلة، وله حدود معدلات خاصة به.
تحويل استخدام الرموز إلى تكلفة تقديرية
احسب كل فئة على حدة، ثم اجمع النتائج. في مثال تخطيطي باستخدام Claude Opus 5 بالمعدلات العالمية القياسية، تبلغ تكلفة 1,000 رمز إدخال غير مخزّن مؤقتًا 1,000 × $5 / 1,000,000 = $0.005, ، في حين أن 300 توكن من الناتج تكلف 300 × $25 / 1,000,000 = $0.0075. ويبلغ المجموع التقديري $0.0125. استبدل أعداد الرموز التوضيحية هذه بـ الاستخدام القيم المستمدة من إجابتك.
حاسبة أسعار واجهة برمجة التطبيقات Claude
استخدم الآلة الحاسبة لتغيير النموذج، وعدد الطلبات، وفئات الرموز، ووضع الفوترة، والموقع الجغرافي للاستدلال. تُحسب أسعار المعالجة المجمعة للاستخدام المؤهل بمعدل 50% من الأسعار القياسية. يُطبق الاستدلال داخل الولايات المتحدة فقط معاملًا قدره 1.1x على جميع فئات الرموز للنماذج المؤهلة Claude 4.6+؛ أما النموذج Claude Haiku 4.5 فليس مؤهلاً، لذا فإن هذا المزيج يُرجع حالة غير مدعومة.
تقدير قيمة الرمز الأساسي بالدولار الأمريكي. لا تشمل الرسوم الخاصة بالحساب.
يُعد التقدير أداة مساعدة في التخطيط، وليس فاتورة. ولا يشمل الضرائب، وتحويل العملات، والشروط المتفق عليها، و«الوضع السريع»، ورسوم أدوات الخادم، والشروط الخاصة بالحساب. قد تتغير الأسعار وشروط الأهلية، لذا يرجى إعادة التحقق من صفحة الأسعار الرسمية قبل اتخاذ أي قرار بشأن الشراء أو البنية.
تُظهر الآلة الحاسبة أعلاه هيكل تكلفة مكالمات واجهة برمجة التطبيقات (API) القابلة للبرمجة والمقاسة بنظام Claude. بالنسبة للأعمال اليومية التي تشمل عدة نماذج وقدرات الذكاء الاصطناعي،, جلوبال جي بي تي تي تقدم قيمة من نوع مختلف: حيث يجمع اشتراك واحد بين العديد من النماذج والأدوات الشائعة في لوحة تحكم واحدة، مما يسهل توقع التكاليف مع تجنب الحاجة إلى اشتراكات منفصلة وواجهات متفرقة لإجراء الأبحاث والكتابة والبرمجة والأعمال الإبداعية. كما أن واجهة سطر الأوامر (CLI) الخاصة بها تنقل نفس المنصة إلى بيئة التطوير القائمة على المحطة الطرفية وأدوات الإنتاج التي تستخدمها بالفعل. دليلنا إلى العمل مع نماذج ذكاء اصطناعي متعددة في مكان واحد يوضح كيف تتكامل أجزاء المنصة الأوسع نطاقًا مع بعضها البعض.
الأخطاء الشائعة في واجهة برمجة التطبيقات Claude وحلولها
ابدأ بالاطلاع على حالة HTTP ونوع الخطأ Anthropic، ثم افحص الطلب دون الكشف عن المفتاح. يساعد التعريف الرسمي في تضييق نطاق البحث؛ لكن السبب المحتمل لا يزال يعتمد على حسابك، والطراز المختار، وشكل الطلب، وحجم حركة المرور.

| الحالة | الحدود الرسمية | ما الذي يجب التحقق منه بعد ذلك | هل تريد إعادة المحاولة؟ |
|---|---|---|---|
| 400 | طلب غير صالح | التحقق من صحة JSON وأسماء الحقول والأدوار ومعرّف النموذج ومجموعات المعلمات. | فقط بعد تصحيح الطلب. |
| 401 | خطأ في المصادقة | تأكد من وجود المفتاح، ومن أنه نشط، ومن أنه يصل إلى الخادم عبر x-api-key. لا تطبعه أبدًا. | لا تقم بإعادة المحاولة بشكل عشوائي؛ قم بإصلاح عملية المصادقة أولاً. |
| 402 | متطلبات الفوترة أو الائتمان | تحقق من فواتير واجهة برمجة التطبيقات (API) الخاصة بالمنظمة ورصيد الاستخدام المتاح في «Console». | بعد تسوية مسألة الفوترة. |
| 403 | خطأ في الأذونات | تحقق مما إذا كان المفتاح والمنظمة يمكنهما استخدام المورد أو النموذج المطلوب. | لا تُكرر المحاولة دون تفكير؛ قم بتصحيح الوصول أولاً. |
| 404 | لم يتم العثور على المورد | تحقق من نقطة النهاية، ومعرّف المورد، ودورة حياة النموذج، والتهجئة. | فقط بعد تصحيح الهدف. |
| 413 | الطلب كبير جدًّا | قلل حجم الطلب أو قسّم البيانات المدخلة؛ لا تكتفِ بزيادة الحجم فحسب ماكس_توكينز. | بعد تقليص الطلب. |
| 429 | تم تجاوز حد المعدل | افحص رؤوس "تحديد معدل الاستخدام" ومستوى خدمة "Console" الخاص بك، وقلل من عدد العمليات المتزامنة، وقم بالتخفيف. | نعم، مع التراجع المنظم. |
| 500 | خطأ داخلي في واجهة برمجة التطبيقات (API) | تسجيل معرّف الطلب، والحفاظ على خاصية الإيدمبوتنس، والتحقق من معلومات حالة Anthropic. | عادةً، مع تراجع محدود. |
| 504 | انتهت مهلة البوابة | تحقق مما إذا كان الطلب طويلاً بشكل غير معتاد، وما إذا كانت إعادة المحاولة ستؤدي إلى تكرار العمل. | في كثير من الأحيان، إذا كان من الآمن إعادة محاولة العملية. |
| 529 | API محملة بشكل زائد مؤقتًا | تقليل عدد المرات المتتالية وإعادة المحاولة بعد فترة التراجع؛ لا تعتبر الحمل الزائد بمثابة فشل في المصادقة. | نعم، مع تراجع محدود. |

ترتيب آمن لتصحيح الأخطاء
- قم بتسجيل الحالة ونوع الخطأ والطابع الزمني ومعرّف الطلب دون تسجيل مفتاح واجهة برمجة التطبيقات.
- تحقق من نقطة النهاية، والرؤوس، وصيغة JSON، ومعرّف النموذج، وحد حجم الطلب.
- تحقق من إعدادات الفوترة الخاصة بالمؤسسة، والأذونات، ورؤوس تحديد الحد الأقصى لمعدل الاستخدام، ودورة حياة النموذج الحالية.
- أعد المحاولة فقط في حالة الأخطاء التي يمكن اعتبارها مؤقتة بشكل معقول، باستخدام تأخير أسي محدود وتذبذب محدود.
- إذا استمر الخطأ، فقم بتبسيط الطلب إلى أصغر حالة يمكن تكرارها قبل الاتصال بفريق الدعم.
تقوم حزم SDK الرسمية لـ Anthropic بإعادة محاولة إصلاح أخطاء الاتصال والاستجابات 429 والاستجابات 5xx مرتين بشكل افتراضي. ولا تزال منطقية إعادة المحاولة على مستوى التطبيق بحاجة إلى حدود ومراعاة خاصية الإيدمبوتنس، خاصةً عندما يكون الطلب قادرًا على تشغيل أدوات أو إجراء خارجي آخر.
كيفية التحكم في تكاليف واجهة برمجة التطبيقات Claude
تحديد حدود إخراج متحفظة
ابدأ بالأصغر ماكس_توكينز قيمة لا تزال قادرة على إعطاء إجابة مفيدة. قم بقياس الاستخدام الفعلي للمخرجات قبل زيادتها. قد تساعد المطالبات الأقصر في ذلك، لكن حذف التعليمات التي تمنع إعادة المحاولة أو الأخطاء أو المخرجات غير الصالحة للاستخدام قد يكلف أكثر بشكل عام.
استخدم التخزين المؤقت للموجهات و«الدُفعات» فقط عندما يكون ذلك مناسبًا
- استخدم التخزين المؤقت للمطالبات عندما يتكرر بادئة مطالبة بشكل كبير وتكون مدة صلاحية ذاكرة التخزين المؤقت متوافقة مع سير العمل.
- استخدم خدمة «Batch» للأعمال التي يمكن إنجازها بشكل غير متزامن؛ ويُحسب سعر الاستخدام المؤهل لخدمة «Batch» على أساس 50% من الأسعار القياسية.
- احرص على الفصل بين عمليات الكتابة والقراءة في ذاكرة التخزين المؤقت في التقارير، بحيث يكون التوفير مرئيًا بدلاً من أن يكون مجرد افتراض.
- لا تستخدم الاستدلال الخاص بالولايات المتحدة إلا عندما يبرر شرط الإقامة معامل سعر التوكن البالغ 1.1x، ويكون النموذج المختار مؤهلاً لذلك.
مراقبة الاستخدام، وحدود السرعة، وحدود الإنفاق
تتبع عدد الطلبات، ومعرّف النموذج، واستخدام المدخلات والمخرجات، وفئات ذاكرة التخزين المؤقت، ومحاولات الإعادة، والأخطاء. قم بتعيين التنبيهات أو ضوابط الإنفاق المتاحة لمؤسستك، ولكن لا تفترض أن فئة أو حد حساب آخر ينطبق على حسابك. دليلك التفصيلي حول باقات Claude، وتكاليف واجهة برمجة التطبيقات (API)، والحدود يغطي مسارات الفوترة الأوسع نطاقًا.
الخطوات التالية بعد تقديم طلبك الأول
اختر المسار المناسب لمشروعك القادم
للتطبيق، تابع الاطلاع على المرجع الرسمي لواجهة برمجة تطبيقات الرسائل (Messages API) الخاصة بـ Anthropic، وإرشادات البث المباشر، ووثائق استخدام الأدوات، وصفحات دورة حياة النماذج، بالإضافة إلى خطة التسجيل والتقييم الخاصة بك. حدد استراتيجية النموذج بعناية، وعالج الأخطاء قبل إضافة حركة المرور، واحسب التكاليف بناءً على الاستخدام الفعلي بدلاً من طول المطالبة وحدها.
إذا كان البرمجة هي الغرض الرئيسي الذي تستخدمه من أجله، فإن دليلنا الخاص بـ استخدام كلود الذكاء الاصطناعي للترميز يتناول هذا المقال طرقًا عملية للانتقال من مهمة برمجة تفاعلية إلى سير عمل قابل للتكرار للمطور.
متى تكون مساحة العمل متعددة النماذج هي الأداة الأفضل
يُعد الوصول المباشر عبر واجهة برمجة التطبيقات (API) الخيار الأمثل عندما تحتاج إلى تكامل على مستوى الكود، أو الفوترة للمطورين، أو الحصول على بيانات وصفية للطلبات، أو عناصر التحكم الرسمية في المنصة. أما إذا كان هدفك هو الكتابة التفاعلية، أو البحث، أو التخطيط، أو مقارنة النتائج بين مختلف مزودي الخدمة دون الحاجة إلى إنشاء تطبيق، فقد تكون مساحة العمل متعددة النماذج خيارًا أكثر عملية.
الأسئلة المتداولة
هل واجهة برمجة التطبيقات Claude مجانية؟
لا يتم هنا الوعد بتوفير حصة مجانية عامة لاستخدام واجهة برمجة التطبيقات (API). يتم احتساب تكلفة استخدام واجهة برمجة التطبيقات (API) الخاصة بـ Claude بشكل منفصل عبر منصة Claude Console، وتشير Anthropic إلى أن معظم المؤسسات تمول هذا الاستخدام من خلال أرصدة مدفوعة مسبقًا، في حين تُعد المؤسسات التي تتلقى فواتير شهرية استثناءً من ذلك. يرجى مراجعة أحدث المعلومات المتوفرة على منصة Console ومعلومات التسعير الرسمية الخاصة بمؤسستك قبل إرسال الطلبات.
كيف يمكنني الحصول على مفتاح API لـ Claude؟
قم بإنشاء مفتاح في وحدة التحكم Claude للمؤسسة المعنية. يُحذر Anthropic من أن المفتاح الجديد لا يُعرض إلا مرة واحدة، لذا احرص على تخزينه في مكان آمن عند ظهوره. قم بتحميله عبر متغير بيئة من جانب الخادم أو مدير السر، ولا تكشف عنه أبدًا في كود المتصفح أو لقطات الشاشة أو مستودع عام.
ما هو معرّف طراز Claude الذي يجب أن أستخدمه؟
يستخدم هذا البرنامج التعليمي كلود - الأوبوس رقم 5 لأن هذا كان النموذج المذكور في دليل البدء السريع الرسمي لـ Anthropic عند التحقق منه في 8 سبتمبر 2026. اختر النموذج الذي يناسب حجم عملك وميزانيتك، وأعد التحقق من صفحات «النماذج» و«النماذج التي تم إيقاف دعمها» الخاصة بـ Anthropic، لأن معرّفات النماذج والأسماء المستعارة وحالة دورة الحياة قد تتغير.
ما هي نقطة النهاية التي تستخدمها واجهة برمجة التطبيقات Claude؟
يستخدم الطلب الأول في هذا الدليل نقطة نهاية «المراسلات» (Messages) الموجودة على https://api.anthropic.com/v1/messages. وهو يرسل بيانات JSON مع رؤوس «content-type» و«x-api-key» و«anthropic-version». يوفر Anthropic إمكانيات أخرى لواجهة برمجة التطبيقات (API) أيضًا، لذا استخدم صفحة المرجع الخاصة بالعملية التي تقوم بتنفيذها.
هل تتضمن باقة Claude Pro رصيدًا لخدمات واجهة برمجة التطبيقات (API)؟
يذكر مركز المساعدة الخاص بـ Anthropic أن إصدار Claude Pro لا يشمل الاستخدام عبر Claude Console. ويُعد اشتراك Claude.ai وفوترة واجهة برمجة التطبيقات (API) منتجين منفصلين. قم بإعداد فوترة واجهة برمجة التطبيقات (API) في Console لطلبات المطورين، واستخدم دليل أسعار Claude لإجراء مقارنة أوسع نطاقًا بين الخطط.
كم تبلغ تكلفة طلب واحد عبر واجهة برمجة التطبيقات (API) بنمط Claude؟
تعتمد التكلفة على الطراز المختار، ووحدات التوكينات المدخلة، ووحدات التوكينات المخرجة، وعمليات الكتابة إلى ذاكرة التخزين المؤقت، وعمليات القراءة من ذاكرة التخزين المؤقت، ووضع الدُفعات، والمناطق الجغرافية المؤهلة للاستدلال. احسب كل فئة بضرب عدد الطلبات في عدد وحدات التوكينات ثم في السعر الفعلي لكل مليون وحدة توكين، ثم قسم الناتج على مليون، ثم اجمع الفئات معًا. استخدم الآلة الحاسبة أعلاه للحصول على تقدير للتكلفة.
لماذا تظهر لي رسالة الخطأ 401؟
الرمز 401 هو خطأ في المصادقة. تأكد من أن مفتاح واجهة برمجة التطبيقات (API) موجود، ولا يزال نشطًا، وينتمي إلى المؤسسة المقصودة، ويصل إلى الخادم في x-api-key العنوان. لا تقم بطباعة المفتاح أو مشاركته أثناء عملية تصحيح الأخطاء. لن تؤدي المحاولات المتكررة إلى إصلاح بيانات الاعتماد المفقودة أو غير الصالحة.
لماذا تظهر لي رسالة الخطأ 429؟
تشير الرمز 429 إلى أن الطلب تجاوز حد المعدل المسموح به. قد تختلف هذه الحدود باختلاف المؤسسة ومستوى الاستخدام، لذا يرجى فحص رؤوس «حد المعدل» التي تم إرجاعها والاطلاع على «وحدة التحكم» الحالية أو الوثائق. قم بتقليل عدد العمليات المتزامنة، واحترم توقيت إعادة المحاولة، واستخدم «التراجع الأسي المحدود» مع التذبذب بدلاً من تكرار نفس السلسلة من الطلبات على الفور.
ملاحظة بشأن المصدر والطزاجة: تم التحقق من معرّفات النماذج والأسعار وسلوك واجهة برمجة التطبيقات (API) وسياسات الدعم مقارنةً بالوثائق الرسمية لـ Anthropic بتاريخ 8 سبتمبر 2026. يرجى مراجعة صفحات النماذج والأسعار الحالية قبل الاستخدام في بيئة الإنتاج، ثم قم بتشغيل الأمثلة باستخدام مفتاح Claude Console الخاص بك، وإعدادات الفوترة، وبيانات الوصول إلى حسابك.




