אימות ומפתחות API
התחל ביצירת חשבון כדי לקבל את מפתח ה-API שלך מיד. ניתן להירשם באמצעות Google או מייל וסיסמה ללא צורך במספר טלפון. המערכת מייצרת מפתח פעיל אחד לכל חשבון, ויצירת מפתח חדש מחליפה את הישן מיד. אתה צריך רק כתובת מייל כדי להתחיל, והפרומפטים שלך לא משמשים לאימון. השתמש במפתח זה ב Authorization header כערך bearer token לכל הבקשות.
בקשה ראשונה
בצעו את השימה הראשונה שלך לנקודת הקצה של השלמת צ'אט באמצעות מפתח ה-API שלך. כתובת ה-URL הבסיסית היא https://api.aidphn.com/v1 ועובד עם לקוחות סטנדרטיים תואמי OpenAI. עליך לציין את המודל uncensored לגישה למודל שפה גדול ללא סינון. שגיאות וסירובים לא צורכים את האשראי שלכם מראש, כך שתוכלו לבדוק בבטחה.
curl https://api.aidphn.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top 5 Rust crates for async HTTP clients"}]
}'
ודא שהמפתח שלך עובד על ידי בדיקת נקודת הקצה של רשימת המודלים. זה מאשר חיבוריות לפני שאתה שולח פרומפטים מורכבים. ה-API מקבל טקסט כקלט ומחזיר טקסט כפלט, תומך בפרמטרים סטנדרטיים כמו temperature ו-top_p.
אינטגרציית SDK Python
השתמשו בספריית הפיתון הרשמית של OpenAI כדי ליצור אינטראקציה עם נקודת הקצה שלנו. הגדירו את כתובת ה-Base URL לשרת ה-API שלנו וספקו את המפתח שלכם. גישה זו מאפשרת לכם להשתמש מחדש בקוד קיים מפרויקטי OpenAI ללא שינויים משמעותיים. מזהה הדגם נשאר uncensored לכל ההשלמות.
from openai import OpenAI
client = OpenAI(base_url="https://api.aidphn.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)
ניתן להגדיר פרמטרים כמו max_tokens לשליטה באורך הפלט. ברירת המחדל המרבית לפלט היא 2,048 טוקנים, אך ניתן להגדיל אותה עד 16,000 לכל בקשה. סטרימינג זמין לתגובות ארוכות כדי להפחית זמן המתנה.
שימוש ב-Node SDK
שלב את ה-API באפליקציות Node.js שלך באמצעות ה-SDK הסטנדרטי. נקוב את הלקוח לכתובת הבסיס שלנו ואמת עם המפתח שלך. שיטה זו תומכת גם בבקשות סינכרוניות וגם באסינכרוניות לשילוב גמיש. ניתן להעביר כלים לקריאה לפונקציות או לאכוף מצבי פלט JSON.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aidphn.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);
טפלו בתגובות על ידי ניתוח שדה התוכן מאובייקט ההשלמה. ה-API תומך בפרמטרים סטנדרטיים כמו stop רצפים ו seed לשחזור. טיפול בשגיאות צריך לקחת בחשבון מגבלות קצב וזמינות אשראי.
תגובות בסטרימינג באמצעות 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)
זרימה מפחיתה את תחוית העיכוב עבור משתמשים הממתינים לתגובות ארוכות. ניתן לעבד אסימונים באופן עוקב או להמתיק אותם לשימוש מאוחר יותר. חלון ההקשר תומך בעד 100,000 אסימונים להנחיה והשלמה משולבים.
מגבלות ושגיאות
נטר את השימוש שלך מול מגבלות קצב קפדיות ומאזני קרדיט. ניתן לשלוח 300 בקשות לדקה ויש 8 בקשות מקבילות לכל מפתח. גודל גוף הבקשה המקסימלי הוא 8 MB. שגיאות כמו 401 מציינות מפתח לא תקין, בעוד ש-402 אומר שצריך למלא קרדיט. שגיאות 429 מציין שעברת את מגבלת הקצב. מלא קרדיטים רק עם קריפטו, החל מ-$20, כדי להמשיך להשתמש בשירות ללא הפרעה.