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

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

האימות דורש מפתח API יחיד המועבר ב- Authorization כותרת.

כל בקשה חייבת לפנות לכתובת הבסיס https://api.dolphinaisincensura.com/v1 והכלילו את המפת כ Bearer YOUR_API_KEY.

התצורה הזו עובדת עם כל SDK התואם ל-OpenAI על ידי פשוט עדכון ה base_url תצורה.

שגיאות כמו 401 מצביעות על מפתח לא חוקי או חסר, בעוד ש-402 מסמן אשראי מוקדם לא מספיק.

Copycurl https://api.dolphinaisincensura.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the python imports for requests and json"}]
  }'

שליחת השלמת צ'אט

שלחו בקשת POST ל /v1/chat/completions עם model field set to uncensored.

כלול messages מערך המכיל את היסטוריית ההודעות שלך לשמירה על הקשר השיחה.

ה-API מחזיר תגובת טקסט ישירות ב content field of the first choice.

גישה זו המבוססת על מודל יחיד מבטלת עמלות מתווך ומבטיחה תמחור צפוי של $0.15 לכל 1M טוקני קלט.

Copyfrom openai import OpenAI

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

טיפול בזרם נתונים (SSE)

אפשרו זרימה על ידי הגדרת stream אל true בפלט הבקשה שלך.

השרת מגיב באירועים שנשלחו על ידי השרת (SSE) המספקים אסימונים בהדרגה.

נתח כל מקטע 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)

פקודות פונקציה ומצב JSON

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

הגדר response_format אל {"type": "json_object"} כדי לכפות פלט JSON קפדני לניתוח אמין.

ציין temperature וגם top_p כדי לשלוט ביצירתיות מול דידטרמיניזם בתוצאות שלך.

תכונות אלו מאפשרות לך לבנות סוכנים אוטונומיים שפועלים עם APIים חיצוניים או מסדי נתונים.

Copyimport OpenAI from "openai";

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

הבנת מגבלות טוקנים והקשר

חלון ההקשר תומך ב-100,000 טוקנים עבור הנחיה והשלמה משולבות.

הפלט המקסימלי לכל בקשה הוא 16,000 טוקנים, או 2,048 אם max_tokens לא מוגדר.

גבולות קצב מאפשרים 300 בקשות לדקה ו-8 בקשות מקבילות לכל מפתח API.

בקשות העולות על מגבלת גוף הבקשה של 8 MB או פוגעות במגבלות מקבילות מחזירות שגיאות 429.

תגובות שגיאה וסירובים לא צורכים את האשראי המוקדם שלך.

מגבלות קצב ונלוות

כל מפתח API מוגבל ל-300 בקשות לדקה ו-8 חיבורים פעילים בו-זמנית.

קוד סטטוס 429 מציין שחרגת ממגבלות התחרות או מגבלות הקצב הללו.

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

עקבו אחר השימוש שלכם דרך כותרות התגובה כדי להישאר בתוך מגבלת גוף הבקשה של 8 MB.