يتصل Antigravity بمفتاح Anthropic API لتوجيه طلبات نماذج Claude مباشرة عبر حسابك. يشرح هذا المقال خطوات الإعداد بالتفصيل، واختيار النموذج، والفوترة، وحدود المعدل، وكيفية تصحيح أخطاء الاتصال الشائعة.
إذا كنت تشغّل سير عمل الذكاء الاصطناعي يدويًا، وتنسخ المخرجات بين الأدوات، أو تدفع ثمن اشتراكات متعددة فقط للوصول إلى نماذج لغوية مختلفة، فقد صُمّم Antigravity لمعالجة هذه المشكلة بالذات. تتيح لك المنصة ربط بيانات اعتماد API الخاصة بك، وتوجيه الطلبات مباشرة عبر البنية التحتية لـ Anthropic، مع الحفاظ على التحكم الكامل في الفوترة وحدود المعدل واختيار النموذج. لكن ضبط الاتصال الأولي بشكل صحيح، خاصة مع نظام إدارة بيانات الاعتماد لدى Anthropic، يُربك عددًا مفاجئًا من المستخدمين. يستعرض هذا المقال الخطوات الدقيقة، وما يجب الانتباه إليه، وما يصبح ممكنًا بعد أن تتضح الأمور.
Antigravity منصة مبنية على فكرة أن عليك أن تمتلك مجموعة أدوات الذكاء الاصطناعي الخاصة بك. فبدلًا من توجيه طلباتك عبر وسيط يرفع التكاليف أو يحجب النموذج الذي تتحدث معه فعليًا، يمرّر Antigravity بيانات اعتمادك في API مباشرة إلى المزوّد. ومع Anthropic، هذا يعني أن طلباتك تذهب مباشرة إلى خوادم Claude، وتُفوتَر على حساب Anthropic الخاص بك، وبالسعر المنشور تمامًا من Anthropic.
هذا الأمر مهم لثلاثة أسباب:
المقابل أنك تتحمل مسؤولية الإعداد. فإذا كانت بيانات اعتمادك خاطئة أو منتهية الصلاحية أو محددة النطاق بشكل غير صحيح، فلن يعمل شيء. إتقان هذا من المحاولة الأولى يوفّر ساعات من تصحيح الأخطاء.
تنقسم معظم منصات الذكاء الاصطناعي إلى فئتين: إما أن تمتلك الوصول إلى API وتفرض عليك هامشًا إضافيًا، أو تطلب منك إحضار بيانات اعتمادك الخاصة. يقع Antigravity بوضوح في الفئة الثانية.
عندما تضيف رمز Anthropic API الخاص بك إلى Antigravity، تحفظه المنصة بصيغة مشفّرة، وتحقنه كترويسة Authorization في كل طلب تبدأه. لا ترى الرمز الخام مرة أخرى بعد إدخاله، ولا يكشفه Antigravity في السجلات، وتُحتسب طلباتك على حساب Anthropic الشخصي الخاص بك كما لو كنت قد أرسلتها مباشرة.
💡 مهم: هذا يعني أيضًا أنه إذا نفد رصيد حساب Anthropic الخاص بك، ستفشل طلبات Antigravity بخطأ في المصادقة، وليس بخطأ من المنصة. تحقّق دائمًا من لوحة الفوترة في Anthropic أولًا عند تصحيح مشكلات الاتصال.
يجذب نموذج "بيانات الاعتماد الخاصة بك" نوعًا محددًا من المستخدمين: المطوّرون ومديرو المنتجات التقنيون والباحثون الذين يحتاجون إلى سير عمل ذكاء اصطناعي قابل للتكرار دون التخلي عن التحكم المالي. تشمل حالات الاستخدام الشائعة:
إذا كنت تنطبق عليك أي من هذه الأوصاف، فإن خطوات الإعداد أدناه تستحق الدقائق العشر التي تستغرقها.
يلزم توفر شيئين قبل أن تفتح لوحة بيانات الاعتماد في Antigravity: حساب Anthropic نشط مع رمز API تم إنشاؤه، وفهم لمستوى نموذج Claude الذي يمكن لحسابك الوصول إليه.
تصدر Anthropic رموز API من خلال Anthropic Console. الخطوات واضحة:
antigravity-prod أو antigravity-test💡 سمِّ رموزك حسب الغرض لا حسب التاريخ. الرمز المسمى
antigravity-prodأسهل في الإلغاء أو التدوير منtoken-june-2024عندما تحتاج لاحقًا إلى تدقيق الوصول.
يبدأ تنسيق الرمز بـ sk-ant-api03- متبوعًا بسلسلة طويلة من الأحرف والأرقام. إذا كان رمزك لا يبدأ بـ sk-ant، فقد تكون أمام تنسيق قديم لم يعد مدعومًا. أنشئ رمزًا جديدًا من Console.
تشغّل Anthropic نظام مستويات للاستخدام يؤثر على حدود المعدل والوصول إلى النماذج:
| المستوى | متطلب الإنفاق الشهري | حد المعدل (RPM) | الوصول |
|---|---|---|---|
| Free | 0 دولار (رصيد تجريبي) | 5 | نماذج محدودة |
| Tier 1 | إيداع 5 دولارات | 50 | النماذج القياسية |
| Tier 2 | إنفاق 100 دولار | 1,000 | وصول كامل إلى النماذج |
| Tier 3 | إنفاق 500 دولار | 5,000 | وصول ذو أولوية |
| Tier 4 | إنفاق 5,000 دولار | مخصص | المؤسسات |
بالنسبة لمعظم حالات الاستخدام في Antigravity، يكون Tier 1 الحد الأدنى الذي تحتاجه. فحد الطلبات الخمسة في الدقيقة في المستوى المجاني سيدفع Antigravity الطلبات إلى قائمة الانتظار أو يتسبب في فشلها في أي سير عمل حقيقي.
💡 تحقّق من مستواك قبل الإعداد. انتقل إلى Anthropic Console، ثم Billing، ثم Usage Limits. يُعرض مستواك الحالي هناك. قم بالترقية قبل الاتصال إذا كنت لا تزال على المستوى المجاني.
مع جاهزية رمز API الخاص بك وتأكيد مستواك، يستغرق الاتصال الفعلي في Antigravity أقل من خمس دقائق. تختلف واجهة الاستخدام الدقيقة بحسب إصدار Antigravity، لكن التدفق الأساسي ثابت.
يُجري Antigravity عادةً استدعاء تحقق خفيفًا إلى نقطة نهاية /v1/models لدى Anthropic للتأكد من صلاحية الرمز. إذا قُبل، سترى مؤشر حالة أخضر. وإذا لم يُقبل، ستحدد رسالة الخطأ المشكلة.
💡 لا تُضف أحرفًا زائدة. الرموز المنسوخة من ملفات PDF أو رسائل البريد الإلكتروني تلتقط أحيانًا رموز تنسيق غير مرئية. الصقها في محرر نصوص عادي أولًا، وتحقّق من التنسيق، ثم انسخها مرة أخرى قبل لصقها في Antigravity.
بعد الضوء الأخضر، نفّذ طلب اختبار واحدًا قبل بناء أي شيء فوق الاتصال:
هذه الخطوة الأخيرة مهمة. فالرد الناجح في واجهة Antigravity لا يعني دائمًا أن الطلب وُجّه عبر رمزك. أما التأكد من تسجيل الاستخدام في Anthropic Console فيستبعد أي مشكلات في التخزين المؤقت أو التوجيه.
يفاجئ الطلب الحقيقي الأول كثيرين ممن جاؤوا من بيئة بيانات اعتماد مشتركة. مع رمزك الخاص:
بعد الاتصال، تصبح لديك إمكانية الوصول إلى كل نموذج Claude يسمح به مستواك في Anthropic. هنا يُثمر الإعداد: لم تعد محصورًا في النموذج الذي تُرخّصه المنصة.
تنظّم Anthropic نماذج Claude في ثلاثة مستويات من القدرات. يخدم كل منها توازنًا مختلفًا بين السرعة والجودة:
| النموذج | السرعة | التكلفة | الأفضل لـ |
|---|---|---|---|
| Claude Opus 4.7 | بطيء | مرتفعة | الاستدلال المعقد، المستندات الطويلة |
| Claude Opus 4.6 | بطيء | مرتفعة | التحليل متعدد الخطوات |
| Claude 4.5 Sonnet | متوسط | متوسطة | البرمجة، المخرجات المنظمة |
| Claude 4 Sonnet | متوسط | متوسطة | الكتابة العامة، الأسئلة والأجوبة |
| Claude 3.7 Sonnet | متوسط | أقل | المهام اليومية المتوازنة |
| Claude 4.5 Haiku | سريع | منخفضة | التصنيف، الاستخلاص |
| Claude 3.5 Haiku | سريع | منخفضة | المهام البسيطة عالية الحجم |
| Claude 3.5 Sonnet | متوسط | أقل | صياغة المحتوى |
يتيح لك Antigravity التبديل بين هذه النماذج من قائمة اختيار النموذج. ويُحفظ الاختيار لكل سير عمل، لذا يمكنك أن تشغّل خط أنابيب واحد Opus لتحليل المستندات وآخر Haiku للتصنيف الدفعي، وكلاهما تحت رمز API نفسه.
يطرح هذا السؤال باستمرار، والجواب دائمًا: ابدأ باستخدام Sonnet.
يحقق Claude 4.5 Sonnet نسبة جودة إلى تكلفة تناسب معظم مهام الإنتاج. استخدم Claude Opus 4.7 عندما تتطلب المهمة استدلالًا عميقًا فعلًا، لا عندما تريد النتيجة "الأفضل" فقط. واستخدم Claude 4.5 Haiku عندما تشغّل مئات أو آلاف الطلبات ولا تحتاج المخرجات الفردية إلى صقل.
💡 قاعدة عملية: إذا كنت تنفق أكثر من 5 دولارات يوميًا على سير عمل واحد في Antigravity يستخدم Opus، فراجع ما إذا كان Sonnet سينتج نتائج مقبولة بجزء من التكلفة. في معظم الأحيان، سينتج.
من أكبر المفاجآت للمطوّرين الجدد على منصات BYOK أن الفوترة وحدود المعدل تعملان بشكل مختلف عمّا هو متوقع.
تفرض Anthropic رسومًا لكل توكن: تُسعَّر توكنات الإدخال وتوكنات الإخراج بشكل منفصل، وتختلف الأسعار حسب النموذج. اعتبارًا من منتصف عام 2025، تبدو الأسعار التقريبية كالتالي (راجع صفحة أسعار Anthropic للأرقام الحالية):
تتراكم هذه التكاليف في حساب Anthropic الخاص بك، لا في نظام الفوترة لدى Antigravity. لا يضيف Antigravity أي هامش فوق أسعار Anthropic؛ فأنت تدفع مباشرةً إلى Anthropic.
يعرض Antigravity استخدام التوكنات في لوحة سير العمل. يُظهر كل طلب مكتمل:
هذا يجعل من العملي تدقيق سير العمل المكلف قبل أن يرفع فاتورة Anthropic الخاصة بك. يستخدم حقل التكلفة المقدّرة أسعار Anthropic المنشورة، لذا ينبغي أن يطابق الرقم الذي تراه فاتورة استخدام Anthropic في نهاية الشهر.
💡 اضبط تنبيه ميزانية في Anthropic Console. ضمن Billing، يمكنك ضبط تنبيهات عند حدود دولارية محددة: 25 دولارًا، أو 100 دولار، أو أي مبلغ يناسبك. لن يوقفك Antigravity تلقائيًا عن تجاوز حدك؛ فنظام التنبيهات لدى Anthropic هو الضمانة.
حتى رمز API المُدخل بشكل صحيح قد يسبب مشكلات. هذه أكثر أنماط الفشل شيوعًا وكيفية حلّها.
الخطأ: 401 Unauthorized أو Invalid API Key
هذا يعني دائمًا تقريبًا واحدًا من ثلاثة أمور:
الحل: انتقل إلى إعدادات Antigravity، واحذف الرمز المحفوظ، وأعد إدخاله يدويًا من Anthropic Console. لا تنسخه من سجل الحافظة إذا كان مخزنًا هناك منذ أكثر من بضعة أيام.
الخطأ: 403 Forbidden أو Rate limit exceeded
يعني الخطأ 403 أن رمزك لا يملك صلاحية الوصول إلى النموذج الذي اخترته. يحدث هذا عادةً عندما تكون على المستوى المجاني وتحاول الوصول إلى نموذج يتطلب Tier 1 أو أعلى.
يعني خطأ حد المعدل (429) أنك بلغت حد الطلبات في الدقيقة. والحل إما ترقية مستواك لدى Anthropic، أو إضافة فواصل زمنية بين الطلبات في إعدادات سير العمل في Antigravity.
| رمز الخطأ | المعنى | الحل |
|---|---|---|
| 401 | الرمز غير صالح أو مفقود | أعد إدخال الرمز |
| 403 | المستوى غير كافٍ | رقّ حساب Anthropic |
| 429 | بلوغ حد المعدل | أضف فواصل زمنية أو رقّ المستوى |
| 529 | Anthropic مثقلة بالطلبات | انتظر وأعد المحاولة |
| 500 | خطأ في الخادم | أعد المحاولة؛ أبلغ إن استمر |
إذا نجحت طلبات Antigravity لكنها تستغرق 30 ثانية أو أكثر، فغالبًا ما تكون المشكلة في طول الأمر النصي، لا في الاتصال. تعالج Anthropic التوكنات بشكل خطي، ونافذة سياق من 10,000 توكن تستغرق وقتًا حقيقيًا حتى على النماذج السريعة.
حلول زمن الاستجابة المرتفع:
وضع الرمز في مكانه ليس سوى البداية. ما يتيحه Antigravity فعليًا أكثر إثارة من عملية الاتصال نفسها.
مع تفعيل رمز API الخاص بك، يمكن لمنصة Antigravity تشغيل سير عمل مجدول يستدعي Claude على فترات منتظمة. تشمل الإعدادات الآلية الشائعة:
يعمل كل سير من هذه الأنواع تحت رمز API الخاص بك، وتتدفق تكاليفه إلى حساب Anthropic الخاص بك. وتظهر تكلفة التوكنات لكل سير عمل في لوحة Antigravity.
إلى جانب الأتمتة، يدعم Antigravity بناء أدوات داخلية تستخدم Claude كطبقة استدلال. استخدم فرق المنتجات ذلك لبناء:
الميزة الرئيسية هنا أن هذه الأدوات لا تتطلب منك بناء طبقة تكامل API بنفسك. يتولى Antigravity توجيه الطلبات؛ أنت فقط تحدد سير العمل والنموذج.
💡 احرص على إبقاء البيانات الحساسة خارج الأوامر النصية. حتى مع رمز API الخاص بك، تخضع الأوامر النصية المرسلة عبر Anthropic لسياسات Anthropic في معالجة البيانات. راجع هذه السياسات قبل توجيه PII أو البيانات المالية أو المعلومات الخاصة عبر API.
بمجرد أن يعمل سير عمل واحد بسلاسة، يواجه معظم الفرق سؤال كيفية التوسع دون فقدان الرؤية على التكاليف.
النهج الأنظف هو رمز Anthropic API منفصل لكل بيئة:
antigravity-development مع حد إنفاق مضبوط في Anthropic Consoleantigravity-production مع المراقبة والتنبيهات مضبوطةantigravity-testing يُدوَّر شهريًاهذا يتيح لك تتبع التكاليف لكل بيئة، وإلغاء رمز دون التأثير على الرموز الأخرى، وتدقيق الاستخدام بشكل منفصل. في Antigravity، تضيف كل رمز إلى مساحة العمل أو المشروع المعني.
تعرض Anthropic Console الاستخدام مقسّمًا حسب التوكن وحسب النموذج. قارن هذا أسبوعيًا مع لوحة سير العمل في Antigravity لاكتشاف الحالات التي يعمل فيها سير عمل أكثر من المتوقع، أو يختار نموذجًا أغلى من المقصود.
فحص أسبوعي بسيط:
تعني الارتفاعات غير المتوقعة عادةً أن حلقة في سير العمل تكررت أكثر مما خُطط له، أو أن نافذة السياق نمت أكبر من المعتاد. وكلاهما سهل الإصلاح بمجرد رصده.
💡 اضبط
max_tokensفي كل طلب Anthropic. يعرض Antigravity هذا كمعامل يمكنك ضبطه لكل سير عمل. ويمنع تحديد طول المخرجات التكاليف المتزايدة من مهام التوليد المفتوحة التي تُنتج أحيانًا ردودًا طويلة جدًا.
إذا أنجزت ربط API وأردت أن ترى ما يمكن للذكاء الاصطناعي إنتاجه بما يتجاوز النص، فتستحق أدوات توليد الصور في PicassoIA بضع دقائق من التجربة. تمنحك المنصة الوصول إلى أكثر من 90 نموذجًا لتحويل النص إلى صورة، من مولّدات الصور الواقعية كالصور الفوتوغرافية إلى الأساليب الفنية، كل ذلك دون الحاجة إلى ربط بيانات اعتماد أو إدارة الفوترة بنفسك. ابدأ بأمر نصي بسيط، وكرّر التجربة من هناك. إنها أسرع طريقة لترى ما تستطيع هذه النماذج فعلًا عندما لا تضطر إلى التعامل مع لوحات الإعداد.
اختر لغتك
