واجهة API بنمط OpenAI مع cURL ورمز المصادقة
للاستدعاء من سطر الأوامر، أرسل طلب HTTP POST مع رأس Authorization يحمل الرمز. توفر هذه الصفحة أوامر cURL العاملة لكل ميزات واجهة API، والخطوات للتحقق عند الفشل.
تم التحديث

نقاط رئيسية
- يوضع الرمز في رأس Authorization: Bearer YOUR_KEY، ومعرف النموذج هو uncensored.
- توجد نقطتا النهاية: GET /v1/models و POST /v1/chat/completions.
- أضف -N و stream true لرؤية وصول الرموز عبر أحداث SSE.
- اقرأ رؤوس X-Balance-USD وحدّ المعدل باستخدام curl -i؛ يعني 429 الانتظار ثم إعادة المحاولة.
الطلب الأدنى
إليك أقصر طريقة لإجراء open ai api curl with token ضد هذه الخدمة. ضع المفتاح في متغير بيئة حتى لا يظهر في سجل الأوامر، ثم أرسل رسالة دردشة:
export UF_KEY="paste-your-key-here"
curl https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what a bearer token is in two sentences."}
]
}'
الاستجابة بصيغة JSON بنمط إكمال الدردشة. يجلس الجواب عند choices[0].message.content، ويعتبر كائن usage عدد رموز الموجّه والإكمال. لكل جزء من الأمر وظيفة:
- يحمل
Authorization: Bearer ...الرمز. "Bearer" هو اسم المخطط؛ من يحمل الرمز يُعامل كمالك له، ولهذا تحتفظ به بعيدًا عن المستودعات العامة. - يُخبر
Content-Type: application/jsonالخادم كيفية قراءة الجسم. بدونه، غالباً ما يفشل الطلب بخطأ في تحليل الجسم. - يجب أن يكون
modelهوuncensored، وهو النموذج الوحيد الذي تقدمه هذه الـ API. - يُعد
messagesقائمةً من الكائنات التي تحتوي علىrole(system، user، assistant أو tool) وcontent.
للحصول على مفتاح، سجّل حسابك باستخدام Google أو البريد الإلكتروني وكلمة المرور، ثم استخدم صفحة مفتاح API. يمكن للمستخدمين الجدد الحصول على $0.50 من رصيد تجريبي مجاني بنقرة واحدة هناك: بدون بطاقة، صالح لمدة 7 أيام، لكل شخص.
تحقق من المفتاح باستخدام GET /v1/models
قبل تصحيح طلب طويل، تأكد من أن الرمز يعمل مع أرخص استدعاء متاح. سرد النماذج لا يكلف شيئاً ويظهر ما إذا كانت URL، الرأس، والمفتاح كلها صحيحة.
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY"
الإجابة الجيدة هي قائمة JSON تتضمن uncensored. إذا كان لديك jq مثبتاً، قم بتوجيه المخرجات لاستخراج المعرفات فقط:
curl -s https://api.unfilteredaimodels.com/v1/models \
-H "Authorization: Bearer $UF_KEY" | jq -r '.data[].id'
إذا لم يتم إرجاع أي شيء مفيد، انتقل عبر القائمة أدناه بالترتيب، لأن الأسباب مذكورة حسب تكرار حدوثها:
- المتغير فارغ. قم بتشغيل
echo "${UF_KEY:0:6}"لرؤية الأحرف الأولى دون طباعة المفتاح كاملاً. - تم تهجئة الرأس بشكل خاطئ، أو كلمة "Bearer" مفقودة قبل المفتاح.
- استبدلت علامات الاقتباس المنحنية (المستخدمة في المستندات أو عملاء الدردشة) علامات الاقتباس المستقيمة في الأمر.
- URL الأساسي غير صحيح. هو
https://api.unfilteredaimodels.com/v1، مع وجودapi.في البداية و/v1في النهاية. - تم نسخ المفتاح مع مسافة أو سطر جديد في نهايته.
اقرأ رؤوس الاستجابة
أضف -i لتشمل الرؤوس في المخرجات، أو -D - لطباعتها مع الحفاظ على الجسم نظيفاً:
curl -s -D - -o /dev/null \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"ping"}]}'
هناك أربعة رؤوس استجابة تستحق المعرفة:
| رأس الطلب | المعنى |
|---|---|
X-Request-Id | معرف لهذا الطلب. اذكره عند التواصل مع الدعم. |
X-Balance-USD | رصيدك المسبق الدفع المتبقي. |
X-RateLimit-Limit-Requests | عدد الطلبات المسموح بها في الدقيقة لمفتاحك. |
X-RateLimit-Limit-Concurrency | عدد الطلبات المتزامنة المسموح بها لمفتاحك. |
الحدود هي 300 طلب في الدقيقة و8 طلبات متزامنة للمفتاح الكامل، و60 طلب في الدقيقة و2 طلب متزامن لمفتاح التجربة. يحدد الطلب أعلاه max_tokens إلى 5 فقط لإبقاء الاختبار صغيراً. في الاستخدام العادي، يكون max_tokens اختيارياً، ويمكن أن يستخدم الإكمال أي شيء متبقي من نافذة الـ 100,000 رمز بعد موجّهك.
البث من سطر الأوامر
اضبط "stream": true وأضف -N حتى لا يقوم curl بتخزين المخرجات مؤقتاً. سترى أسطرًا تبدأ بـ data:، يحمل كل منها جزءاً صغيراً من JSON، وسطر نهائي data: [DONE]. يتضمن الجزء قبله استخدام الرموز.
curl -N https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"stream": true,
"messages": [{"role": "user", "content": "Write a four-line poem about a cron job."}]
}'
لطباعة النص فقط، قم بتصفية البث المتدفق باستخدام خط أنابيب قصير:
curl -sN https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","stream":true,"messages":[{"role":"user","content":"Count to five."}]}' \
| sed -u 's/^data: //' | grep -v '^\[DONE\]' | grep -v '^$' \
| jq -rj '.choices[0].delta.content // empty'
echo
يحتفظ الطلب المتدفق بمكانه في السعة المتزامنة حتى ينتهي البث. إذا بدأت العديد من الطلبات المتزامنة بالتوازي من نص برمجي ونسيت السماح لها بالانتهاء، فستصل إلى حد السعة المتزامنة حتى لو كان معدل الطلبات منخفضاً.
وضع JSON واستدعاء الدوال
يُعيد النموذج في وضع JSON كائن JSON صالحًا واحدًا. حدد الشكل المطلوب في الموجّه، وإلا ستكون المفاتيح حسب ما يختاره النموذج.
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "user", "content": "Return JSON with keys city and country for the capital of Portugal."}
]
}' | jq -r '.choices[0].message.content'
يستخدم استدعاء الدوال حقلي tools و tool_choice القياسيين. يجيب النموذج بمصفوفة tool_calls بدلاً من النص؛ وتشغّل الدالة بنفسك وترسل النتيجة كرسالة مع role: "tool" ومع tool_call_id المطابق.
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"tool_choice": "auto",
"tools": [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"]
}
}
}],
"messages": [{"role": "user", "content": "What is the weather in Lisbon?"}]
}'
في الرد، ابحث عن choices[0].message.tool_calls[0].function.arguments. إنه سلسلة JSON تقوم بتحليلها، واستدعاء دالة الطقس الخاصة بك بها، وإعادتها في الطلب التالي. تمرر المعلمات مثل temperature، top_p، stop، seed والعقوبات كما هي. تذكر التوثيق جميع الحقول المدعومة.
احفظ الرمز المميز آمنًا ورتّب الأوامر
رمز Bearer هو كلمة مرور باسم مختلف. يمكن لأي شخص يملكه إنفاق رصيدك، لذا تعامل معه بنفس الحذر. لا تلصق مفتاحاً حقيقياً في مشكلة عامة، لقطة شاشة، أو سجل طرفية مشترك. إذا اشتبهت في تسرب مفتاح، استبدله من صفحة المفاتيح وحدّث نصوصك البرمجية.
سجل الأوامر هو سبب التسرب الأكثر شيوعًا على الجهاز الشخصي. كتابة المفتاح مباشرة في الأمر يخزنه في ملف السجل. تعيينه مرة واحدة مع export يخزن ذلك السطر أيضًا. تساعد عادةان أنظف. اقرأ المفتاح من ملف لا يمكنك فتحه إلا أنت، أو أرفق الأمر بمسافة إذا كانت قشرة الأوامر الخاصة بك مضبوطة على تجاهل الأسطر التي تبدأ بمسافة. يعمل ملف صغير بشكل جيد:
mkdir -p ~/.config/uf
printf '%s' 'paste-your-key-here' > ~/.config/uf/key
chmod 600 ~/.config/uf/key
export UF_KEY="$(cat ~/.config/uf/key)"
تكون كائنات JSON الطويلة صعبة القراءة داخل علامات الاقتباس المفردة، وتنكسر الاقتباسات بمجرد أن يحتوي الموجّه نفسه على علامة اقتباس. ضع الجسم في ملف واسمح لـ curl بقراءته مع -d @file:
cat > request.json <<'JSON'
{
"model": "uncensored",
"temperature": 0.3,
"messages": [
{"role": "system", "content": "You answer in plain language."},
{"role": "user", "content": "What's the difference between a 401 and a 403 status code?"}
]
}
JSON
curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d @request.json | jq -r '.choices[0].message.content'
يُبقي هذا النهج الطلبات الكبيرة ضمن حد حجم الجسم 8 MB قابلة للإدارة، ويمكن إصدار ملف في git بينما يبقى المفتاح خارج المستودع. في PowerShell على Windows، تتصرف الاقتباسات المفردة حول JSON بشكل مختلف ولا يوجد استمرار السطر بالرمز الخلفي؛ صيغة -d @request.json تتجنب كلتا المشكلتين، ويمكنك استخدام علامة backtick في نهاية السطر لاستمرار الأمر.
عندما تنتهي من الاختبار، انتقل إلى SDK. تقبل مكتبات Python و Node.js من OpenAI نفس URL الأساسي والمفتاح، وتتولى إعادة المحاولة والبث المتدفق لك، وتقرأ نفس تنسيق الرد الذي كنت تقوم بتحليله يدويًا هنا. تظل أوامر cURL أسرع طريقة للتحقق مما إذا كان الفشل ناتجًا عن كودك أو عن الطلب نفسه، لذا احتفظ بأمر موثوق في ملاحظاتك. عند الإبلاغ عن مشكلة إلى الدعم، أدرج X-Request-Id للاتصال الفاشل ورمز الحالة الدقيق؛ يسمح هذا الزوج لشخص ما بإيجاد الطلب دون طلبك لتكرار الاختبار، ويوفر جولة من تبادل الرسائل.
الأخطاء، إعادة المحاولة، والتكلفة لكل طلب
عندما تتجاوز حدًا، يجيب API بـ HTTP 429. يخبرك رمز الخطأ أي حد: يعني rate_limited طلبات كثيرة جدًا في الدقيقة، يعني concurrency طلبات كثيرة جدًا في وقت واحد. يؤدي الحمل الزائد المؤقت أيضًا إلى إرجاع 429 ويضيف Retry-After: 5. يمكن لـ curl إعادة المحاولة تلقائيًا للأخطاء العابرة:
curl --retry 3 --retry-delay 5 --retry-all-errors \
https://api.unfilteredaimodels.com/v1/chat/completions \
-H "Authorization: Bearer $UF_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'
أيضاً، حافظ على حجم الجسم أقل من 8 MB، وهو مهم إذا قمت بنشر ملفات مشفرة (مُرمَّزة) في الموجّه.
الطلبات الفاشلة أو المرفوضة لا تُحسب. تنفذ الناجحة صيغة بسيطة: $0.15 لكل مليون رمز إدخال و $0.50 لكل مليون رمز إخراج. تكلفة طلب اختبار يحتوي على 40 رمز إدخال و 120 رمز إخراج هي 40 / 1,000,000 x $0.15 = $0.000006 زائد 120 / 1,000,000 x $0.50 = $0.00006، أي $0.000066 في المجموع. ألف منها تصل إلى $0.066.
الرصيد مسبق الدفع ولا ينتهي. عمليات شحن الرصيد تتراوح بين $20 و$500 بمبالغ صحيحة، مع مكافأة 5% من $50، و10% من $100، و15% من $200، عبر العملات المشفرة فقط (USDT على TRC20، USDC على Base). تظهر صفحة الأسعار التفاصيل. إذا بدا الرد خاطئاً، يشرح صفحة الأساطير والحقائق ما يفعله النموذج ولا يفعله.
المزيد من الأدلة
أسئلة وأجوبة
مفتاحك على بُعد نموذج تعبئة واحد
أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.
أين يذهب الرمز في أمر cURL؟
- في رأس: -H "Authorization: Bearer YOUR_KEY". يحتاج جسم الطلب أيضًا إلى رأس Content-Type: application/json.
ما اسم النموذج الذي أستخدمه؟
- استخدم uncensored. يمكنك تأكيد ذلك مع GET /v1/models.
لماذا أحصل على 429؟
- لقد تجاوزت حدًا. يعني الرمز rate_limited طلبات كثيرة جدًا في الدقيقة، يعني concurrency طلبات كثيرة جدًا في وقت واحد. انتظر بضع ثوانٍ، أو قلل عدد الطلبات المتزامنة.
كيف أرى رصيدي المتبقي؟
- كل رد يتضمن رأس X-Balance-USD. اطبع الرؤوس مع curl -i أو curl -D -.
هل هذا هو واجهة برمجة التطبيقات الرسمية من OpenAI؟
- لا. إنه خدمة مستقلة متوافقة مع OpenAI تشغل نموذجًا واحدًا مفتوح الأوزان، لذا فإن SDKs وأوامر cURL المبنية لتنسيق OpenAI تعمل بعد تغيير URL الأساسي والمفتاح.