תיעוד מפתח API Gemma

אימות וכתובת בסיס

השתמשו במפתח ה-API הייחודי שלכם לאימות כל בקשה. כתובת הבסיס היא HTTPS://api.gemmaapikey.com/v1 ואתם שולחים את המפתח בכותרת ה-Authorization. זה עובד עם כל לקוח תואם OpenAI על ידי שינוי base_url ומפתח ה-API. אם איבדתם אותו, צרו מפתח חדש מהלוח. המפתח הישן מפסיק לעבוד מיד. שגיאות ודחיות לא צורכות את האשראי ששולם מראש.

בקשה ראשונה

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

Copyfrom openai import OpenAI

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

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

שילוב Node SDK

התקן את ה-SDK הרשמי של OpenAI עבור Node.js. הגדר אותו עם מפתח ה-API שלך וכתובת הבסיס מהמדריך הזה. קרא לשיטת chat.completions.create עם ההודעה שלך.

Copyimport OpenAI from "openai";

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

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

תגובות בסטרימינג

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

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)

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

מגבלות קצב והקשר

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

המודל תומך בשימוש בפונקציות, מצב JSON ופרמטרים סטנדרטיים כמו seed ו-presence_penalty. הקלט המרבי הוא 16,000 טוקנים לכל בקשה. אם לא מגדירים max_tokens, ברירת המחדל היא 2,048.

שגיאות ופתרון תקלות

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

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

cURL

Copycurl https://api.gemmaapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return the current system status"}]
  }'