התחלה מהירה: ממשק API להשלחת צ'אט

דרישות מוקדמות וכתובת בסיס

ה-API שלנו תואם לממשק השלמות הצ'אט הסטנדרטי של OpenAI. נדרשת רק כתובת בסיס ומפתח API כדי להתחיל לשלוח בקשות. כתובת הבסיס היא HTTPS://api.howmuchisanapikey.com/v1. נקודת הקצה הבודדת הזו מטפלת בכל יצירת הטקסט ללא צורך לנהל מספר כתובות שירות או תצורות פרוקסי.

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

כותרות ואימות

כלול את כותרת ההרשאה בכל בקשה כדי לאמת את הזהות שלך. פורמט הכותרת הוא Authorization: Bearer YOUR_API_KEY. אם המפתח לא תקף או פג תוקף, ה-API מחזיר שגיאת 401 מיד. זה מבטיח שרק חשבונות מורשים יצרכו את האשראי הקנוי שלך.

אין צורך להעביר כותרות נוספות ליצירת טקסט בסיסית. עם זאת, אם אתה משתמש בתכונות ספציפיות כמו מצב JSON או קריאת פונקציות, עליך להגדיר את כותרת Content-Type ל-application/json. זה אומר לשרת כיצד לנתח את גוף הבקשה שלך בצורה נכונה.

שליחת השלמת הצ'אט הראשונה שלך

שלח בקשת POST ל-/v1/chat/completions עם היסטוריית ההודעות שלך ומזהה המודל. מזהה המודל הוא "uncensored". מודל זה מותאם לענות ללא סירובים לתוכן מבוגר חוקי, סיפורת או נושאים שנויים במחלוקת. הוא לא מסנן בהתבסס על נורמות פוליטיות או חברתיות סטנדרטיות.

להלן דוגמה בסיסית ב-curl להתחלה:

Copycurl https://api.howmuchisanapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a simple hello world function in python"}]
  }'

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

תגובות בזרם ושימוש באסימונים

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

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

קריאת פונקציות ומצב JSON

ה-API תומך בפלט מבני באמצעות מצב JSON וקריאת פונקציות. הגדר response_format ל-{"type": "json_object"} כדי לאלץ את המודל להחזיר JSON תקף. זה שימושי לחילוץ נתונים או יצירת תצורות מבניות ללא שגיאות פיענוח.

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

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

אתה מוגבל ל-300 בקשות לדקה למפתח ו-8 בקשות מקבילות. אם תחרוג ממגבלות אלו, תקבל שגיאת 429 Too Many Requests. גוף התגובה יכלול פרטי retry-after. התאם את האטרת הצד-לקוח כדי להימנע מניסיונות חוזר מיותרים.

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

Python

Copyfrom openai import OpenAI

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