ما هي واجهة برمجة تطبيقات Codex؟
يشير المصطلح codex api بشكل عام إلى واجهة تُستخدم بواسطة نماذج الذكاء الاصطناعي المُدرَّبة خصيصًا على توليد الشيفرة وفهمها. انتشر هذا المفهوم في البداية بفضل OpenAI، ثم تطوّر ليصبح معيارًا أوسع حيث تقدم مزودون مختلفون نقاط نهاية متوافقة مع OpenAI. بالنسبة لوكلاء البرمجة بالذكاء الاصطناعي، يعني ذلك بنية ثابتة لـ POST /v1/chat/completions تتعامل مع تفاعلات النص الداخل والخارج.
توفر خدمتنا نموذج لغة كبير مخصص وبدون رقابة مُحسّن لسياقات البرمجة. على عكس وسائط إعادة التوجيه التي تجمع بين مزودين متعددين، فإننا ندير نموذجًا مفتوح الأوزان واحدًا على خوادم GPU الخاصة بنا. يضمن ذلك نقطة نهاية لنموذج واحد مستقرة مع نافذة سياق بحجم 100,000 رمز، وهو أمر حاسم للتعامل مع مجموعات التعليمات البرمجية الكبيرة دون فقدان السياق.
لا تدعم واجهة برمجة التطبيقات التضمينات، أو توليد الصور، أو الصوت، أو الفيديو، ولا تقدم ضبطًا دقيقًا. إنها محرك إكمال نصي مصمم للتكامل مباشرة في وكلاء البرمجة مثل Cursor أو Claude Code.
لماذا استخدام نموذج بدون رقابة؟
غالبًا ما تطبّق نماذج البرمجة القياسية فلاتر محتوى قد تتعارض مع المهام التقنية. على سبيل المثال، قد يرفض النموذج توليد شيفرة لثغرة أمنية أو يحظر تركيب لغة برمجة معينة إذا كان يشبه عملًا محميًا بحقوق النشر، حتى عندما يكون حالة الاستخدام قانونية وتقنية. يزيل النموذج بدون رقابة هذه الرفض التعسفية، مما يسمح للوكيل بالتركيز بشكل كامل على جودة الشيفرة والمنطق.
يتم ضبط نموذجنا للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين. هذا مفيد بشكل خاص لوكلاء البرمجة بالذكاء الاصطناعي التي تحتاج إلى معالجة مقتطفات شيفرة متنوعة أو وثائق أو مشاريع برمجة إبداعية دون مواجهة خطأ 403 Forbidden بسبب سياسة المحتوى.
هناك قيد محتوى واحد صارم ينطبق دائمًا: لا محتوى جنسي يتضمن قاصرين. يتم حظر الطلبات من هذا النوع. بالنسبة لجميع المواضيع القانونية للبالغين أو الخيالية أو أبحاث الأمان الأخرى، سيوفر النموذج إجابة مباشرة. يقلل هذا الاستقرار من الحاجة إلى منطق إعادة المحاولة في سير عمل الوكيل الخاص بك، مما يوفر الرموز والوقت.
تكوين محرر Cursor IDE
محرر Cursor IDE هو محرر كود مدعوم بالذكاء الاصطناعي يعتمد على نقاط نهاية LLM الخارجية. لاستخدام واجهة برمجة التطبيقات الخاصة بنا بدون رقابة كوكيل برمجة أساسي، تحتاج إلى تحديث عنوان URL الأساسي في الإعدادات.
انتقل إلى إعدادات Cursor وابحث عن قسم تكوين API. غيّر عنوان URL الأساسي إلى https://api.getcodexapi.com/v1. أدخل مفتاح API الخاص بك من صفحة Get API key. معرف النموذج الذي يجب عليك تحديده هو uncensored.
يضمن هذا التكوين معالجة جميع اقتراحات التعليمات البرمجية والتعديلات بواسطة النموذج المخصص لدينا. نظرًا لأن Cursor يستخدم التنسيق المتوافق مع OpenAI، فلا حاجة إلى وسيط إضافي. تتيح نافذة السياق بحجم 100,000 رمز للمحرر الحفاظ على السياق عبر الملفات الكبيرة أو مهام إعادة هيكلة الملفات المتعددة، وهو ما يمثل قيدًا شائعًا في النماذج ذات السياق الأصغر.
المفاضلة: لن يكون لديك وصول إلى النماذج الخاصة مثل GPT-4 أو Claude ما لم تقم بتغيير التكوينات يدويًا. ومع ذلك، بالنسبة لتوليف الكوediting وتحريره فقط، غالبًا ما يوفر نقطة النهاية غير الخاضعة للرقابة نتائج أسرع وأكثر اتساقًا دون انقطاعات في السياسة.
ربط Claude Code
يُعد Claude Code وكيل سطر أوامر طورته Anthropic. بينما يستخدم عادةً واجهة Anthropic API، يمكن تكوينه لاستخدام أي نقطة نهاية متوافقة مع OpenAI إذا كان العميل يدعم ذلك. يجعل هذا واجهتنا API بديلاً قابلاً للتطبيق للمستخدمين الذين يفضلون سلوك النموذج بدون رقابة لدينا ولكنهم يفضلون واجهة Claude Code.
للتوصيل، تحتاج إلى التأكد من أن عميلك يدعم عناوين URL الأساسية المخصصة. حدّث التكوين ليشير إلى https://api.getcodexapi.com/v1 واضبط النموذج على uncensored. ستحتاج أيضًا إلى توفير مفتاح API الخاص بك.
هذا الإعداد مفيد للمطورين الذين يريدون قدرات استدعاء الأدوات القوية لوكيل برمجة ولكنهم يحتاجون إلى نموذج لا يرفض أنماط الرموز المعقدة أو غير المعتادة. لاحظ أنه على الرغم من بقاء الواجهة نفسها، فإن سلوك النموذج الأساسي سيختلف عن نماذج Claude القياسية. اختبر سير عملك المحدد دائمًا للتأكد من أن النموذج بدون رقابة يلبي معايير جودة الرمز الخاصة بك.
استخدام واجهة برمجة التطبيقات SDK من OpenAI
واجهة برمجة التطبيقات SDK من OpenAI لـ Python أو Node.js مصممة للعمل مع أي نقطة نهاية متوافقة مع OpenAI. يمكنك تبديل واجهة برمجة التطبيقات الخاصة بنا عن طريق تغيير عنوان URL الأساسي ومفتاح API.
إليك كيفية تهيئة العميل في Python:
from openai import OpenAI
client = OpenAI(
base_url="https://api.getcodexapi.com/v1",
api_key="your-api-key"
)
ثم، يمكنك استدعاء نقطة نهاية إكمال الدردشة كالمعتاد:
response = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a Python function to sort a list."}]
)
تتيح لك هذه البساطة استبدال النموذج الأساسي دون إعادة كتابة منطق الوكيل الأساسي. تتعامل واجهة برمجة التطبيقات مع التسلسل و تحليل الاستجابة، لذا يمكنك التركيز على منطق التطبيق.
الاستجابات المتدفقة للحصول على ملاحظات في الوقت الفعلي
بالنسبة لوكلاء البرمجة الذين يقدمون اقتراحات رموز في الوقت الفعلي، يعد البث ضروريًا. تدعم واجهة برمجة التطبيقات الخاصة بنا أحداث المخدم المرسلة (SSE) للاستجابات المتدفقة. يتيح هذا للوكيل عرض الرمز أثناء توليفه، مما يحسن تجربة المستخدم.
- قم بتعيين
stream=Trueفي طلب واجهة برمجة التطبيقات الخاص بك. - اقرأ كتلة البث المتدفق قطعة تلو الأخرى.
- قم بتحديث واجهة المستخدم أو المحرر مع كل قطعة.
يقلل هذا من زمن الاستجابة المُدرَك، خاصة لكتل الشيفرة الكبيرة. نظرًا لأن نموذجنا يحتوي على نافذة سياق بحجم 100,000 رمز، يمكنك بث الاستجابات التي تتضمن كميات كبيرة من السياق دون القلق بشأن التقطيع.
ملاحظة: لا يغير البث المتدفق التسعير أو عدّ الرموز. تُحسب تكلفة الرموز بناءً على إجمالي المدخلات والمخرجات، سواء تم إرسال الاستجابة عبر البث المتدفق أو إرجاعها في كتلة واحدة.
التعامل مع استدعاء الدوال
غالبًا ما يستخدم وكلاء البرمجة استدعاء الدوال للتفاعل مع الأدوات الخارجية، مثل تشغيل أمر طرفي أو قراءة ملف. تدعم واجهتنا API هذه الميزة، مما يتيح لك تعريف مخططات الدوال في طلبك.
- عرّف دوالك في المعلمة
functions. - سيعيد النموذج استجابةً تحتوي على كائن
function_call. - ينفذ الوكيل الدالة ويرسل النتيجة مرة أخرى إلى النموذج.
- يولّد النموذج الاستجابة التالية بناءً على النتيجة.
هذا التفاعل متعدد الأدوار أمر بالغ الأهمية للمهام المعقدة. على سبيل المثال، قد يحتاج الوكيل إلى قراءة ملف وتحليله ثم توليد إصلاح. تتعامل واجهتنا API مع هذا بسلاسة، مع الحفاظ على السياق عبر أدوار متعددة ضمن حد 100,000 رمز.
إدارة حدود المعدل
لضمان الاستخدام العادل والاستقرار، تفرض واجهة برمجة التطبيقات (API) حداً قدره 300 طلب في الدقيقة لكل مفتاح. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. إذا تجاوزت هذه الحدود، ستتلقى خطأ 429 Too Many Requests.
أفضل الممارسات:
- نفذ آلية التراجع الأسي في منطق إعادة المحاولة الخاص بالوكيل.
- استخدم البث المتدفق لتقليل عدد طلبات واجهة برمجة التطبيقات (API) للاستجابات الكبيرة.
- راقب استخدامك عبر لوحة التحكم لتجنب الرسوم غير المتوقعة.
إذا كنت بحاجة إلى تدوير المفاتيح، يمكنك إعادة إنشاء مفتاح API الخاص بك في أي وقت. يؤدي هذا إلى إلغاء صلاحية المفتاح القديم، لذا تأكد من تحديث وكلائك قبل إعادة الإنشاء.
