התחלה מהירה: חיבור הלקוח שלך

דרישות מוקדמות והתקנת SDK

התקן את ה-SDK הרשמי לשפת התכנות שלך כדי לטפל באימות וברצף בקשות באופן אוטומטי. נדרש מפתח API תקף וכתובת הבסיס (base URL) מוגדרים בסביבת הלקוח שלך. השירות שלנו מקבל פרמטרים סטנדרטיים כמו temperature ו-top_p ללא צורך בכותרות מותאמות אישית.

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

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

כוון את הלקוח שלך לכתובת ה-URL הבסיסית הספציפית שלנו כדי להפנות בקשות דרך התשתית ללא צנזורה שלנו. השתמש בכותרת Authorization: Bearer YOUR_KEY כדי לאמת כל שיגוע. תצורה זו עובדת זהה לבדיקות מקומיות או להטמעת סקריפטים בסביבת ייצור.

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

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

Execute a standard chat completions call to verify connectivity and response format. Send a simple prompt to confirm the model returns text without refusal. This test ensures your key has sufficient prepaid credit for usage.

Copycurl https://api.keyapiminimax.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a JSON object with keys id and name"}]
  }'

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

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

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

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)

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

אינטגרציית SDK Python

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

Copyfrom openai import OpenAI

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

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

Node SDK ומגבלות

שילוב עם אפליקציות Node.js באמצעות ה-SDK הרשמי של JavaScript. הגדר את כתובת ה-URL הבסיסית כדי להבטיח שהבקשות יגיעו לנקודת הקצה ללא הגבלות שלנו. עקוב אחר השימוש שלך כדי להישאר בתוך מגבלות הקצב.

Copyimport OpenAI from "openai";

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

ניתן לבצע 300 בקשות לדקה עם קונקרנטיות של 8. כל גוף בקשה חייב להישאר מתחת ל-8 MB. חלון ההקשר תומך ב-100,000 טוקנים בסך הכל. שגיאות וסירובים לא צורכים קרדיט, אך פלט מוצלח כן. שמור על המפתח שלך מאובטח והחלף אותו אם צריך.

הבנת שימוש בטוקנים

החיוב מבוסס על טוקנים בפועל ששימשו ב-prompt וב-completion. טוקני קלט עולים $0.15 למיליון, בעוד שטוקני פלט עולים $0.50 למיליון. קרדיט מוקדם מכסה את כל השימוש ללא עמלות חודשיות.

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