문제 해결 · Zed

OpenAI 호환 모델용 Zed api_url — 커스텀 base URL과 404

language_models.openai.api_url로 Zed의 OpenAI 프로바이더를 커스텀 엔드포인트로 지정하는 방법과, /v1이 빠지거나 목록에 없는 모델 ID가 404를 만드는 이유.

표시되는 내용

zed custom openai api url

발생 원인

  • api_url에 /v1이 없습니다. Zed는 api_url 뒤에 /chat/completions 같은 API 경로를 붙이므로, 요청이 엔드포인트가 서비스하지 않는 경로로 갑니다.
  • api_url이 잘못된 설정 키 아래에 들어갔거나 오타가 있어, Zed가 조용히 기본 엔드포인트를 계속 사용합니다.
  • 엔드포인트는 맞지만 available_models의 모델 이름이 엔드포인트가 제공하지 않는 것이며, 이것이 404의 또 다른 원인입니다.

해결 방법

  • api_url을 https://router.apitoken.sale/v1로 설정하고, 나머지 경로는 Zed가 만들게 하세요.
  • 설정을 settings.json의 language_models.openai.api_url에 정확히 두세요 — 잘못된 위치의 키는 오류를 내지 않고 그냥 아무 일도 하지 않습니다.
  • 404 본문이 모델을 지목한다면 경로는 괜찮고 모델 ID가 문제입니다: 엔드포인트의 모델 목록을 확인하고 제공되는 ID를 쓰세요.

올바른 settings.json

{
  "language_models": {
    "openai": {
      "api_url": "https://router.apitoken.sale/v1"
    }
  }
}
// wrong: "api_url": "https://router.apitoken.sale"  → no /v1 in the path → 404

관련 검색어

  • zed api_url not working
  • {"error":{"message":"The requested endpoint is not supported.","type":"invalid_request_error","code":"unsupported_endpoint"}}

자주 묻는 질문

Zed api_url에 /v1을 넣어야 하나요?+
OpenAI 프로바이더라면 넣어야 합니다: https://router.apitoken.sale/v1. API 경로는 Zed가 스스로 붙이며, /v1이 없으면 그 경로가 존재하지 않아 엔드포인트가 404로 응답합니다.
커스텀 api_url이 실제로 적용됐는지 어떻게 알 수 있나요?+
요청 한 번만 일부러 망가뜨려 보세요(말도 안 되는 호스트) — 아무것도 바뀌지 않는다면 Zed가 당신이 수정한 키를 읽지 않는 것이니 설정 경로를 고치세요.
경로는 맞는데 여전히 404입니다 — 왜죠?+
404 본문이 빠진 것을 지목합니다. 모델을 지목한다면 엔드포인트가 제공하는 ID를 고르세요. GET /v1/models로 목록을 볼 수 있습니다.

잘못된 설정에 시간 낭비하지 마세요

apiToken.sale은 OpenAI 호환, Messages(Anthropic 형식), 네이티브 Gemini 엔드포인트로 GPT와 Gemini 모델을 제공합니다 — 표준 SDK, 하나의 키, 하나의 선불 잔액. 도구의 base URL만 지정하면 이 페이지의 설정이 적힌 그대로 작동합니다.