מדריך התחלה מהירה למפתחים

דרישות מוקדמות: מפתח ה-API שלך

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

הגדרת Cursor לתאימות עם OpenAI

כוון את הלקוח שלך לנקודת הקצה הספציפית שלנו כדי להבטיח הפניה נכונה. הגדר את כתובת ה-URL הבסיסית ל-HTTPS://api.keyapicursor.com/v1 והכנס את המפתח שלך לכותרת ההרשאה. תצורה זו עובדת עם כל SDK תואם OpenAI סטנדרטי ללא שינוי שם המודל. עליך לציין את מזהה המודל כ-uncensored כדי לקבל את הפלט בעל המשקל הפתוח.

שליחת הבקשה הראשונה שלך

Execute a simple completion to verify connectivity and latency. Use the curl command below to send a basic prompt to the chat completions endpoint. The response returns a JSON object containing the generated text. Check the usage field to confirm token consumption matches your expectations.

טיפול בתגובות זרם

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

שילוב עם SDKs של Python ו- Node

השתמשו מחדש בקוד קיים על ידי התאמת פרמטרי כתובת הבסיס והמפתח בלבד. קטע הקוד ב-Python מדגים שילוב ישיר עם ספריית הלקוח הרשמית. הדוגמה ב-Node עוקבת אחר אותו דפוס לסביבות JavaScript. שתי השיטות תומכות ב-JSON mode ובקריאת פונקציות כברירת מחדל.

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

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

cURL

Copycurl https://api.keyapicursor.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in function parseData"}]
  }'

Python

Copyfrom openai import OpenAI

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