BroadRouter
시작하기

Kilo Code에서 BroadNet Inference 쓰기(OpenAI Compatible 제공자)

업데이트

Kilo Code에서 Settings를 열고 Providers로 가서 Custom provider를 클릭하세요. Provider API는 OpenAI Compatible, Base URL은 https://inference.broadnet.ai/v1로 정하고 BroadNet 키를 붙여 넣은 뒤, broadnet/glm-5.3 같은 모델 ID를 직접 추가합니다. kilo.json에서는 npm에 @ai-sdk/openai-compatible을, options.baseURL을 지정하고 limit.context와 limit.output을 설정하세요.

Kilo Code는 VS Code와 터미널에서 쓰는 오픈 소스 코딩 에이전트입니다. OpenAI Chat Completions API를 갖춘 제공자라면 무엇이든 커스텀 제공자로 추가할 수 있습니다. BroadNet Inference는 https://inference.broadnet.ai/v1 주소에서 이 형식을 제공합니다. BroadRouter는 BroadNet이 운영하는 사이트이며, 이 가이드는 2026년 11월 15일 기준 Kilo 제공자 문서를 따릅니다.

VS Code에서 설정

  1. 키를 받습니다. BroadNet 콘솔에서 종량제 키를 만들거나, 무제한 플랜 키를 쓰세요.

  2. Settings(톱니바퀴 아이콘)를 열고 Providers 탭으로 가세요.

  3. 맨 아래로 스크롤해 Custom provider를 클릭하세요.

  4. 대화 상자를 채우세요.

    필드 값
    Provider ID broadnet
    Display name BroadNet Inference
    Provider API OpenAI Compatible
    Base URL https://inference.broadnet.ai/v1
    API key BroadNet 키
    Models broadnet/glm-5.3 직접 추가(아래 참고)
  5. Submit을 클릭하세요. 모델 선택기에 모델이 나타납니다.

  6. 테스트합니다. “explain this file” 같은 작업을 시작해 보세요. 답이 오면 연결이 된 것입니다.

Kilo는 엔드포인트의 /v1/models에서 모델 목록을 채우려고 합니다. BroadNet 문서는 이 엔드포인트를 모니터링용 카탈로그 메타데이터라고 설명하며, 2026년 11월 15일에 확인했을 때는 전사 모델 두 개만 나열되어 있었습니다. 채팅 모델 ID는 직접 입력하고, 전사 모델은 고르지 마세요.

kilo.json에서 설정(CLI용, 또는 한도와 도구 플래그 지정용)

Kilo의 대화 상자에서는 토큰 한도나 도구 호출을 설정할 수 없습니다. Kilo 문서는 이를 위해 설정 파일을 쓰라고 안내합니다. 위치는 ~/.config/kilo/kilo.json이거나, 프로젝트 안의 ./kilo.json입니다.

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "broadnet/glm-5.3",
  "provider": {
    "broadnet": {
      "npm": "@ai-sdk/openai-compatible",
      "env": ["BROADNET_API_KEY"],
      "options": {
        "baseURL": "https://inference.broadnet.ai/v1"
      },
      "models": {
        "glm-5.3": {
          "id": "broadnet/glm-5.3",
          "name": "GLM 5.3",
          "tool_call": true,
          "reasoning": true,
          "limit": { "context": 1048576, "output": 16000 }
        },
        "qwen3.8-27b": {
          "id": "broadnet/qwen3.8-27b",
          "name": "Qwen3.8 27B",
          "tool_call": true,
          "reasoning": true,
          "modalities": { "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 262144, "output": 16000 }
        },
        "deepseek-v4.1-flash": {
          "id": "broadnet/deepseek-v4.1-flash",
          "name": "DeepSeek V4.1 Flash",
          "reasoning": true,
          "limit": { "context": 1048576, "output": 16000 }
        }
      }
    }
  }
}
export BROADNET_API_KEY='your-broadnet-key'
  • 최상위 model 값인 broadnet/glm-5.3은 제공자 이름에 맵 키(glm-5.3)를 붙인 것이며, BroadNet ID가 아닙니다. id 필드는 Kilo가 BroadNet에 보내는 모델 ID입니다. Kilo 문서에 따르면 id의 기본값은 맵 키이므로, 여기처럼 짧은 키를 쓰는 등 키가 BroadNet ID 전체와 다를 때는 언제나 id를 지정하세요.
  • limit.context와 limit.output은 항상 설정하세요. Kilo 문서에 따르면 카탈로그에 일치하는 항목이 없는 커스텀 모델은 둘 다 0으로 처리되어 자동 컨텍스트 관리가 꺼집니다. 출력값 16,000은 저희가 제안하는 값으로, 추론에 쓸 여유를 남깁니다.
  • DeepSeek V4.1 Flash에는 일부러 tool_call을 넣지 않았습니다. BroadNet 문서에 이 모델의 도구 호출이 표기되어 있지 않기 때문입니다. 직접 테스트한 뒤에 추가하세요.

어떤 모델을 고를까

작업 모델 참고
도구를 쓰는 에이전트 코딩 GLM 5.3 도구와 구조화된 출력 표기, 100만 컨텍스트
스크린샷, 아랍어 Qwen3.8 27B 도구와 이미지, 262K 컨텍스트
긴 세션, 정액 요금 DeepSeek V4.1 Flash 무제한 플랜, BroadNet 도구 미표기

Full Moon 한 달($60)을 사기 전에 Meteor 1시간($1)으로 무제한 플랜을 먼저 써 보세요.

문제 해결

  • “Invalid API Key” 또는 401. 키를 다시 붙여 넣으세요. 키에 사용 가능 금액이 남아 있는지, Kilo를 실행하는 프로세스에 BROADNET_API_KEY가 설정되어 있는지 확인하세요.
  • “Model Not Found”. ID가 broadnet/ 접두사를 포함해 BroadNet ID와 정확히 일치하는지 확인하세요. 유료 모델은 충전이 필요하며, 초기 크레딧($5 상당)으로는 broadnet/gemma-4-26b-a4b 모델과 Transcribe 모델 두 개만 쓸 수 있습니다.
  • 빈 답변 또는 “response may be incomplete”. Kilo는 추론 모델이 출력 전체를 추론에 써 버리면 이 경고를 띄웁니다. limit.output을 늘리세요. 답변이 비어서 오는 이유를 참고하세요.
  • 429. 종량제 키는 분당 30 요청, 동시 처리 4 건까지 허용합니다. 오류와 재시도를 참고하세요.
  • 플랜 키에서 병렬 서브에이전트가 대기하거나 실패함. 플랜 세션은 한 번에 요청 하나만 처리하므로, 병렬 서브에이전트마다 별도의 세션을 쓰세요.
  • 연결 오류. Base URL은 /v1로 끝나야 합니다. 키에 IP 허용 목록이 설정되어 있다면 사용 중인 컴퓨터의 주소를 추가하세요.

자주 묻는 질문

Base URL을 입력해도 Kilo Code에 BroadNet 채팅 모델이 나오지 않는 이유는 무엇인가요?

Kilo는 엔드포인트의 /v1/models 목록에서 모델을 가져옵니다. 2026년 11월 15일에 확인했을 때 BroadNet의 공개 /v1/models에는 전사 모델 두 개만 있었으므로, 채팅 모델 ID를 직접 추가하세요.

BroadNet 모델의 limit.context는 얼마로 설정해야 하나요?

GLM 5.3과 DeepSeek V4.1 Flash는 1048576, Qwen3.8 27B는 262144, BroadNet Gemma 4 VL 26B는 32768입니다. Kilo 문서에 따르면 커스텀 모델에서 limit이 없으면 0으로 처리되어 자동 컨텍스트 관리가 꺼집니다.

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

네. 플랜은 DeepSeek V4.1 Flash(ID broadnet/deepseek-v4.1-flash)를 제공합니다. 플랜 키를 API 키로 쓰세요. BroadNet 문서에는 이 모델의 도구 호출이 표기되어 있지 않으므로, 에이전트 작업을 먼저 테스트해 보세요.

Provider API는 OpenAI Compatible과 OpenAI Responses 중 무엇을 골라야 하나요?

OpenAI Compatible입니다. BroadNet은 /v1/chat/completions에서 chat completions를 제공하며, Responses API는 표기하지 않습니다.

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