BroadRouter
시작하기

Zed에서 BroadNet Inference를 OpenAI 호환 제공자로 쓰기

업데이트

Zed의 settings.json에서 language_models.openai_compatible 아래에 broadnet 같은 제공자를 추가하세요. api_url은 https://inference.broadnet.ai/v1로 설정하고, available_models에는 broadnet/glm-5.3 같은 BroadNet ID를 넣은 뒤 max_tokens를 컨텍스트 크기로 지정합니다. Zed는 BROADNET_API_KEY에서 키를 읽으며, Agent Settings에 키를 저장해도 됩니다.

Zed는 에이전트가 내장된 오픈 소스 코드 에디터입니다. openai_compatible 제공자 유형으로 OpenAI 호환 API를 갖춘 서버라면 어디든 연결할 수 있습니다. BroadNet Inference는 https://inference.broadnet.ai/v1 주소에서 표준 chat completions를 제공하므로 그대로 맞습니다. BroadRouter는 BroadNet이 운영하는 사이트이며, 아래 단계는 Zed 1.28 기준 Zed API 액세스 문서를 따릅니다.

설정

  1. 키 발급. BroadNet 콘솔에서 종량제 키를 만들거나 무제한 플랜 키를 쓰세요.
  2. 제공자 추가. agent: open settings 명령으로 Agent Settings를 열고 LLM Providers 섹션에서 Add Provider를 클릭하거나, settings.json을 직접 편집하세요.
{
  "language_models": {
    "openai_compatible": {
      "broadnet": {
        "api_url": "https://inference.broadnet.ai/v1",
        "available_models": [
          {
            "name": "broadnet/glm-5.3",
            "display_name": "GLM 5.3 (BroadNet)",
            "max_tokens": 1048576,
            "max_output_tokens": 16000,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": true
            }
          },
          {
            "name": "broadnet/qwen3.8-27b",
            "display_name": "Qwen3.8 27B (BroadNet)",
            "max_tokens": 262144,
            "max_output_tokens": 16000,
            "capabilities": {
              "tools": true,
              "images": true,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": true
            }
          }
        ]
      }
    }
  }
}
  1. Zed에 키 전달. Zed를 시작하기 전에 키를 export하거나, Agent Settings의 제공자 항목에 붙여 넣으세요. 붙여 넣은 키는 settings.json이 아니라 시스템 키체인에 저장됩니다.
export BROADNET_API_KEY='your-broadnet-key'
  1. 테스트. Agent Panel을 열고 모델 선택기에서 GLM 5.3 (BroadNet) 모델을 고른 뒤, 열려 있는 파일에 대해 간단한 질문을 해 보세요. 답이 오면 연결된 것입니다.

설정 항목의 의미

  • name: Zed가 보내는 모델 ID입니다. BroadNet ID를 broadnet/ 접두사까지 정확히 쓰세요.
  • max_tokens: Zed 스키마에서는 출력 한도가 아니라 컨텍스트 윈도우입니다. GLM 5.3과 DeepSeek V4.1 Flash는 1,048,576, Qwen3.8 27B는 262,144를 쓰세요.
  • max_output_tokens: 답변 길이의 상한입니다. 위의 16,000은 저희 권장값일 뿐 BroadNet의 제한이 아닙니다. 추론도 여기에 포함되므로 낮게 잡지 마세요.
  • max_tokens_parameter: true: Zed가 출력 한도를 max_completion_tokens 대신 max_tokens로 보내게 합니다. BroadNet API 레퍼런스는 max_tokens 필드를 설명합니다.
  • images: OpenAI 호환 모델에서는 기본값이 false입니다. 이미지를 받는 모델에만 켜세요. Qwen3.8 27B, DeepSeek V4.1 Flash, BroadNet Gemma 4 VL 26B가 해당됩니다.
  • reasoning_effort: 선택 사항입니다. 추론을 짧게 하려면 BroadNet 문서는 low를 권합니다.

어떤 모델을 고를까

용도 모델 이유
도구를 쓰는 에이전트 편집 broadnet/glm-5.3 BroadNet이 도구와 구조화된 출력을 지원으로 표기, 100만 컨텍스트
스크린샷과 아랍어 텍스트 broadnet/qwen3.8-27b 도구와 이미지 입력, 262K 컨텍스트
정액 플랜으로 긴 대화 broadnet/deepseek-v4.1-flash 무제한 플랜 모델, 이미지 입력 가능, BroadNet 표기상 도구 지원 없음

Zed는 OpenAI 호환 모델에 tools: true를 가정합니다. BroadNet 문서에는 DeepSeek V4.1 Flash의 도구 호출이 나와 있지 않으므로, 의존하기 전에 실제 에이전트 작업으로 테스트하세요. Full Moon 한 달($60)을 결제하기 전에 Meteor 1시간($1)으로 저렴하게 시험해 볼 수 있습니다.

문제 해결

  • 401. 키가 틀렸거나 만료되었거나 사용 한도를 다 썼습니다. BROADNET_API_KEY를 설정했다면 그 값이 키체인보다 우선합니다. 저장된 키를 쓰려면 변수를 unset하고 Zed를 다시 시작하세요.
  • 모든 요청에서 404. api_url이 /v1로 끝나는지 확인하세요. 그다음 name이 BroadNet ID와 정확히 같은지 확인하세요. 유료 모델은 충전이 필요하며, 초기 크레딧($5 상당)으로는 broadnet/gemma-4-26b-a4b 모델과 Transcribe 모델 두 개만 쓸 수 있습니다.
  • 빈 답변. 모델이 출력 예산을 추론에 다 썼습니다. max_output_tokens를 올리거나 reasoning_effort를 low로 설정하세요. 답변이 비어서 오는 이유를 참고하세요.
  • 429. 종량제 키는 분당 요청 30개, 동시 처리 4개까지 허용합니다. 플랜 세션은 한 번에 요청 1개를 처리합니다. 오류와 재시도를 참고하세요.
  • 원격 프로젝트. Zed는 로컬 앱에서 제공자를 초기화하므로, SSH로 작업할 때 키는 원격 머신이 아니라 로컬 키체인이나 로컬 환경 변수에서 가져옵니다.

자주 묻는 질문

Zed는 커스텀 제공자 키를 어떤 환경 변수에서 읽나요?

Zed는 제공자 ID를 대문자 스네이크 케이스로 바꾸고 _API_KEY를 붙여 이름을 만듭니다. broadnet이라는 제공자는 BROADNET_API_KEY를 읽습니다. 이 변수가 비어 있지 않으면 키체인에 저장된 키보다 우선합니다.

Zed의 Agent Panel에서 BroadNet 모델이 작동하나요?

네. Zed의 API 액세스는 Zed Agent, Inline Assistant, 커밋 메시지, 스레드 요약에 적용됩니다. Zed는 OpenAI 호환 모델이 도구를 지원한다고 가정하므로, BroadNet이 도구 지원으로 표기한 GLM 5.3이나 Qwen3.8 27B를 고르세요.

이 설정이 Zed의 편집 예측(edit predictions)도 바꾸나요?

아니요. Zed 문서에 따르면 편집 예측은 edit_predictions 아래에서 제공자를 따로 설정합니다. 이 가이드의 제공자는 에이전트와 그 밖의 Zed AI 기능용입니다.

Zed에 모델이 Responses API에서만 작동한다는 메시지가 뜨는 이유는 무엇인가요?

BroadNet에서는 그런 메시지가 뜨지 않아야 합니다. capabilities.chat_completions는 기본값인 true로 두세요. BroadNet은 /v1/chat/completions를 제공하며 Responses API는 목록에 없습니다.

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