התחלה מהירה: שילבו תוך דקות

1. התקן את ה-SDK שלך

התחל בהתקנת הספרייה הרשמית לשפתך. רוב המפתחים מעדיפים את החבילה הסטנדרטית מכיוון שהיא תואמת לממשק שהם כבר מכירים. הרץ pip install openai ל-Python או npm install openai לNode.js. אתם צריכים רק SDK אחד לטיפול בכל הבקשות.

2. הגדר את כתובת הבסיס שלך

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

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

3. שלח את הבקשה הראשונה שלך

שלח בקשת השלמת צ'אט סטנדרטית כדי לייצר טקסט. מזהה המודל הוא uncensored. ניתן לשלוח הנחיות מערכת כדי להנחות את ההתנהגות. ה-API מחזיר תגובת טקסט ישירה. השתמש בפקודת curl למטה כדי לבדוק חיבוריות מיידית. בדוק את התגובה שלך עבור ה choices מערך.

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

4. טפל בתגובות זורמות

אפשרו זרימת נתונים לזמן אחזור נמוך ופלט בזמן אמת. הגדירו 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)

5. הגדר פרמטרים

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

6. מגבלות, שגיאות והקשר

טפלו בשגיאות בצורה חכמה באמצעות קודי HTTP סטנדרטיים. שגיאת 401 אומרת שהמפתח שלכם לא חוקי. שגיאת 402 מציינת חוסר בזכות משולמת מראש. שגיאת 429 מציין שפגתם את מגבלת ה-300 בקשות לדקה. חלון ההקשר שלכם הוא 100,000 טוקנים. בקשות מעל 8 MB עשויות להיכשל. החזרים לא ניתנים עבור זכות, אך שגיאות הן בחינם.