מדריך התחלה מהירה ל-API של מודלי AI דולפין

1. דרישות מוקדמות: SDK ומפתח API

הירשמו באמצעות חשבון Google או כתובת אימייל כדי לקבל מפתח API מיד. עליכם להשתמש ב-SDK הרשמי לשפת התכנות המועדפת עליכם כדי לתקשר עם נקודת הקצה. המפתח מאמת כל בקשה שאתם שולחים.

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

הגדר את כתובת הבסיס ל-HTTPS://api.dolphinmodelsai.com/v1 בתצורת הלקוח שלך. כתובת זו מנתבת את הבקשות שלך לשרתי האינפראנסה ה-uncensored שלנו. ודא שמפתח ה-API שלך מועבר בכותרת ההרשאה. נקודת הקצה עוקבת אחר דפוסים סטנדרטיים של OpenAI לתאימות.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.dolphinmodelsai.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. שלח בקשת השלמת צ'אט ראשונה

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

Copycurl https://api.dolphinmodelsai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Calculate the time complexity of this sorting algorithm"}]
  }'

4. הפעל זרימה וטפל בשימוש באסימונים

הגדר streaming ל-true כדי לקבל אסימונים כפי שנוצרים. כל חלק מכיל טקסט חלקי ונתוני שימוש. החלק הסופי כולל את ספירת האסימונים הכוללת לדיוק בחיוב. גישה זו מפחיתה את תחוית העיכוב לתגובות ארוכות.

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. שימוש במצב JSON לפלט מבני

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

6. יישום שיחות פונקציות (כלים)

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

7. הבן מגבלות קצב ופרמטרים

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

Python

Copyfrom openai import OpenAI

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