دليل البدء السريع لواجهة برمجة التطبيقات لكاتب غير مناسب للجمهور

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

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

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

إرسال طلبك الأول

أرسل طلب محادثة بسيطًا لتوليد النص باستخدام نموذجنا uncensored.

استخدم ال POST /v1/chat/completions النقطة النهائية. اضبط model field إلى uncensored. قم بتضمين مطالبة النظام ورسالة المستخدم. يُرجع الـ API استجابة نصية. الأخطاء مثل 401 أو 402 شائعة إذا كان مفتاحك خاطئاً أو لم يكن لديك رصيد.

Copycurl https://api.writernsfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set role to unrestricted writer for this session"}]
  }'

الدمج مع Python SDK

استخدم مكتبة Python الرسمية للتفاعل مع واجهة برمجة التطبيقات برمجياً.

تثبيت openai حزمة. قم بتكوين عنوان URL الأساسي لنقطة النهاية الخاصة بنا. مرر مفتاح API الخاص بك. اتصل بـ chat.completions.create الطريقة. يحافظ هذا النهج على نظافة الكود وقابليته للصيانة. يتعامل مع إعادة المحاولة والتحليل تلقائياً.

Copyfrom openai import OpenAI

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

ابنِ روبوت الدردشة NSFW أو أداة الكتابة الخاصة بك باستخدام Node.js.

تثبيت openai npm package. Initialize the client with your base URL and key. Call the completion endpoint. This method is ideal for server-side generation. It supports both synchronous and asynchronous patterns.

Copyimport OpenAI from "openai";

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

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

استلم الرموز (Tokens) بمجرد توليدها لتجربة مستخدم أكثر سلاسة.

تعيين stream: true في طلبك. تُعيد الـ API تدفقًا بأحداث الإرسال من الخادم. تحتوي كل شريحة على نص جزئي. اجمع هذه الشرائح لعرض الاستجابة في الوقت الفعلي. تتضمن الشريحة الأخيرة تفاصيل استخدام الرمز. يقلل هذا من زمن الاستجابة المُدرَك بشكل كبير.

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)

حدود، أخطاء، والسياق

تعامل مع حدود المعدل وفهم ميزانيتك من الرموز لتجنب انقطاع الخدمة.

تحصل على 300 طلب في الدقيقة و8 طلبات متزامنة. نافذة السياق تبلغ 100,000 رمز إجمالاً. تشمل الأخطاء 401 للمفاتيح غير الصالحة و402 لقلة الرصيد. الرفضات بسبب حدود المحتوى مجانية. لا تستهلك الأخطاء الرصيد. راقب استخدامك للبقاء ضمن الحدود.