教程 / LLM 端点
LLM 端点配置
LLM 端点是 OpenAkita 调用大语言模型的入口。你可以配置多个端点,系统会根据优先级和可用性自动选择。
一、LLM 端点配置
本节介绍在 OpenAkita Desktop 中查看与管理 LLM 端点入口。
添加 LLM 端点
1. 添加 LLM 端点:
- 点击「+ 添加端点」按钮,打开端点配置对话框
- 选择服务商
- 填写 API Key(若无 API Key,可以点击「获取 API Key」)
- 拉取模型列表,选择模型
- 选择模型的能力
- 点击「添加端点」
| 字段 | 说明 | 示例 |
|---|---|---|
| 服务商 | 选择 LLM 服务提供商 | 通义千问、OpenAI、Anthropic 等 |
| Base URL | API 接口地址(选择服务商后自动填充) | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| API Key | 你的 API 密钥 | sk-xxxxx |
| 模型 | 选择或输入模型名称(支持在线拉取模型列表) | qwen-max、gpt-4o |
| 端点名称 | 自动生成,也可自定义 | dashscope-qwen-max |
| 能力标签 | 勾选该模型支持的能力 | text、thinking、vision、tools |
高级参数(点击展开):
| 字段 | 默认值 | 说明 |
|---|---|---|
| API Type | openai | 接口类型,openai 或 anthropic |
| Key 环境变量名 | 自动生成 | API Key 在 .env 中的变量名 |
| 优先级 | 0 | 数值越小优先级越高 |
支持的服务商
国内服务商
| 服务商 | API 类型 | 默认 Base URL |
|---|---|---|
| 通义千问(DashScope) | openai | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| 智谱 AI | openai | https://open.bigmodel.cn/api/paas/v4 |
| 百度千帆 | openai | https://qianfan.baidubce.com/v2 |
| DeepSeek | openai | https://api.deepseek.com/v1 |
| 月之暗面(Kimi) | openai | https://api.moonshot.cn/v1 |
| 零一万物 | openai | https://api.lingyiwanwu.com/v1 |
| 字节豆包(火山引擎) | openai | https://ark.cn-beijing.volces.com/api/v3 |
| SiliconFlow | openai | https://api.siliconflow.cn/v1 |
国际服务商
| 服务商 | API 类型 | 默认 Base URL |
|---|---|---|
| OpenAI | openai | https://api.openai.com/v1 |
| Anthropic | anthropic | https://api.anthropic.com |
| Google Gemini | openai | https://generativelanguage.googleapis.com/v1beta/openai |
| Groq | openai | https://api.groq.com/openai/v1 |
| Mistral | openai | https://api.mistral.ai/v1 |
| OpenRouter | openai | https://openrouter.ai/api/v1 |
多端点与 Failover
OpenAkita 支持配置多个端点,提供自动故障转移能力:
- 优先级调度:优先使用 Priority 值最小的端点
- 自动降级:主端点不可用时自动切换到备用端点
- 健康检查:后台定期检测端点可用性
- 冷却机制:连续失败的端点会被临时冷却,避免反复重试
建议:至少配置 2 个端点(不同服务商),以确保高可用性。
编译器端点(可选)
编译器端点用于代码编译、格式化等辅助任务,如果不配置,系统会使用主端点。
语音识别端点(可选)
用于在线语音识别,支持 OpenAI Whisper / DashScope Qwen-ASR / Groq / SiliconFlow 等。