Goose
Goose는 하나의 JSON 파일로 정의된 커스텀 프로바이더로 UberLLM을 추가합니다.
시작하기 전에
- 크레딧이 있는 UberLLM 계정, 그리고 대시보드 → 키](
ull_...)에서 발급받은 API 키.
파일로 설정
- 이것을 Goose의
custom_providers폴더에uberllm.json로 저장하세요:- 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 이 셸에 설정되지 않았거나 잘못 입력되었습니다. |
404 "page not found" |
base_url 오타이거나 openai/gpt-5* 모델입니다 (위 참조). |
404 model_not_found |
모델 name은(는) 카탈로그 ID가 아닙니다. |
402 insufficient_credits |
잔액이 부족합니다. 대시보드 → 크레딧에서 크레딧을 추가하세요. |