عنوان URL الأساسي والمصادقة
المصادقة تتطلب مفتاح API واحد يمرر في Authorization رأس.
يجب أن يستهدف كل طلب عنوان URL الأساسي https://api.dolphinaisincensura.com/v1 و将密钥包含为 Bearer YOUR_API_KEY.
يعمل هذا مع أي مكتبة SDK متوافقة مع OpenAI عن طريق تحديث base_url التكوين.
أخطاء مثل 401 تشير إلى مفتاح غير صالح أو مفقود، بينما 402 تشير إلى عدم كفاية الرصيد المسبق.
curl https://api.dolphinaisincensura.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "list the python imports for requests and json"}]
}'إرسال طلب إكمال الدردشة
أرسل طلب POST إلى /v1/chat/completions مع model field مضبوطًا إلى uncensored.
تضمين messages مصفوفة تحتوي على سجل محادثاتك للحفاظ على سياق المحادثة.
تُعيد الـ API استجابة نصية مباشرة في content field من الخيار الأول.
يلغي نهج النموذج الوحيد رسوم الوكيل ويضمن تسعراً متوقعاً عند $0.15 لكل مليون رمز إدخال.
from openai import OpenAI
client = OpenAI(base_url="https://api.dolphinaisincensura.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) التي توصل الرموز تدريجياً.
تحليل كل قطعة SSE لاستخراج النص المولد دون انتظار الاستجابة الكاملة.
تتوفر إحصائيات استهلاك الرمز في الشريحة الأخيرة من التدفق للفوترة الدقيقة.
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)استدعاء الوظائف ووضع JSON
استخدم ال tools معامل لتحديد مخططات الوظائف لاستخراج البيانات الهيكلية.
تعيين response_format إلى {"type": "json_object"} لإجبار إخراج JSON صارم لتحليل موثوق.
تحديد temperature و top_p التحكم في الإبداع مقابل الحتمية في نتائجك.
تتيح لك هذه الميزات بناء وكلاء مستقلين يتفاعلون مع واجهات برمجة التطبيقات أو قواعد البيانات الخارجية.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.dolphinaisincensura.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);فهم حدود الرموز والسياق
يدعم نافذة السياق 100,000 رمز موزعة بالتساوي بين النص التوجيهي والإكمال.
الحد الأقصى للإخراج لكل طلب هو 16,000 رمز، أو 2,048 إذا max_tokens غير مُضبط.
تسمح حدود معدل الطلبات بـ 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح API.
تعيد الطلبات التي تتجاوز حد حجم الجسم البالغ 8 ميجابايت أو تضرب حدود التزامن أخطاء 429.
لا تستهلك استجابات الأخطاء والرفضات رصيدك المدفوع مسبقاً.
حدود المعدلات والتزامن
يُقتصر كل مفتاح API على 300 طلب في الدقيقة و8 اتصالات متزامنة نشطة.
يشير رمز الحالة 429 إلى أنك تجاوزت عتبات التزامن أو حدود معدل الطلب.
يمكنك إنشاء مفتاح جديد لاستبدال مفتاح موجود، ولكن يُسمح بمفتاح نشط واحد فقط لكل حساب.
راقب استهلاكك عبر رؤوس الاستجابة للبقاء ضمن حد حجم طلب 8 ميجابايت.
