Goose
Goose adiciona UberLLM como um provedor personalizado descrito por um arquivo JSON.
Antes de começar
- Uma conta UberLLM com crédito, e uma API key de
Dashboard → Chaves (
ull_...).
Configuração com um arquivo
- Salve isso como
uberllm.jsonna pastacustom_providersdo Goose:- 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
}
- Defina a chave e inicie uma sessão:
export UBERLLM_API_KEY="ull_your-key"
goose session start --provider uberllm
Para manter a chave no chaveiro do Goose, em vez disso, abra o provedor UberLLM no Goose Desktop e insira a chave lá.
Configuração com goose configure
Vá para goose configure → Provedores Personalizados → Adicionar um Provedor Personalizado, então:
- Tipo de API:
OpenAI Compatible - Nome:
UberLLM - URL da API:
https://api.uberllm.dev/v1/chat/completions - Autenticação Necessária: Sim → Chave de API Estática → cole sua chave
- Modelos Disponíveis:
deepseek/deepseek-v4.1-flash,z-ai/glm-5.2,moonshotai/kimi-k3 - Suporte a Streaming: Sim
Modelos recomendados
Verificado em 30 de outubro de 2026: cada um respondeu e fez uma chamada de ferramenta através do UberLLM.
| Modelo | Contexto |
|---|---|
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 pode enviar openai/gpt-5* IDs para a OpenAI Responses API. UberLLM também atende essa
rota (Responses API), então esses IDs também funcionam.
Erros comuns
| O que você vê | Causa e solução |
|---|---|
401 |
UBERLLM_API_KEY não configurado neste shell, ou digitado incorretamente. |
404 "página não encontrada" |
Erro de digitação em base_url, ou um modelo openai/gpt-5* (veja acima). |
404 model_not_found |
Um name de modelo não é um ID de catálogo. |
402 insufficient_credits |
Saldo vazio. Adicione crédito em Painel → Créditos. |