문제 해결 · Zed

Zed 401 Invalid API Key — OpenAI 프로바이더 설정 해결

Zed 어시스턴트는 엔드포인트의 401을 그대로 전달합니다. Zed에서 OpenAI 프로바이더의 키와 api_url이 어디에 있는지, 왜 같은 발급처의 것이어야 하는지.

표시되는 내용

HTTP 401
{"error":{"message":"Invalid or missing API key.","type":"invalid_request_error","param":null,"code":"invalid_api_key"}}

발생 원인

  • Zed의 OpenAI 프로바이더 설정에 있는 키와 api_url이 서로 다른 발급처를 가리킵니다 — 게이트웨이 키가 기본 api.openai.com으로 가거나 그 반대입니다.
  • 키를 붙여넣을 때 공백이 들어갔거나 잘렸습니다.
  • Zed를 실행한 환경에 다른 프로바이더의 OPENAI_API_KEY 환경 변수가 설정되어 있어, Zed가 기대한 키 대신 그 키를 보냅니다.
  • 키가 폐기되었거나 만료되었습니다.

해결 방법

  • language_models.openai.api_url을 https://router.apitoken.sale/v1로 설정하고, 어시스턴트의 OpenAI 프로바이더 설정에 그 발급처의 키를 입력하세요.
  • api_url은 /v1로 끝나게 두세요 — API 경로는 Zed가 스스로 붙입니다.
  • 다른 것을 바꾸기 전에 정확한 짝을 curl로 확인하세요.

이 게이트웨이용 Zed settings.json

{
  "language_models": {
    "openai": {
      "api_url": "https://router.apitoken.sale/v1",
      "available_models": [{ "name": "gpt-6.1-terra", "display_name": "GPT-6.1 Terra", "max_tokens": 872000 }]
    }
  }
}

관련 검색어

  • zed openai api key not working
  • zed 401 unauthorized

자주 묻는 질문

Zed는 OpenAI base URL을 어디에 보관하나요?+
settings.json의 language_models.openai.api_url 아래입니다. API 키 자체는 어시스턴트의 프로바이더 설정에서 입력합니다.
제 키가 curl에서는 되는데 Zed에서는 안 되는 이유는?+
Zed는 설정된 api_url로 키를 보냅니다. 그것이 curl로 호출하는 URL과 다르면, 키를 받는 엔드포인트는 그 키를 발급한 곳이 아닙니다.
Zed에서 GPT 모델을 쓰려면 OpenAI 계정이 필요한가요?+
아니요 — OpenAI 호환 엔드포인트라면 무엇이든 됩니다: api_url을 발급처로 설정하고, 그 키를 쓰고, available_models에 모델을 나열하세요.

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

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