docs
Редакторлар және IDE

gptel

Markdown

Emacs пакеті · OpenAI Chat, Anthropic Messages, Gemini

Толық нұсқаулық
ФорматҚайда баптау керек
OpenAI Chat, Anthropic Messages, Geminiinit.el: бэкендті 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, қолданба мұны қолдаса.

Іске қоспас бұрын Ailoot кілтіңізбен GET /v1/models сұрауын жіберіңіз. Әдістері POST /v1/chat/completions, POST /v1/messages, POST /v1beta/models/{model}:generateContent қамтитын нақты модель ID мәнін таңдап, баптауда қолданыңыз. Агенттер үшін клиент нұсқасына қажетті құралдар мен мүмкіндіктердің қолдауын да тексеріңіз.

(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 мен сипаттаманы жіберіңіз — мәселені анықтауға көмектесеміз.Қолдау қызметіне жазу