התחלה מהירה של API של Dolphin AI

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

התחל בהגדרת כתובת הבסיס ומפתח ה-API בתצורת הלקוח שלך. כל הבקשות מאמתות דרך ה Authorization כותרת באמצעות המפתח הייחודי שלך. השירות שלנו פועל כספק עצמאי עבור openrouter dolphin AI גרסת מודל, כלומר אינך צריך חשבון ב-OpenRouter כדי להשתמש בנקודה זו. פשוט קבל את המפתח שלך מהלוח ובצע הצמדה למשתני הסביבה שלך.

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

התצורה הזו עובדת עם כל SDK סטנדרטי של OpenAI כי אנחנו מחקים את מבנה הנקודה המדויק שלהם. אתה רק תתקשר עם נקודת הקצה של chat completions, מה ששומר על האינטגרציה שלך פשוטה וממוקדת בהפקת טקסט.

בקשה ראשונה

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

השתמשו בפקודת curl הבאה כדי לבדוק את החיבור שלך מיד:

Copycurl https://api.openrouterdolphinai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the syntax error in this python function"}]
  }'

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

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

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

הגדר את הלקוח עם כתובת הבסיס והמפתח שלך:

Copyfrom openai import OpenAI

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

זכור שחלון ההקשר שלנו הוא 100,000 טוקנים, כך שתוכל להעביר היסטוריית שיחה משמעותית. ה-SDK יטפל בטוקניזציה והעברה ביעילות, ויבטיח שההנחיות שלך יגיעו למודל ללא עודף מיותר או שגיאות עיצוב.

שימוש ב-Node SDK

מפתחי Node יכולים להשיג את אותן תוצאות באמצעות ה- openai חבילת npm. בדיוק כמו הגרסה Python, עליך לעקוף את כתובת ה-URL הבסיסית המובילה לשרתים הייעודיים שלנו. זה מבטיח שהבקשות שלך יגיעו ישירות למודל ללא צנזורה ללא פגיעה במגבלות קצב של צד שלישי או עיכובי הפניה.

אתחל את הלקוח עם נקודת הקצה הנכונה:

Copyimport OpenAI from "openai";

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

תבנית זו עובדת הן עבור קריאות סינכרוניות והן עבור תבניות async/await. ניתן לזרום תגובות או לבקש מצב JSON ישירות בתוך אותה קריאה לפונקציה, מה שמעניק גמישות לארכיטקטורות אפליקציה שונות ללא שינוי בהגדרות האימות הבסיסיות שלך.

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

אפשרו יצירת טקסט בזמן אמת על ידי הגדרת 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)

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

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

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

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