כתובת URL בסיסית ואימות
כתובת הבסיס לכל הבקשות היא https://api.veniceaiapipricing.com/v1. אתה מאשר גישה על ידי העברת מפתח ה-API שלך ב Authorization header כערך bearer token. הגדרה זו עובדת עם כל SDK סטנדרטי של OpenAI. החליפו את YOUR_API_KEY עם המפתח שנוצר בלוח הבקרה של החשבון שלך.
- נקודת קצה:
POST /v1/chat/completions - כותרת:
Authorization: Bearer YOUR_API_KEY
curl https://api.veniceaiapipricing.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Return server status code 200"}]
}'נקודת הקצה /v1/chat/completions
שלח את היסטוריית השיחה שלך ל /v1/chat/completions באמצעות ה- uncensored מזהה המודל. ה-API מקבל אובייקטי הודעות סטנדרטיים עם role וגם content שדות. טוקני קלט עולים $0.15 למיליון, וטוקני פלט עולים $0.50 למיליון. שגיאות וסירובים לא צורכים אשראי.
נקודת הקצה הזו תומכת ביצירת טקסט בלבד. היא אינה מטפלת בתמונות, אודיו או הטמעות. ניתן לזרום תגובות או לקבל את הטקסט המלא כמאפיין JSON יחיד.
from openai import OpenAI
client = OpenAI(base_url="https://api.veniceaiapipricing.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 בגוף הבקשה שלך. ה-API מחזיר אירועים מוכוון שרת (SSE) עבור כל טוקן שנוצר. הפסיקה הסופית מכילה את סטטיסטיקות השימוש הכוללות בטוקנים. שיטה זו מפחיתה את תחומת השהייה עבור תגובות ארוכות.
טיפול בזרם חיוני ליישומים בזמן אמת. ניתן לעבד טוקנים כפי שהם מגיעים במקום להמתין להשלמה מלאה.
stream = 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
ה-API תומך בפלטים מבניים והגדרת כלים. השתמש ב- response_format: {"type": "json_object"} כדי לכפות פלט JSON. ניתן גם להעביר tools לקריאת פונקציות, המאפשרת למודל להחזיר נתונים מבניים ללוגיקת האפליקציה שלך.
תכונה זו שימושית לחילוץ נתונים או הפעלת פעולות. המודל מחזיר קריאות לכלים בפורמט סטנדרטי. לאחר מכן אתה יכול להריץ את הפונקציות שלך ולהזין תוצאות בחזרה לשיחה.
פרמטרים: טמפרטורה, Top P, ו-seeds
שלו על יצירתיות עם temperature וגם top_p. ה seed פרמטר מבטיח פלטות דטרמיניסטיות לבדיקות. פרמטרים אלו עוקבים אחר נהגי OpenAI הסטנדרטיים. התאמתם משפיעה על האקראיות של הטקסט שנוצר.
הגדר temperature ל-0.7 ליצירתיות מאוזנת. השתמש seed לשם תוצאות שחזוריות. ה-API מתעלם מפרמטרים לא נתמכים בצורה חכמה.
מגבלות קצב ואילוצים
אתה מוגבל ל-300 בקשות לדקה לכל מפתח. מותר עד 8 בקשות מקבילות לכל מפתח. גודל גוף הבקשה מוגבל ל-8 MB. חלון ההקשר הוא 100,000 טוקנים בשילוב קלט ופלט. הפלט המקסימלי לכל בקשה הוא 16,000 טוקנים.
חריגת הגבולות הללו מחזירה שגיאה 429. ודא שהלקוח שלך מטפל בניסיונות חוזרים באופן מתאים. מפתח ה-API הוא ייחודי לכל חשבון; יצירת מפתח חדש מחליף את הישן.
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.veniceaiapipricing.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);