תיעוד API

כתובת URL בסיסית ואימות

נקודת הקצה של ה-API נמצאת ב https://api.openrouteraiapi.com/v1. העבר את מפתח ה-API שלך ב Authorization header כערך bearer token. זהו השינוי היחיד הנדרש כדי להפנות תעבורה מספק הנוכחי שלכם לדגם ה-uncensored שלנו.

האימות הוא קפדני. אם המפתח חסר או לא חוקי, השרת מחזיר שגיאת 401 מיד. ניתן ליצור מפתח מיד דרך Google או אימייל בדשבורד. שמרו על המפתח מאובטח, שכן הוא מעניק גישה לאשראי ששולם מראש.

נקודת קצה להשלמות צ'אט

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

להלן בקשה סטנדרטית באמצעות cURL לאימות חיבור ופורמט תגובה.

Copycurl https://api.openrouteraiapi.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 python libraries for data science"}]
  }'

התגובה כוללת את הטקסט שנוצר ב- choices[0].message.content שדה. אתם יכולים לנתח את זה ישירות לתוך זרימת העבודה של האפליקציה שלכם.

אינטגרציית SDK Python

השתמשו בלקוח Python הרשמי של OpenAI לחיבור ללא מאמץ. הגדירו את base_url וגם api_key משתנים כדי להפנות לתשתית שלנו. גישה זו מזערה את שינויי הקוד בעת החלפת ספקים.

Copyfrom openai import OpenAI

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

הלקוח מטפל בטרנספורמצייה וניסיונות חוזרים באופן אוטומטי. אתה מקבל אובייקט השלמה המכיל את הטקסט וסטטיסטיקות שימוש באסימונים. שיטה זו אידיאלית לשירותי backend וסקריפטים.

שימוש ב-SDK Node.js

אתחל את לקוח Node.js של OpenAI עם כתובת הבסיס המותאמת אישית שלך. זה מאפשר ליישומי JavaScript לקיים אינטראקציה עם המודל ללא צנזורה באמצעות שיטות מוכרות. ה-SDK מנהל את בקשות ה-HTTP ביעילות.

Copyimport OpenAI from "openai";

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

שיחה chat.completions.create() עם ההודעות שלך. אובייקט התגובה מספק גישה לתוכן שנוצר ונתוני שימוש. אינטגרציה זו עובדת היטב עבור שרתים וירטואליים ופונקציות קצה.

תגובות בסטרימינג

אפשרו זרימה על ידי הגדרת 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 טוקנים לקלט ופלט משולבים. כל בקשה יכולה להפיק עד 16,000 טוקנים, או 2,048 אם max_tokens לא מוגדר. מגבלות הקצב מאפשרות 300 בקשות לדקה לכל מפתח.

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