البدء السريع: قم بدمج نقطة النهاية المتوافقة مع OpenAI

المتطلبات الأساسية: عنوان URL الأساسي والمصادقة

ابدأ بإنشاء مفتاح على صفحة "الحصول على مفتاح API". سجّل الدخول باستخدام Google أو بريدك الإلكتروني وكلمة المرور للحصول على بيانات الاعتماد الخاصة بك فوراً. لا يلزم رقم هاتف.

قم بتعيين عنوان URL الأساسي إلى HTTPS://api.apicost.cc/v1. استخدم المفتاح المولد كرمز Bearer في رأس المصادقة. هذا يعمل مع أي عميل SDK قياسي لـ OpenAI.

تحتاج فقط إلى مفتاح نشط واحد لكل حساب. يحل المفتاح الجديد محل المفتاح القديم. لا تُستخدم مطالباتك في التدريب.

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

أرسل طلب POST إلى /v1/chat/completions مع تعيين النموذج إلى uncensored. أرسل رسالة المستخدم في مصفوفة messages. تُرجع الواجهة النصية استجابة نصية.

يحتسب كل طلب ضمن استخدامك من الرموز. تكلف رموز المدخلات 0.15 دولار لكل مليون. تكلف رموز المخرجات 0.50 دولار لكل مليون. الأخطاء والرفض مجانية.

تأكد من أن جسم الطلب لا يتجاوز 8 ميجابايت. الحد الأقصى للمخرجات هو 16,000 رمز مميز لكل طلب.

Copycurl https://api.apicost.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current price per million tokens?"}]
  }'

استجابات متدفقة لتحديثات واجهة المستخدم في الوقت الفعلي

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

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

يعمل البث مع جميع المعلمات القياسية. يمكنك إلغاء الطلب مبكرًا إذا لزم الأمر. يتوقف الخادم عن المعالجة على الفور.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apicost.cc/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)

ضبط الإبداع: درجة الحرارة، وtop_p، والبذرة

عدّل درجة الحرارة للتحكم في العشوائية. تجعل القيم الأقل الاستجابات أكثر حتمية. تزيد القيم الأعلى من الإبداع.

عيّن top_p لتقييد نطاق أخذ العينات النواة. استخدم seed لإنتاج مخرجات محددة للتصحيح. تعمل هذه المعاملات تمامًا مثل واجهة OpenAI.

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apicost.cc/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 مضبوطًا على json_object لمخرجات JSON صارمة. سيعيد النموذج JSON صالحًا بدون تنسيق علامة التبويب (markdown). هذا مفيد لتحليل البيانات في تطبيقك.

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

تتبع كلتا الميزتين المخطط القياسي لـ OpenAI. يمكنك تعريف أدوات متعددة في طلب واحد. يتعامل النموذج مع التوجيه تلقائيًا.

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)

فهم نوافذ السياق وحدود الرموز

نافذة السياق هي 100,000 رمز. هذا يشمل رموز الإدخال والإخراج معاً. يمكنك إرسال وثائق طويلة دون فقدان السياق.

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

عالج الأخطاء بسلاسة في كودك. يعني خطأ 401 أن مفتاحك غير صالح. يعني خطأ 402 أنه لا يوجد لديك رصيد. قم بالإيداع بالعملات المشفرة للمتابعة.