Goose
Goose 添加 UberLLM 作为由一个 JSON 文件描述的自定义提供商。
开始之前
- 一个有余额的 UberLLM 账户,以及一个来自
Dashboard → 密钥 (
ull_...) 的 API key。
通过文件设置
- 将此保存为
uberllm.json在 Goose 的custom_providers文件夹中:- macOS / Linux:
~/.config/goose/custom_providers/ - Windows:
%APPDATA%\Block\goose\config\custom_providers\
- macOS / Linux:
{
"name": "uberllm",
"engine": "openai",
"display_name": "UberLLM",
"description": "DeepSeek, GLM, Kimi, Gemini, Claude, Qwen and other models through one OpenAI-compatible API key.",
"api_key_env": "UBERLLM_API_KEY",
"base_url": "https://api.uberllm.dev/v1/chat/completions",
"headers": { "x-title": "goose" },
"models": [
{ "name": "deepseek/deepseek-v4.1-flash", "context_limit": 1048576 },
{ "name": "z-ai/glm-5.2", "context_limit": 1048576 },
{ "name": "moonshotai/kimi-k3", "context_limit": 1048576 },
{ "name": "google/gemini-2.5-flash", "context_limit": 1048576 },
{ "name": "anthropic/claude-haiku-4.5", "context_limit": 200000 }
],
"supports_streaming": true,
"requires_auth": true
}
- 设置密钥并启动会话:
export UBERLLM_API_KEY="ull_your-key"
goose session start --provider uberllm
如果想将密钥保存在 Goose 的钥匙串中,请在 Goose Desktop 中打开 UberLLM 提供商并在其中输入密钥。
使用 goose configure 进行设置
运行 goose configure → 自定义提供商 → 添加自定义提供商,然后:
- API 类型:
OpenAI Compatible - 名称:
UberLLM - API URL:
https://api.uberllm.dev/v1/chat/completions - 需要认证:是 → 静态 API 密钥 → 粘贴您的密钥
- 可用模型:
deepseek/deepseek-v4.1-flash,z-ai/glm-5.2,moonshotai/kimi-k3 - 流式传输支持:是
推荐模型
在 2026年10月30日 检查:每个模型都通过 UberLLM 进行了响应并执行了工具调用。
| 模型 | 上下文 |
|---|---|
deepseek/deepseek-v4.1-flash |
1,048,576 |
z-ai/glm-5.2 |
1,048,576 |
moonshotai/kimi-k3 |
1,048,576 |
anthropic/claude-haiku-4.5 |
200,000 |
Goose 可能会发送 openai/gpt-5* 个 ID 到 OpenAI Responses API。UberLLM 也支持该路由 (Responses API),因此这些 ID 也同样有效。
常见错误
| 您看到的内容 | 原因和解决方法 |
|---|---|
401 |
UBERLLM_API_KEY 未在此 shell 中设置,或输入错误。 |
404 "页面未找到" |
base_url 拼写错误,或 openai/gpt-5* 模型(见上文)。 |
404 model_not_found |
模型 name 不是目录 ID。 |
402 insufficient_credits |
余额不足。请在仪表盘 → 信用额度下添加信用额度。 |