المصادقة وتكوين عنوان URL الأساسي
يمنحك مفتاح API الخاص بك وصولاً فورياً إلى نقطة نهاية إكمال الدردشة. أنشئ مفتاحاً عبر Google أو البريد الإلكتروني على لوحة التحكم والصقه في متغيرات البيئة الخاصة بك. عنوان URL الأساسي هو https://api.cheapaiapikeys.com/v1 الذي يعمل مع أي عميل SDK قياسي لـ OpenAI.
- تعيين
OPENAI_API_KEYلسلسلة النص المُولّدة الخاصة بك. - تجاوز
base_urlلإشارة إلى الخادم المستضاف لدينا. - تحقق من الاتصال عن طريق استدعاء
GET /v1/modelsلعرض النماذج المتاحة.
curl https://api.cheapaiapikeys.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List three common regex patterns for validating email addresses"}]
}'
أرسل طلب إكمال المحادثة الأول
أرسل مدخلات نصية واحصل على نص مولد باستخدام هيكل إكمال الدردشة القياسي. يعالج نموذجنا غير المقيد الوحيد الطلبات بدون رفض المواضيع القانونية للبالغين أو المثيرة للجدل. يمكنك ضبط معلمات مثل temperature و top_p للتحكم في العشوائية.
from openai import OpenAI
client = OpenAI(base_url="https://api.cheapaiapikeys.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)
تمكين التدفق والتعامل مع أحداث SSE
تمكين تسليم الرموز في الوقت الفعلي عن طريق ضبط stream: true في طلبك. يعيد الخادم أحداث خادم المراسلة (SSE) التي يجب عليك تحليلها تدريجيًا. تظهر تفاصيل استخدام الرموز في الجزء الأخير من التدفق. يقلل هذا الأسلوب من زمن الاستجابة المُدرَك للردود الطويلة.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.cheapaiapikeys.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);
استخدم استدعاء الوظائف ووضع JSON
عرّف الأدوات في حمولة طلبك لتمكين الإخراج المهيكل أو تنفيذ الوظائف الخارجية. استخدم response_format: {type: "json_object"} لإجبار الامتثال الصارم لـ JSON. يدعم النموذج tool_choice للتحكم الدقيق في الوظائف التي يستدعيها. هذا يضمن تحليل موثوق لمنطق تطبيقك.
فهم حدود الرموز وتسعيرها
الأسعار شفافة بسعر 0.15 دولار لكل مليون رمز إدخال و0.50 دولار لكل مليون رمز إخراج. الأخطاء والرفض لا يستهلكان الرصيد. نافذة السياق تدعم 100,000 رمز إجمالي. الطلبات التي تتجاوز الحد تُرجع خطأ حد المعدل 429. تأكد من أن حمولاتك أقل من 8 ميجابايت لتجنب أخطاء الجسم.
التعامل مع الأخطاء والحالات الحدية
تشمل الأخطاء الشائعة 401 للمفاتيح غير الصالحة و402 لقصور الرصيد. يشير رمز 429 إلى أنك تجاوزت 300 طلب في الدقيقة. استخدم زيادة الوقت الأسية عند إعادة المحاولة بعد تجاوز حدود معدل الطلب. تحقق من error كائن في استجابة JSON للحصول على تفاصيل محددة. لا يتم إصدار استرداد، لذا راقب استخدامك عن كثب.
التدفق
stream = 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)