GetAPI.ONE

إعداد Codex CLI لخدمة GetAPI.ONE

ثبّت Codex CLI من المصدر الرسمي، واحفظ مفتاح ONE في متغير بيئة، وأعدّ مزودًا مخصصًا متوافقًا مع Responses، وتحقق من الاتصال النشط.

النطاق والمتطلبات

يغطي الدليل Codex CLI في الطرفية. ولا يثبت توافق كل عميل مكتبي أو إضافة IDE أو نموذج أو ميزة Codex.

حساب GetAPI.ONE برصيد قابل للاستخدام أو باقة منطبقة.
مفتاح GetAPI.ONE مسمى ومحدود ومحفوظ بسرية.
نموذج من الدليل الحالي يدرج نقطة Responses صراحة.
إذن تثبيت Codex CLI وتعديل إعداد Codex على مستوى المستخدم.

1. تثبيت Codex CLI والتعرف عليه

استخدم صفحة Codex CLI الرسمية الحالية لاختيار المثبت المناسب لنظامك. يستخدم المثبت المستقل الرسمي لـ macOS/Linux المراجع في 2026-09-07 الأمر أدناه. على مستخدمي Windows اتباع تبويب Windows الرسمي بدل تنفيذ أمر Unix بلا تحقق.

مثبّت macOS / Linux الرسمي

curl -fsSL https://chatgpt.com/codex/install.sh | sh

تأكيد الأمر المثبت

codex --version

2. تحميل المفتاح في الطرفية

اضبط المفتاح للصدفة الحالية قبل تشغيل Codex. تتضمن الأمثلة قيمة نائبة عمدًا.

صدفة macOS / Linux

export GETAPI_ONE_API_KEY="replace-with-your-private-key"

عملية PowerShell الحالية

$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"

3. إعداد مزود ONE

افتح config.toml الخاص بمستخدم Codex، عادة داخل .codex، وأضف المزود أدناه. استبدل YOUR_RESPONSES_MODEL بنموذج GetAPI.ONE حالي يعلن نقطة Responses صراحة.

ملف config.toml على مستوى المستخدم

model_provider = "getapi_one"
model = "YOUR_RESPONSES_MODEL"

[model_providers.getapi_one]
name = "GetAPI One"
base_url = "https://www.getapi.one/v1"
env_key = "GETAPI_ONE_API_KEY"
wire_api = "responses"

4. التشغيل والتحقق

افتح طرفية جديدة إذا جعلت المتغير دائمًا؛ وإلا فاحتفظ بالطرفية التي ضُبط فيها.
افتح مجلد مشروع وشغّل codex. تحقق من أن المزود والنموذج المعروضين يطابقان إعدادك المقصود.
أرسل مطالبة واحدة بسيطة فقط إذا قبلت احتمال الفوترة.
يتطلب النجاح استجابة CLI صالحة وسجل طلب أو استخدام مطابقًا في وحدة GetAPI.ONE. لم يُستدعَ نموذج أثناء إعداد الدليل.

استكشاف الأخطاء بالترتيب

العَرَض	الفحوص
codex: command not found	راجع المثبت الرسمي لنظامك وتحقق من وجود مجلد التثبيت في PATH.
Missing API key	تحقق من وجود GETAPI_ONE_API_KEY في البيئة التي تشغّل Codex ومن كتابة env_key بدقة.
401 / Unauthorized	انسخ مفتاح ONE مجددًا وتحقق من تفعيله واقترانه بـ https://www.getapi.one/v1.
404 / مسار غير متوافق	تحقق من بقاء /v1 في base_url ومن إعلان البوابة /v1/responses.
Model not found	استبدل القيمة النائبة باسم دليل دقيق متاح لمجموعة المفتاح وموسوم لنقطة Responses.
لم يتغير الإعداد	تحقق من تعديل ملف المستخدم الذي يحمّله Codex، ومن توجيه model_provider إلى getapi_one، ومن إعادة تشغيل الطرفية أو العميل.