دليل البدء السريع لبوابة OpenAI

ثبّت حزمة OpenAI القياسية

ابدأ بإضافة مكتبة العميل الرسمية إلى بيئة مشروعك. يضمن ذلك التوافق مع نقاط النهاية القياسية التي نعرضها. تتعامل مكتبة SDK مع التسلسل ورؤوس المصادقة تلقائياً، مما يقلل من الشيفرة المكررة في تنفيذك.

• Python: pip install openai
• Node.js: npm install openai

تحقق من اكتمال التثبيت بدون تعارضات في الاعتماديات. يتوقع البوابة الخاصة بنا حمولات JSON قياسية، لذا فإن أي إصدار من SDK يدعم /v1/chat/completions النقطة النهائية ستعمل بشكل صحيح.

قم بتكوين base_url ومفتاح API الخاص بك

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

ستستهدف طلباتك الآن https://api.gatewayopenai.com/v1 بدلاً من المزود القياسي. يضمن هذا التغيير وصولك إلى النموذج غير الخاضع للرقابة المخصص دون تعديل منطقك الأساسي.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.gatewayopenai.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

المصادقة تعتمد على رأس واحد. تأكد من أن مفتاحك نشط وغير منتهي الصلاحية. تتحقق البوابة من هذا الرمز قبل معالجة أي رموز.

أرسل أول طلب إكمال للدردشة

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

أرسل كائن رسالة قياسي. ستحتوي الاستجابة على نص مُولّد دون الرفضات المعتمنة للمحتوى. تحقق من choices مصفوفة للمحتوى المُولّد.

Copycurl https://api.gatewayopenai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List 5 Linux commands for disk usage"}]
  }'

راجع وقت الاستجابة واستهلاك الرموز. establishes هذا الطلب الأساسي الثقة في الاتصال قبل التوسع إلى طلبات أكثر تعقيداً.

فعّل البث واطلب تحليل بيانات الاستخدام

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

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

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

تعامل مع الاستجابات الجزئية بسلاسة. تأكد من أن العميل يغلق الاتصال بشكل نظيف بعد وصول القطعة الأخيرة لتجنب تسرب الموارد.

استخدم الأدوات ووضع JSON والمعاملات

استفد من استدعاء الوظائف وإخراج JSON الصارم لتوليد البيانات الهيكلية. تمكين response_format مع json_object لفرض استجابات JSON صالحة من النموذج. هذا ضروري للتكاملات البرمجية.

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.gatewayopenai.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

جرّب تعريفات الأدوات بأمثلة بسيطة. تحقق من أن النموذج يلتزم بالمخطط المقدم في طلبك. يضمن ذلك الموثوقية في سير العمل الآلي.

حدود، أخطاء، ونافذة السياق

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

التعامل مع أخطاء المصادقة (401) ونقص الرصيد (402) على الفور. يشير رمز 401 إلى مفتاح API غير صالح أو منتهي الصلاحية. يعني 402 استنفاد رصيدك المدفوع مسبقاً؛ قم بشحن الرصيد عبر العملات المشفرة لاستئناف الخدمة. حد حجم جسم الطلب هو 8 ميجابايت.

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