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

المتطلبات الأساسية: Python أو Node.js

ثبّت النسخة الرسمية openai حزمة لبيئة التشغيل الخاصة بك قبل المتابعة.

يحتاج مستخدمو Python إلى الإصدار 1.0.0 أو أحدث. يتطلب مطورو Node الإصدار 4.0.0 أو أحدث. تدعم كلا الإصدارين هيكل chat-completions القياسي.

لا حاجة لمكتبات إضافية. تتولى مكتقة تطوير البرمجيات (SDK) تجزئة JSON ونقل HTTP تلقائياً.

تكوين base_url ومفتاح API

وجّه عميل SDK الخاص بك إلى عنوان URL الأساسي الخاص بنا وقم بتزويد المفتاح الذي تم إنشاؤه.

استخدام https://api.openaicompatibleendpoint.com/v1 كعنوان URL الأساسي. اضبط مفتاح واجهة برمجة التطبيقات على القيمة المعروضة في لوحة التحكم الخاصة بك.

• Python: base_url="https://api.openaicompatibleendpoint.com/v1"
• Node: baseURL: "https://api.openaicompatibleendpoint.com/v1"

يعمل هذا الإعداد مع أي عميل متوافق مع SDK الخاص بـ OpenAI. لا حاجة لتغيير التعليمات البرمجية لباقي منطقك.

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

أجرِ طلب POST إلى /v1/chat/completions مع رسائل النظام والمستخدم الخاصة بك.

معرف النموذج هو uncensored. يجيب هذا النموذج دون رفض المحتوى البالغ القانوني أو المثير للجدل.

• نافذة السياق: 100,000 رمز إجمالاً.
• الإخراج الأقصى: 16,000 رمز.

أرسل تلميحك واحصل على مخرجات نصية على الفور. الأخطاء والرفضات مجانية. فقط استخدام الرموز الحقيقي يُخصم من رصيدك المدفوع مسبقاً.

فعّل البث واستدعاء الوظائف

فعّل البث عن طريق تعيين stream: true في معاملات الطلب الخاص بك.

يتم تضمين استهلاك الرمز في الشريحة الأخيرة من التدفق. يتيح لك ذلك تتبع التكاليف في الوقت الفعلي.

يدعم استدعاء الوظائف بشكل كامل. استخدم tools معامل لتحديد مخططك. يعيد النموذج استدعاءات الأدوات الهيكلية التي يمكنك تنفيذها في منطق تطبيقك. يتوفر أيضاً وضع JSON عبر response_format.

التعامل مع الأخطاء وحدود الرموز المميزة

تُعيد الـ API رموز حالة HTTP القياسية للمشاكل الشائعة.

• 401: مفتاح API غير صالح. تحقق من لوحة التحكم الخاصة بك.
• 402: رصيد غير كافٍ. أضف رصيداً عبر USDT أو USDC.
• 429: تم تجاوز حد المعدل. يُسمح لك بـ 300 طلب في الدقيقة.

إذا تجاوزت حد إخراج 16,000 رمز، سيتم اقتطاع الاستجابة. تتضمن نافذة السياق كلًا من رموز المطالبة وإكمال الاستجابة.

التسعير والحدود

ادفع فقط مقابل ما تستخدمه. تكلفة رموز الإدخال $0.15 لكل مليون. تكلفة رموز الإخراج $0.50 لكل مليون.

لا تنتهي صلاحية الرصيد المدفوع مسبقًا. لا تصدر استردادًا، ولكن يتم إصلاح الشحنات المزدوجة عبر الدعم.

أضف رصيدًا باستخدام العملات المشفرة فقط. العملات المقبولة هي USDT (TRC20) وUSDC (Base). الحد الأدنى للإيداع هو 20 دولارًا. يتراوح رصيد المكافأة من +5% إلى +15% اعتمادًا على المبلغ.

cURL

Copycurl https://api.openaicompatibleendpoint.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return list of supported file formats"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.openaicompatibleendpoint.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);

التدفق

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)