دليل البدء السريع لـ Opensfw API

المصادقة وURL الأساسي

ابدأ بإنشاء المفتاح الخاص بك على لوحة التحكم. استخدم https://api.opensfw.com/v1 عنوان URL الأساسي وتعيين مفتاح API الخاص بك في Authorization الرأس. يعمل هذا الإعداد مع أي عميل مكتبة SDK قياسي لـ OpenAI.

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

أرسل طلب POST إلى /v1/chat/completions مع معرف النموذج الخاص بك والرسائل. يعالج النموذج غير الخاضع للرقابة مدخلاتك ويعيد النص المولد. استخدم مثال curl أدناه للتحقق من الاتصال.

Copycurl https://api.opensfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current release version of the model?"}]
  }'

الاستجابات التدفقية واستخدام الرموز

فعّل البث عن طريق تعيين stream: true في طلبك. تتلقى شِظايا نص بمجرد توليدها. تحتوي الشريحة الأخيرة على إحصائيات استخدام الرموز الكاملة للفوترة. استخدم مثال Python للتعامل مع التدفق.

Copyfrom openai import OpenAI

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

استدعاء الوظائف ووضع JSON

عرّف الأدوات في طلبك للإخراجات المهيكلة. استخدم response_format: {"type": "json_object"} لردود JSON الصارمة. هذا يعمل بسلاسة مع معاملات استدعاء الوظائف القياسية.

Copyimport OpenAI from "openai";

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

معالجة الأخطاء وحدود معدل الطلب

تحقق من 401 if your key is invalid, 402 لعدم كفاية الرصيد، و 429 لحدود المعدل. تحصل على 300 طلب في الدقيقة و 30 طلب متزامن لكل مفتاح. الأخطاء لا تستهلك الرموز.

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 رمز مميز. الحد الأقصى للإخراج هو 16,000 رمز مميز لكل طلب. حافظ على حجم جسم الطلب أقل من 8 ميجابايت. يضمن ذلك أداءً ثابتًا للمدخلات الكبيرة.