תיעוד
עורכים וסביבות IDE

gptel

Markdown

חבילת Emacs · OpenAI Chat, Anthropic Messages, Gemini

המדריך המלא
פורמטהיכן להגדיר
OpenAI Chat, Anthropic Messages, Geminiinit.el: רשמו backend באמצעות gptel-make-openai (OpenAI Chat), gptel-make-anthropic (Messages) או gptel-make-gemini — לכל אחד :host, :endpoint, :key, :stream, :models; לאחר מכן הגדירו gptel-backend ו-gptel-model.

הגדרה

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

לפני ההפעלה, קראו ל־GET /v1/models עם מפתח Ailoot שלכם. בחרו מזהה מדויק של מודל שהשיטות שלו כוללות POST /v1/chat/completions, POST /v1/messages, POST /v1beta/models/{model}:generateContent, והשתמשו בו בהגדרות. עבור סוכנים, בדקו גם תמיכה בכלים ואת התכונות הדרושות לגרסת הלקוח שלכם.

(setq gptel-model 'claude-sonnet-5-5
      gptel-backend
      (gptel-make-openai "Ailoot"
        :host "api.ailoot.ai"
        :endpoint "/v1/chat/completions"
        :stream t
        :key (getenv "AILOOT_API_KEY")               ; או (gptel-api-key-from-environment "AILOOT_API_KEY")
        :models '(claude-sonnet-5-5 gpt-6.1-sol deepseek-v4-pro qwen3.8-max)))

;; חלופת Anthropic Messages
(gptel-make-anthropic "Ailoot-Claude"
  :host "api.ailoot.ai"          ; נתיב ברירת המחדל /v1/messages
  :stream t
  :key (getenv "AILOOT_API_KEY")
  :models '(claude-sonnet-5-5 claude-opus-5-5))

ההגדרה הזאת קוראת את המפתח מהמשתנה AILOOT_API_KEY. הגדירו אותו לפני הפעלת האפליקציה:

export AILOOT_API_KEY="sk-..."   # הוסיפו ל-~/.zshrc או ל-~/.bashrc

דוגמת מודל: claude-sonnet-5-5. בחרו כל מודל אחר מתוך הקטלוג — בדקו שהוא תומך בפורמט הנדרש.

חשוב לדעת

בדיקה

  • עבור :host ו-:endpoint, שמרו על הערכים הנפרדים מהדוגמה שלמעלה. קידומת המתודות של OpenAI היא https://api.ailoot.ai/v1 (או הנתיב המלא, אם האפליקציה מבקשת כתובת מלאה).
  • עבור פורמט Anthropic, הכתובת היא https://api.ailoot.ai ללא /v1.
  • עבור פורמט Gemini, הכתובת היא https://api.ailoot.ai — כתובת השורש של ה-API. ההגדרה המלאה של הפורמט הזה אינה מוצגת בדוגמה שלמעלה; בדקו בתיעוד תוכנת הלקוח איזה נתיב נדרש בשדה המתאים. קידומת נתיב ה-API היא /v1beta.
  • שאלו שאלה קצרה. אם מתקבלת שגיאה — בדקו את הקוד ואת ה-Request ID והשוו לעמוד שגיאות ומגבלות.
  • 404 מיד לאחר ההגדרה כמעט תמיד מציין כתובת שגויה: רכיב מיותר או חסר של /v1.
  • 402 — אין די יתרה לרזרבה. סוכנים שומרים רזרבה גדולה יותר מצ'אט: למה.

תיעוד האפליקציה: https://github.com/karthink/gptel

נשארו שאלות? שלחו Request ID ותיאור — נעזור לברר.פנייה לתמיכה