תיעוד API

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

התחל על ידי יצירת המפתח שלך בדשבורד. כתובת הבסיס שלנו היא HTTPS://api.aivenice.cc/v1. העבר את המפתח שלך בכותרת Authorization. מפתח פעיל אחד לחשבון מחליף את הקודם אוטומטית.

דוגמה לבקשה ראשונה

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

Copyfrom openai import OpenAI

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

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

Copyimport OpenAI from "openai";

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

טפלו בתגובות ישירות בסביבת ה-JavaScript שלכם. המבנה תואם פורמטים סטנדרטיים של OpenAI להיכרות.

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

אפשרו זרמת נתונים על ידי הגדרת stream ל-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)

נתח את אירועי ה-SSE כדי לעדכן את הממשק שלך בזמן אמת. זה אידיאלי לממשקי צ'אט הדורשים משוב מיידי.

פרמטרים ומגבלות

התאם את הטמפרטורה, top_p ו-seed לשליטה. פלט מקסימלי הוא 16,000 טוקנים. חלון ההקשר הוא 100,000 טוקנים. מגבלת הקצב היא 300 בקשות לדקה. גודל הגוף מקסימלי הוא 8 MB.

המגבלות האלו מבטיחות ביצועים יציבים. חריגה ממגבלות הקצב מחזירה שגיאת 429. הגבר את הנלוות אם צריך.

שגיאות וחלון ההקשר

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

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

cURL

Copycurl https://api.aivenice.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the latest error logs from server logs"}]
  }'