توثيق واجهة برمجة التطبيقات

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

عنوان URL الأساسي هو HTTPS://api.nsfwcom.com/v1. ألصق مفتاح API الخاص بك في Authorization قيمة التوكن كـ bearer token. يقوم هذا الرأس بمصادقة كل طلب يتم إرساله إلى نقطة النهاية.

• أدرج مفتاحك في كل طلب.
• حافظ على أمان مفتاحك ولا تشاركه علنًا.

أنشئ مفتاحك عبر لوحة التحكم وابدأ التكامل على الفور.

نقطة نهاية إكمال الدردشة

أرسل طلب POST إلى /v1/chat/completions مع رسائلك واسم النموذج. تعيد API إكمال النص بناءً على طلبك.

Copycurl https://api.nsfwcom.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five benefits of remote work for engineers"}]
  }'

استخدم معرف النموذج uncensored لضمان مخرجات متسقة وغير مصفاة لحالتك الاستخدام. قم بتكوين معلمات مثل temperature للتحكم في الإبداع.

واجهة برمجة تطبيقات Python

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

Copyfrom openai import OpenAI

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

يُمكّنك هذا النهج من الاستفادة من طرق SDK المألوفة لإكمال الدردشة. يمكنك تمرير قوائم من الرسائل واستقبال استجابات نصية منظمة مباشرة في نصوص Python الخاصة بك.

Node SDK

تثبيت حزمة OpenAI Node.js وتكوينها بعنوان URL الأساسي الخاص بنا. هذا يسمح لك بدمج واجهة API في مشاريع JavaScript أو TypeScript بسلاسة.

Copyimport OpenAI from "openai";

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

عرّف مصفوفة الرسائل الخاصة بك واستدعِ نقطة نهاية الإكمال. تتعامل مكتبة SDK مع طلبات HTTP والتحليل، مُعادة النص المُولد لمنطق تطبيقك.

استجابات البث عبر SSE

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

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 رمز. راقب حدود طلباتك لتجنب انقطاع الخدمة. تشمل الأخطاء الشائعة 401 للمفاتيح غير الصالحة، 402 لعدم كفاية الرصيد، و 429 لحدود المعدل.

لا تُصدر استردادات للائتمان المستهلك. لا تستهلك الأخطاء أثناء المعالجة الرموز. استخدم هذه الأكواد للتعامل مع الأعطال بسلاسة في تطبيقك.