תיעוד ה-API של Venice AI למפתחים

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

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

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

נקודת קצה להשלמות צ'אט

שלח בקשות טקסט ל- /v1/chat/completions נקודת קצה (endpoint) באמצעות שיטות HTTP POST סטנדרטיות. ה-API מקבל מטען JSON הכולל את שם המודל, הוראות מערכת והודעות משתמש.

להלן מבנה בקשה בסיסי:

Copycurl https://api.veniceapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check if the service blocks adult content in the test endpoint"}]
  }'

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

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

אינטגרציה עם SDK ב-Python

השתמשו בספריית הפיתון הרשמית של OpenAI כדי ליצור אינטראקציה עם ה-LLM ללא הצנזורה. הגדירו את הלקוח עם כתובת ה-Base URL של Venice ומפתח ה-API שלכם. גישה זו מפשטת בניית בקשות ופירוק תגובות.

Copyfrom openai import OpenAI

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

שיטה זו עובדת בצורה חלקה עם מאגרי קוד קיימים המיועדים ל-OpenAI. ניתן לשנות את כתובת הבסיס (base URL) מבלי לשנות את לוגיקת האפליקציה שלך באופן משמעותי. הספרייה מטפלת בסריאליזציה וחיבורי רשת באופן אוטומטי.

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

שילוב Node SDK

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

Copyimport OpenAI from "openai";

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

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

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

תגובות בזרם באמצעות SSE

אפשרו פלט בזמן אמת על ידי הגדרת ה stream פרמטר ל true. ה-API מחזיר זרם אירועים מוכוונים-שרת (SSE) במקום אובייקט JSON שלם. זה מאפשר לך להציג אסימונים כפי שהם נוצרים.

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)

Streaming reduces perceived latency for users. It is ideal for chat interfaces or live dashboards. The last chunk of the stream contains the final token usage statistics. Parse this data to track costs accurately.

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

טיפול בשגיאות ומגבלות

ה-API קובע מגבלת קצב של 300 בקשות לדקה לכל מפתח. מספר הבקשות המקבילות מוגבל ל-8 לכל מפתח. גוף הבקשה לא יכול לעלות על 8 MB. חריגה ממגבלות אלו תחזיר שגיאת 429 Too Many Requests.

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

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