שלב את ה-Venice AI API תוך דקות

הגדרת כתובת URL בסיסית ואימות

ה-API נמצא ב https://api.veniceaiapi.com/v1. אתה מאשר באמצעות מפתח API יחיד המועבר ב Authorization כותרת.

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

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

מזהה המודל שחייב לשלוח הוא "uncensored". זהו מודל בעל משקל פתוח שכוון למתן תשובות ללא סריל תוכן לשימוש מבוגר חוקי.

• כתובת בסיס: https://api.veniceaiapi.com/v1
• כותרת Auth: Authorization: Bearer YOUR_API_KEY
• מודל: uncensored

ניתן לבדוק חיבוריות עם בקשת GET פשוטה ל /v1/models. זה מאשר שהמפתח שלכם עובד לפני שאתם שולחים מטענים כבדים.

נקודת הקצה /v1/chat/completions

שלח הנחיות טקסט ל- POST /v1/chat/completions וקבל תגובות טקסט. נקודה קצה זו מטפלת בכל אינטראקציות הצ'אט הסטנדרטיות.

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

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

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

פרמטרי מודל: טמפרטורה, Top-P ו-Seed

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

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

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

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

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

תגובות בסטרימינג עם אירועים שנשלחו מהשרת

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

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

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

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

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

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

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

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

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

תכונה זו הופכת את ה-API לראוי לבניית סוכנים או עבודות שוטפות אוטומטיות.

מגבלות קצב ואילוצי טוקנים

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

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

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

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

המחיר הוא $0.15 לכל 1M אסימוני קלט ו-$0.50 לכל 1M אסימוני פלט. העלאות יתרה הן רק באמצעות מטבעות קריפטו, בסכומים מ-$20 ועד $500.

cURL

Copycurl https://api.veniceaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return status as json"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

זרימה

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)