Goose
Goose는 하나의 JSON 파일로 정의된 커스텀 프로바이더로 MartLLM을 추가합니다.
가장 빠른: 한 번의 명령으로
npx uberllm init --tool goose
이것은 브라우저에서 계정을 연결하고, 귀하만 읽을 수 있는 파일에 키를 저장하며, 제공자 파일 ~/.config/goose/custom_providers/uberllm.json을(를) 작성합니다. 파일은 먼저 백업되며, npx uberllm init --undo가(이) 다시 되돌려 놓습니다. 자세한 내용은: uberllm init. 수동으로 수행하는 단계는 아래에 있습니다.
시작하기 전에
- 크레딧이 있는 MartLLM 계정, 그리고 대시보드 → 키](
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": "MartLLM",
"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.martllm.com/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에서 MartLLM 제공자를 열고 거기에 키를 입력하세요.
goose configure로 설정
goose configure을(를) 실행한 다음 → 사용자 지정 공급자 → 사용자 지정 공급자 추가를 선택하세요:
- API 유형:
OpenAI Compatible - 이름:
MartLLM - API URL:
https://api.martllm.com/v1/chat/completions - 인증 필요: 예 → 정적 API 키 → 키를 붙여넣으세요
- 사용 가능한 모델:
deepseek/deepseek-v4.1-flash,z-ai/glm-5.2,moonshotai/kimi-k3 - 스트리밍 지원: 예
추천 모델
2026년 10월 30일 확인됨: 각 모델이 MartLLM을 통해 응답하고 도구 호출을 수행했습니다.
| 모델 | 컨텍스트 |
|---|---|
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로 보낼 수 있습니다. MartLLM도 해당 경로를 제공하므로 (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 |
잔액이 부족합니다. 대시보드 → 크레딧에서 크레딧을 추가하세요. |