מפתחות OpenRouter ai: מדריך התחלה מהירה

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

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

• כותרת: Authorization: Bearer YOUR_API_KEY
• כתובת בסיס: https://api.openrouteraikeys.com/v1

בקשה ראשונה

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

Copycurl https://api.openrouteraikeys.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this documentation page"}]
  }'

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

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

Copyfrom openai import OpenAI

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

הגדר את OPENAI_API_KEY וגם OPENAI_BASE_URL משתני סביבה או העבר אותם ישירות לבנאי הלקוח. זה מבטיח שכל הקריאות הבאות ינותבו דרך נקודת הקצה ללא צנזורה שלנו. ניתן להמשיך להשתמש באותו גרסת SDK שיש לך כבר מותקנת.

Copyimport OpenAI from "openai";

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

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

אפשרו זרימה על ידי הגדרת stream: true בבקשה שלך. ה-API מחזיר קטעי אירועים שנשלחים מהשרת (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 טוקנים בסך הכל עבור פלט ושלמת. אתה מוגבל ל-300 בקשות לדקה לכל מפתח. שגיאת 401 מציינת שהמפתח שלך לא תקין או חסר. שגיאת 402 מציינת חוסר באשראי שולם מראש. שגיאת 429 מציינת שחרגת ממגבלת הקצב. סירובים עקב מדיניות התוכן הם ללא תשלום, אך שגיאות חישוב עשויות לצרוך טוקנים.