BroadRouter

goose에 BroadNet Inference를 커스텀 제공자로 추가하기

업데이트

goose에서 유형이 OpenAI Compatible인 커스텀 제공자를 추가하고, API URL은 https://inference.broadnet.ai/v1/chat/completions, 키는 BroadNet 키, 사용 가능 모델은 broadnet/glm-5.3 등으로 지정하세요. goose Desktop의 Add Custom Provider 버튼, 터미널의 goose configure, 또는 ~/.config/goose/custom_providers/ 안의 JSON 파일을 쓰면 됩니다. goose는 도구 호출에 의존하므로 GLM 5.3이나 Qwen3.8 27B로 시작하세요.

goose는 데스크톱 앱과 CLI를 갖춘 오픈 소스 AI 에이전트입니다. 기본 내장되지 않은 서비스는 커스텀 제공자로 추가하며, goose는 OpenAI 호환 제공자를 지원합니다. BroadNet Inference는 표준 chat completions를 제공하므로 이 방식으로 연결됩니다. BroadRouter는 BroadNet이 운영하는 사이트이며, 아래 단계는 goose 1.59 기준 goose 제공자 문서를 따릅니다.

goose 문서는 goose가 “extensively uses tool calling”(번역: 도구 호출을 광범위하게 사용함)이라고 경고하며, 도구 호출이 없는 모델은 모든 확장을 끈 상태에서 채팅만 할 수 있다고 설명합니다. BroadNet은 도구 호출을 GLM 5.3과 Qwen3.8 27B에 표기하므로, 에이전트 작업에는 둘 중 하나를 쓰세요.

방법 1: goose Desktop

  1. 사이드바를 열고 Settings를 클릭한 다음 Models 탭으로 가세요.

  2. Configure providers를 클릭하고, 아래쪽의 Add Custom Provider를 클릭하세요.

  3. 세부 정보를 입력하세요.

    필드 값
    Provider Type OpenAI Compatible
    Display Name BroadNet Inference
    API URL https://inference.broadnet.ai/v1/chat/completions
    API Key BroadNet 키
    Available Models broadnet/glm-5.3, broadnet/qwen3.8-27b
    Streaming Support 켬
  4. Create Provider를 클릭한 뒤, 이 제공자와 모델을 선택하세요.

방법 2: goose CLI

goose configure를 실행하고 Custom Providers, 이어서 Add A Custom Provider를 고른 뒤, 프롬프트에 같은 값을 입력하세요. API 유형은 OpenAI Compatible, API URL은 위와 같고, 인증은 Yes로 해서 고정 API 키를 쓰며, 모델 목록은 쉼표로 구분하고, 스트리밍은 켭니다.

방법 3: JSON 파일

~/.config/goose/custom_providers/broadnet.json 파일을 만드세요(Windows에서는 %APPDATA%\Block\goose\config\custom_providers\ 폴더).

{
  "name": "broadnet",
  "engine": "openai",
  "display_name": "BroadNet Inference",
  "description": "BroadNet Inference, OpenAI-compatible",
  "api_key_env": "BROADNET_API_KEY",
  "base_url": "https://inference.broadnet.ai/v1/chat/completions",
  "models": [
    { "name": "broadnet/glm-5.3", "context_limit": 1048576 },
    { "name": "broadnet/qwen3.8-27b", "context_limit": 262144 },
    { "name": "broadnet/deepseek-v4.1-flash", "context_limit": 1048576 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

그다음 이 제공자로 세션을 시작하세요.

export BROADNET_API_KEY='your-broadnet-key'
goose session start --provider broadnet

키는 환경 변수에만 있으므로, 이 파일은 팀용 저장소에 그대로 넣어도 됩니다.

테스트

“what can you do?” 같은 간단한 질문부터 해 보세요. 답이 오면 연결이 된 것입니다. 그다음 켜 둔 확장 중 하나가 필요한 작업을 요청하세요. goose가 도구를 호출하면 도구 호출도 작동하는 것입니다. 텍스트로만 답하고 도구를 전혀 호출하지 않는다면 broadnet/glm-5.3 모델로 바꾸세요.

goose의 가격 표시

JSON 파일의 각 모델에 토큰당 USD 단위의 input_token_cost와 output_token_cost가 있으면 goose가 비용을 추정할 수 있습니다. BroadNet 가격 페이지의 100만 토큰당 가격을 1,000,000으로 나눈 값을 넣으세요. 두 필드가 모두 없으면 goose는 자체 카탈로그 가격을 쓰는데, 이 값은 BroadNet 가격과 다를 수 있습니다.

문제 해결

  • 401. 키가 틀렸거나 만료되었거나 사용 가능 금액이 소진되었습니다. 또는 goose를 실행하는 셸에 BROADNET_API_KEY가 설정되지 않았습니다.
  • 404. API URL이 https://inference.broadnet.ai/v1/chat/completions 형태인지 확인하세요. 모델 ID가 BroadNet ID와 정확히 일치하는지도 확인하세요. 유료 모델은 충전이 필요하며, 초기 크레딧($5 상당)으로는 broadnet/gemma-4-26b-a4b 모델과 Transcribe 모델 두 개만 쓸 수 있으며, Gemma의 32,768 토큰 컨텍스트는 에이전트 작업에는 작습니다.
  • 빈 답변. DeepSeek V4.1 Flash, GLM 5.3, Qwen3.8 27B에서는 추론도 출력 한도에 포함됩니다. 답변이 비어서 오는 이유를 참고하세요.
  • 429. 종량제 키는 분당 30 요청, 동시 처리 4 건까지 허용합니다. 오류와 재시도를 참고하세요.
  • 플랜 키 하나로 goose 세션 두 개를 돌리면 요청이 대기하거나 실패함. 플랜 세션은 한 번에 요청 하나만 처리하므로, goose 세션마다 별도의 플랜 세션을 쓰세요.

자주 묻는 질문

goose의 API URL은 /v1로 끝나야 하나요, /v1/chat/completions로 끝나야 하나요?

goose의 커스텀 제공자 예시가 chat completions 전체 URL을 쓰므로 https://inference.broadnet.ai/v1/chat/completions를 쓰세요. 그래야 goose가 BroadNet이 제공하는 chat completions를 계속 사용합니다.

goose에는 어떤 BroadNet 모델이 가장 잘 맞나요?

GLM 5.3(broadnet/glm-5.3)입니다. goose 문서는 goose가 도구 호출을 많이 쓴다고 하며, BroadNet은 도구를 GLM 5.3과 Qwen3.8 27B에만 표기합니다.

BroadNet 무제한 플랜으로 goose를 쓸 수 있나요?

플랜은 DeepSeek V4.1 Flash만 제공하며, BroadNet 문서에는 이 모델의 도구 호출이 표기되어 있지 않습니다. goose는 도구 호출이 없는 모델은 확장을 모두 끈 상태에서 채팅만 할 수 있다고 하므로, 한 달 플랜을 사기 전에 테스트해 보세요.

goose는 API 키를 어디에 저장하나요?

시스템 키체인에 저장하며, 키링이 꺼져 있으면 secrets.yaml에 저장합니다. JSON 파일 방식에서는 api_key_env에 지정한 환경 변수에서 키를 읽습니다.

Markdown으로 읽기ChatGPT에 질문하기Claude에 질문하기Perplexity에 질문하기