API Quickstart: השלמות צ'אט

אימות & כתובת הבסיס

מפתח ה-API שלך מאמת כל בקשה. השתמש ב- Authorization כותרת עם Bearer שיטה. כתובת הבסיס שלך היא https://api.nsfwopenrouter.com/v1. כתובת URL זו עובדת עם כל SDK תואם ל-OpenAI. אין צורך במנוי. אתם משלמים רק עבור טוקנים שנוצלו. שגיאות וסירובים אינם גורמים לתשלום. הירשמו באמצעות Google או אימייל כדי לקבל את המפתח שלכם מיד.

שליחת בקשת השלמת צ'אט

שלחו בקשת POST ל /v1/chat/completions. מזהה המודל הוא תמיד uncensored. ספק את הפומפט של המערכת כדי להגדיר התנהגות. כלל הודעות משתמש ב messages מערך. ה-API מחזיר פלט טקסט ישירות. אין נתיוב מורכב. התעבורה עוברת ישירות לשרתים שלנו. זה מבטיח טיפול עקבי בתוכן NSFW ללא מסננים מקדימים.

טיפול בתגובות זרם

אפשרו זרימה על ידי הגדרת stream אל true. ה-API מחזיר אירועים מוכוונים-שרת (SSE). כל מקטע מכיל טקסט חלקי. פרטי שימוש באסימונים מופיעים במקטע הסופי. זה מפחית את תחומת השהייה עבור משתמשים. הוא מאפשר הצגה בזמן אמת של התוכן שנוצר. טפל בשגיאות בתוך לוגיקת הזרם. השלך מקטעים לא שלמים במקרה של כשל.

הגדרת פרמטרי מודל

התאם temperature ליצירתיות. השתמש top_p לדגימת ליבה. הגדר max_tokens להגביל את אורך הפלט. המקסימום המוגדר כברירת מחדל הוא 2,048 טוקנים. ניתן לבקש עד 16,000 טוקנים לכל בקשה. חלון ההקשר תומך ב-100,000 טוקנים בסך הכל. זה כולל הן פרומפט והן השלמה. עדין הגדרות אלו עבור צרכי הרולפליי הספציפיים שלך.

אכיפת מצב JSON

שימוש response_format עם {"type": "json_object"}. המודל מבטיח פלט JSON תקין. מבנה זה קריטי לשילוב תכנותי. נתח את התגובה ישירות לתוך אובייקטי היישום שלך. הימנע מניתוח רגולרי לאמינות. תכונה זו מבטיחה חילוץ נתונים עקבי. היא עובדת בצורה חלקה עם SDKs סטנדרטיים.

הבנת קריאות לכלים (Tool Calls)

הגדירו כלים בגוף הבקשה. המודל יכול להחזיר קריאות פונקציה מבניות. השתמשו tool_choice כדי לכפות התנהגויות ספציפיות. זה מאפשר זרימות עבודה דינמיות של סוכנים. ה-API תומך בפורמטים סטנדרטיים של כלים של OpenAI. נתח את tool_calls מערך בתגובה. הפעל פונקציות והזן תוצאות בחזרה. זה מאפשר אינטראקציות מרובות שלב מורכבות.

cURL

Copycurl https://api.nsfwopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run my unit tests and show results"}]
  }'

Python

Copyfrom openai import OpenAI

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