Claude api key production checklist

لماذا التحول من مفتاح Claude API؟

توفر واجهة برمجة التطبيقات (API) الخاصة بنا بديلاً مباشراً وغير خاضع للرقابة للمطورين الذين يحتاجون إلى توليد محتوى غير مقيد دون توجيه معقد للنماذج. بينما يخدم مفتاح Claude API احتياجات المؤسسات المحددة، فإن نهجنا القائم على نموذج واحد يبسط التكامل ويقلل من العبء التشغيلي. تحصل على جودة مخرجات متسقة للمحتوى للبالغين، أو الخيالي، أو المثير للجدل دون رفض غير متوقع.

يعمل عنوان URL الأساسي HTTPS://api.gemmaapikey.com/v1 مع أي عميل متوافق مع OpenAI. هذا يعني أنك تغير فقط base_url ومفتاح API في كودك الحالي. لا حاجة إلى واجهات برمجة (SDKs) جديدة أو تدفقات مصادقة معقدة.

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

فهم تكلفة الرموز

أسعارنا بسيطة: 0.15 دولار لكل مليون رمز مدخل و0.50 دولار لكل مليون رمز مدخل. الأخطاء والرفض لا تكلف شيئاً، لذا تدفع فقط مقابل استخدام الرموز الفعلي. يضمن هذا النموذج المقيد مسبقاً بقاء التكاليف قابلة للتنبؤ دون مفاجآت الاشتراك.

تُعالج الإضافات عبر العملات المشفرة فقط. يمكنك إيداع أي مبلغ صحيح يتراوح من $20 إلى $500 باستخدام USDT (TRC20) أو USDC (Base). ينطبق رصيد المكافأة تلقائيًا: +5% من $50، و+10% من $100، و+15% من $200. لا ينتهي صلاحية الرصيد المدفوع أبدًا، لذا يمكنك الإضافة مرة واحدة واستخدامه مع مرور الوقت.

تتلقى الحسابات الجديدة رصيدًا تجريبيًا بقيمة $0.50 صالح لمدة 7 أيام. يتيح لك ذلك التحقق من التكامل قبل الالتزام بإيداع أكبر.

أساسيات التكامل

ابدأ بإرسال طلب POST إلى /v1/chat/completions. استخدم معرف النموذج "uncensored" للوصول إلى نموذجنا الوحيد مفتوح الوزن. إنه مضبوط للإجابة دون رفض المحتوى للاستخدام البالغ القانوني. النموذج ليس GPT أو Claude أو Gemini أو أي نموذج آخر من البائعين.

تدعم نافذة السياق إجمالي 100,000 رمز موزع بين النص المطلوب والإكمال. الحد الأقصى للإخراج هو 16,000 رمز لكل طلب، أو 2,048 إذا لم يتم تعيين max_tokens. تتيح هذه النافذة الكبيرة الاحتفاظ بسياق موسع في المحادثات الطويلة.

تشمل المعلمات المدعومة درجة الحرارة، top_p، stop، seed، presence_penalty، و frequency_penalty. تتيح هذه ضبط نمط الاستجابة والحتمية دون الحاجة إلى منتهيات إضافية.

استجابات البث

فعّل البث عن طريق تعيين stream إلى true في الطلب. تصل الاستجابات كأحداث إرسال من الخادم (SSE). تحتوي كل شريحة على نص جزئي، مما يتيح لتطبيقك عرض المخرجات في الوقت الفعلي.

تتضمن الشريحة النهائية تفاصيل استخدام الرموز الشاردية. يتيح لك ذلك تتبع التكاليف بدقة أثناء جلسات التدفق. لا تحتاج إلى انتظار اكتمال الاستجابة لمعرفة الاستخدام التقريبي.

يعمل البث مع جميع مكتبات SDK القياسية من OpenAI. ببساطة قم بتحديث base_url إلى HTTPS://api.gemmaapikey.com/v1. تتعامل المكتبة مع تحليل SSE تلقائيًا. يقلل هذا بشكل كبير من شيفرة الهيكل مقارنة بالتدفق اليدوي.

استدعاء الوظائف

تدعم واجهة برمجة التطبيقات (API) لدينا استدعاء الوظائف عبر معلمة tools. عرّف وظائفك في الطلب، وسيعيد النموذج مخرجات JSON مهيكلة لاستخدام الأدوات. هذا يتيح سير عمل معقد مثل استخراج البيانات أو تفعيل الإجراءات.

عيّن tool_choice إلى "auto" أو حدد وظيفة محددة. يحترم النموذج هذه القيادات ويخرج JSON صالح. استخدم response_format مضبوطًا على json_object للامتثال الصارم لـ JSON.

يعد استدعاء الوظائف مثاليًا لبناء مساعدين يتفاعلون مع الأنظمة الخارجية. يعمل بسلاسة مع النموذج غير المقيد. لا تحتاج إلى طبقة توجيه منفصلة لتمكين الأدوات. يتعامل نفس نقطة النهاية مع الدردشة واستدعاء الوظائف.

معالجة الأخطاء

تعيد الأخطاء رموز حالة HTTP القياسية. تشمل الأخطاء الشائعة 429 لحدود معدل الطلبات و400 للمعاملات غير الصالحة. تحقق من رسالة الخطأ للحصول على التفاصيل. الرفضات بسبب سياسات المحتوى نادرة ولكن ممكنة للمحتوى ذي الصلة بالأطفال.

قم بتنفيذ منطق إعادة المحاولة لأخطاء 429. يسمح حد معدل الطلب لدينا بـ 300 طلب في الدقيقة لكل مفتاح. تسمح حدود الانفجار بـ 8 طلبات متزامنة. يؤدي تجاوز هذه الحدود إلى استجابة 429. انتظر لفترة وجيزة قبل إعادة المحاولة.

الأخطاء لا تستهلك رموزاً. إذا فشل الطلب، لا يتم تحصيل الرسوم عليك. يحمي هذا رصيدك المدفوع مسبقاً من مكالمات API المهدرة. تحقق دائماً من المعلمات قبل إرسال الأحمال الكبيرة.

حدود معدل الطلبات

يتيح كل مفتاح API إجراء 300 طلب في الدقيقة. يمكنك تشغيل 8 طلبات متزامنة. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. تضمن هذه الحدود أداءً مستقراً لمعظم حالات الاستخدام.

يُسمح بمفتاح نشط واحد لكل حساب. يؤدي إنشاء مفتاح جديد إلى استبدال المفتاح القديم على الفور. استخدم هذا لتدوير المفاتيح إذا لزم الأمر. لكل مفتاح عداد خاص به لحدود معدل الاستخدام.

راقب استهلاكك عبر عدد الرموز في استجابة التدفق. يساعدك هذا في البقاء ضمن الحدود. إذا واجهت خطأ 429، قلل من معدل الطلبات أو وزع الحمل عبر مفاتيح متعددة. الحدود خاصة بكل مفتاح وليست للحساب ككل.

أفضل ممارسات الأمان

احفظ مفتاح API الخاص بك بأمان. يظهر فوراً عند التسجيل. احفظه في متغيرات البيئة، وليس في كود جانب العميل. استخدم HTTPS لجميع الطلبات. تستخدم API الخاصة بنا رؤوس مصادقة قياسية.

يتطلب أمان الحساب فقط عنوان بريد إلكتروني. سجّل الدخول عبر Google أو البريد الإلكتروني وكلمة المرور. لا حاجة لرقم الهاتف. لا تُستخدم أوامر المستخدم (Prompts) للتدريب. تبقى بياناتك خاصة.

تخضع سياسة صارمة لمحتوى معين: لا يوجد محتوى جنسي يتضمن قاصرين. يتم رفض الطلبات التي تحتوي على هذا المحتوى. هذا هو الفلتر الصارم الوحيد. يُسمح بجميع أشكال البالغين القانونية الأخرى. تحقق من إصدار مكتبة العميل للحصول على رؤوس الأمان المثلى.