مفتاح API لـ Codex في VS Code: استخدام نقطة نهاية مخصصة

ما تقوم بإعداده

تتواصل مساعِدو البرمجة في VS Code مع النموذج عبر HTTP. تتحدث معظمها بتنسيق واجهة برمجة التطبيقات OpenAI، مما يعني أنها تقبل عنوان URL أساسي ومفتاحًا مخصصين بدلاً من الإعداد الافتراضي للجهة المزودة. هذه الخدمة متوافقة مع OpenAI، لذا يمكنها الاتصال بأي أداة تدعم هذا الخيار.

تأكد من هوية الخدمة في الطرف الآخر. إنها نموذج واحد مفتوح الأوزان تشغله جهة مستقلة، ومُضبط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين. إنها ليست نموذج Codex الخاص بـ OpenAI وليست واجهة برمجة التطبيقات الرسمية لأي جهة أخرى. تدعم النصوص فقط، مع نافذة سياق بحجم 100,000 رمز، ودعم استدعاء الدوال ووضع JSON. إذا كنت تريد تفاصيل المسارات بتنسيق OpenAI، اقرأ التوثيق؛ وإذا كنت تحتاج فقط إلى العنوان، انظر إلى صفحة عنوان URL الأساسي لواجهة برمجة تطبيقات Codex.

إليك القيم الثلاث التي يجب استخدامها في كل مكان:

احصل على مفتاح واختبره أولاً

أنشئ حسابًا على صفحة مفتاح API باستخدام Google أو عبر البريد الإلكتروني وكلمة المرور. يمكن للمستخدمين الجدد المطالبة برصيد تجريبى بقيمة $0.50 بنقرة واحدة، صالح لمدة 7 أيام، دون الحاجة لبطاقة. ثم اختبر المفتاح في طرفية الأوامر قبل تعديل إعدادات VS Code. يثبت استدعاء curl الناجح صحة المفتاح وعنوان URL، لذا تكون الأخطاء اللاحقة متعلقة بالإضافة.

Copy# macOS or Linux, add to ~/.zshrc or ~/.bashrc
export CODEX_API_KEY="YOUR_KEY"

# then verify the endpoint answers
curl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer $CODEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python one-liner that reverses a string."}]}'

الرد هو JSON لإكمال الدردشة، ويحمل الاستجابة رأس X-Balance-USD الذي يحتوي على رصيدك المتبقي. احفظ المفتاح في متغير بيئة أو في تخزين الأسرار الخاص بالإضافة، وليس في مستودع.

إضافة Codex وواجهة سطر الأوامر: ملف التكوين

تدعم أدوات Codex من OpenAI مزودي نماذج مخصصة عبر ملف تكوين TOML في المجلد الرئيسي، وتُوثّق إضافة VS Code بأنها تشارك هذا التكوين مع سطر الأوامر. تحقق من ذلك مقابل التوثيق الحالي لـ Codex لإصدارك، حيث تطورت الصيغة.

Copy# ~/.codex/config.toml
model = "uncensored"
model_provider = "custom"

[model_providers.custom]
name = "Custom endpoint"
base_url = "https://api.getcodexapi.com/v1"
env_key = "CODEX_API_KEY"
wire_api = "chat"

نقاط يجب التحقق منها:

• ينتهي base_url بـ /v1، بدون /chat/completions.
• env_key هو اسم متغير البيئة، وليس المفتاح نفسه.
• يحدد wire_api تنسيق الطلب. تقبل هذه الخدمة كلًا من POST /v1/chat/completions و POST /v1/responses. جرّب "chat" أولاً؛ واستخدم "responses" إذا كان إصدار Codex الخاص بك يتطلب ذلك.
• ابدأ VS Code من غلاف يحتوي على المتغير المحدد، أو أعد تشغيله بعد إضافة المتغير إلى ملفك الشخصي. قد لا ترى إطلاق واجهة المستخدم الرسومية على macOS تصدير الغلاف.

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

إضافات Continue و Cline وغيرها

لدي إضافات الجهات الخارجية شاشاتها الخاصة، لكن النمط ثابت: اختر مزودًا يدعم OpenAI أو "متوافقًا مع OpenAI"، ثم املأ عنوان URL الأساسي والمفتاح والنموذج. يستخدم Continue ملف تكوين YAML:

Copy# Continue (config.yaml), model entry
models:
  - name: Hosted uncensored
    provider: openai
    model: uncensored
    apiBase: https://api.getcodexapi.com/v1
    apiKey: YOUR_KEY

توفر Cline و Roo Code مزودًا باسم "متوافق مع OpenAI" في لوحة الإعدادات مع الحقول الثلاثة نفسها. تتغير الأسماء والقوائم غالبًا، لذا ابحث في توثيق الإضافة الخاص بها عن "متوافق مع OpenAI" أو "عنوان URL أساسي مخصص". إذا لم يكن للإضافة حقل لعنوان URL الأساسي، فلا يمكنها استخدام نقطة النهاية هذه.

نصائح توفر الوقت:

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

مهام المحرر التي تناسب هذا النموذج

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

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

التكلفة في محرر النصوص

الأسعار هي $0.15 لكل مليون رمز إدخال و$0.50 لكل مليون رمز إخراج. أدوات البرمجة ترسل الكثير من السياق، لذا راجع الإدخال أولاً.

مثال: طلب تعديل يحتوي على 8,000 رمز من سياق الملف وإجابة مكونة من 600 رمز تكلف 8,000 × $0.15 / 1M + 600 × $0.50 / 1M = $0.0012 + $0.0003 = $0.0015. يوم واحد من 150 طلباً من هذا النوع يكلف 150 × $0.0015 = $0.225. عشرون يوماً عملياً: $4.50.

الوكيل الذي يقرأ ملفات كثيرة يمكنه إرسال 40,000 رمز لكل خطوة. عند هذا الحجم، تكلفة خطوة واحدة هي $0.006 بالإضافة للإخراج، لذا تكلفة 100 خطوة هي حوالي $0.60 بالإضافة للإخراج. راقب حلقات الوكيل. الطلبات الفاشلة أو المرفوضة لا تُفرض عليها رسوم، ولا تنتهي صلاحية الرصيد. يمكن شحن الرصيد من $20 إلى $500 بالبطاقة (Visa، Mastercard، Apple Pay، Google Pay) أو بالعملات المشفرة. الخطط الحالية مدرجة في صفحة الأسعار.

استكشاف الأخطاء وإصلاحها

401 غير مصرح

المفتاح مفقود، أو يحتوي على فراغ زائد، أو أن متغير البيئة غير مرئي لـ VS Code. أعد تشغيل المحرر من محطة طرفية (terminal) تحتوي على المتغير.

خطأ 404 أو "النموذج غير موجود"

استخدم النموذج الدقيق uncensored وعنوان URL الأساسي مع /v1 في النهاية.

أخطاء 429

المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 في الدقيقة؛ بينما يسمح مفتاح التجربة بـ 2 و60. قد يصل الامتداد الذي يطلق عدة طلبات متزامنة، مثل الاكمال التلقائي بالإضافة إلى الدردشة، إلى حدّ التوازي. رمز الخطأ هو concurrency عند وجود طلبات كثيرة في آن واحد، وrate_limited لحدود الدقيقة. يعني الرأس Retry-After: 5 زيادة مؤقتة في الحمل.

توقف البث المتدفق

بعض الوكلاء المؤسسيين يقومون بتخزين الأحداث المرسلة من الخادم. اختبر من شبكة مختلفة أو أوقف البث المتدفق في الامتداد.

الإجابات تختلف عما رأيته مع مساعد آخر

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

المزيد من الأدلة

• Codex API في Python: استدعاء نموذج لغوي للبرمجة
• عنوان URL الأساسي لواجهة برمجة تطبيقات Codex: كيفية توجيه عميلك إلينا