KO ▾
API 키 받기

uncensoredqwen.com가이드

VS Code용 Qwen API 키: 사용자 지정 엔드포인트 설정

VS Code용 Qwen API 키를 사용하려면 Alibaba 전용 플러그인이 필요하지 않습니다. OpenAI 호환 공급자를 지원하는 모든 확장 프로그램은 Base URL, 키, 모델 이름 세 가지 값을 받습니다. 이 가이드는 정확한 값과 일반적인 실수를 잡는 확인 방법을 제공합니다.

업데이트

서버에 연결된 엔드포인트 소켓에 황금 열쇠가 꽂힌 입체적 코드 편집기 패널

VS Code 열기 전에 필요한 항목

VS Code용 qwen API 키는 확장 프로그램의 올바른 엔드포인트 설정이 추가된 API 키에 불과합니다. 먼저 다음 세 가지 값을 수집하세요:

  • Base URL: https://api.uncensoredqwen.com/v1
  • 모델 ID: uncensored
  • API 키: Google 또는 이메일과 비밀번호로 가입한 후 API 키 페이지에서 생성됩니다.

새 계정은 해당 페이지에서 한 번의 클릭으로 $0.50의 체험 크레딧을 청구할 수 있습니다. 카드는 필요 없으며, 인원당 하나만 제한되며 7일 동안 유효합니다. 이는 며칠 동안 실제 코딩을 위한 편집기 설정을 테스트하기에 충분합니다.

명칭에 대한 참고: 이 서비스는 독립적인 공급자가 실행하는 호스팅된 오픈 웨이트 모델입니다. Alibaba의 공식 API가 아니며 다른 벤더로 라우팅하는 기능이 아닙니다. 편집기에서는 지정한 표시 이름으로 표시됩니다.

먼저 curl로 키 테스트하기

편집기 설정을 변경하기 전에 키와 URL이 개별적으로 작동하는지 확인하세요. 실패하면 어떤 확장 프로그램도 성공하지 못하며, 문제가 플러그인이 아니라 키에 있음을 알 수 있습니다.

export API_KEY="paste-your-key-here"

curl https://api.uncensoredqwen.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

uncensored가 포함된 JSON 목록은 인증이 작동함을 의미합니다. 그런 다음 실제 응답 요청을 하나 보내세요:

curl https://api.uncensoredqwen.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python function that reverses a string."}],"max_tokens":200}'

응답 헤더에는 X-Balance-USD가 포함되어 있어 터미널을 떠나지 않고도 남은 크레딧을 빠르게 확인할 수 있습니다.

VS Code 확장 프로그램에 공급자 추가

AI 코드 지원을 위한 여러 VS Code 확장 프로그램은 모든 OpenAI 호환 서버와 통신할 수 있습니다. 레이블은 도구마다 약간 다르지만 필드는 일대일로 매핑됩니다. "OpenAI 호환", "OpenAI" (사용자 지정 베이스 URL 포함) 또는 "사용자 지정 엔드포인트"와 같은 이름의 공급자 선택을 찾아보세요.

확장 프로그램 필드입력할 값
제공업체OpenAI 호환 (또는 사용자 지정 베이스 URL이 있는 OpenAI)
베이스 URL / API 기본 URLhttps://api.uncensoredqwen.com/v1
API 키계정의 키
모델 IDuncensored

JSON 구성 파일을 읽는 확장 프로그램은 일반적으로 다음과 같은 형식을 원합니다. 정확한 키 이름은 다르므로 확장 프로그램의 문서를 확인하고 필드 이름을 조정하세요:

{
  "models": [
    {
      "title": "Uncensored API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.uncensoredqwen.com/v1",
      "apiKey": "paste-your-key-here"
    }
  ]
}

이 파일을 커밋하지 마세요. 설정이 저장소 내에 있는 경우 확장 프로그램의 비밀 저장소 또는 환경 변수를 사용하고 구성 경로를 .gitignore에 추가하세요.

저장한 후 확장 프로그램의 채팅 패널을 열고 파일이 열린 상태에서 "이 함수를 설명하세요"와 같은 짧은 메시지를 보내세요. 스트리밍된 답변이 표시되면 설정이 완료된 것입니다.

일반적인 구성 오류 수정

대부분의 실패한 설정은 몇 가지 오타 때문입니다. 다음 목록을 순서대로 확인하세요.

URL의 형식이 잘못되었습니다.

Base URL은 /v1에서 끝납니다. 확장 프로그램은 /chat/completions을 자체적으로 추가합니다. 전체 경로를 붙여넣으면 클라이언트가 /v1/chat/completions/chat/completions을 요청하므로 404 오류가 발생합니다. 후행 슬래시는 일반적으로 문제가 없지만, /v1이 누락되면 문제가 됩니다.

모델 이름이 잘못되었습니다.

일부 확장 프로그램은 다른 서비스의 이름으로 모델 드롭다운을 미리 채웁니다. uncensored로 정확히 덮어씁니다. 대소문자를 구분합니다. 커스텀 항목이 없는 드롭다운인 경우 "custom model" 또는 "other" 옵션을 찾아보세요.

키에 불필요한 문자가 있습니다.

웹 페이지에서 복사하면 끝에 공백이나 줄바꿈이 추가될 수 있습니다. 일반 텍스트 편집기에 붙여넣고 trim한 후 다시 붙여넣으세요. 401 응답은 거의 항상 이를 가리키거나 다른 계정의 키 때문일 수 있습니다.

확장 프로그램이 여전히 기본 서버와 통신합니다.

채팅 요청 후 잔액이 변경되지 않으면 편집기가 내장 공급자를 사용하고 있을 수 있습니다. 편집한 모델 프로필이 활성화되어 있는지 확인하고 설정 변경 후 창을 다시 로드하세요.

요청이 429로 실패합니다

이것은 다음 섹션에서 다루는 속도 제한입니다. 오류 본문에는 어떤 제한에 도달했는지 나타내는 코드가 포함되어 있습니다.

요청이 API에 실제로 도달하는지 확인

편집기는 일반적으로 어떤 서버가 응답했는지 알려주지 않습니다. 두 가지 빠른 확인으로 의심을 없애세요.

  1. 잔액을 확인하세요. 터미널에서 /v1/models 또는 짧은 completion 호출을 실행하고, X-Balance-USD 헤더를 확인한 후 편집기에서 세 개의 채팅 메시지를 보내고 터미널 호출을 반복하세요. 숫자가 약간 감소해야 합니다. 동일한 값은 GET /v1/balance에서 확인할 수 있습니다.
  2. 기본 설정이 거부하거나 다르게 처리할 항목을 요청하세요. 작고 무해한 테스트로 정확히 다섯 단어로 된 답변을 요청하세요. 답변이 지시를 따르고 스트리밍으로 도착하면 연결이 정상입니다.

잔액이 움직이지 않으면 확장 프로그램의 출력 패널이나 개발자 콘솔을 여세요. 대부분의 확장 프로그램은 요청 URL과 HTTP 상태 코드를 로깅하며, 잘못된 호스트는 즉시 표시됩니다. Base URL을 수정하고 창을 다시 로드한 후 다시 시도하세요.

저장소를 공유하는 팀은 하나의 공유 값 대신 각 사람에게 별도의 키를 제공해야 합니다. 이렇게 하면 한 사람이 속도 제한에 도달하더라도 다른 사람이 차단되지 않으며, 유출된 키를 다른 사람에게 영향을 주지 않고 교체할 수 있습니다.

자동 완성, 채팅 및 속도 제한

채팅은 제한에 관대합니다: 메시지당 하나의 요청. 인라인 자동 완성은 다릅니다. 많은 확장 프로그램은 입력 중 짧은 일시 정지 시 요청을 보내며, 작업 중 분당 수십 번의 호출을 생성할 수 있습니다.

숫자를 이해하세요. 전체 키는 동시 요청 8개와 분당 300개 요청을 허용합니다. 체험 키는 동시 2개, 분당 60개를 허용합니다. 초과 시 API는 HTTP 429를 반환하며 rate_limited(분당 초과) 또는 concurrency(동시 초과) 오류가 발생합니다. 일시적 과부하 시 Retry-After: 5 헤더와 함께 429도 반환합니다. 스트리밍된 응답은 스트림이 끝날 때까지 동시성 슬롯을 유지하므로, 느린 스트림은 더 오래 점유합니다.

도움이 되는 실제 설정:

  • 무료 체험 키 동안 채팅, 수정 및 설명에 서비스를 사용하고 탭 자동 완성을 끄거나 디바운스 지연 시간을 높이세요.
  • 자동 완성의 최대 출력 토큰 수를 수십 개로 낮추세요. 짧은 완성은 빠르게 완료되어 슬롯을 해제합니다.
  • 무료 체험 기간 중 동일한 키로 여러 편집기 창을 실행하지 마세요.

실패하거나 거부된 요청은 요금이 부과되지 않으므로 오류는 시간만 소모할 뿐 비용은 들지 않습니다.

코딩 세션 비용

코딩 프롬프트는 확장 프로그램이 파일 내용을 첨부하기 때문에 입력량이 많습니다. 가격은 1M 입력 토큰당 $0.15, 1M 출력 토큰당 $0.50입니다. 코드와 컨텍스트 6,000 토큰을 보내고 800 토큰을 받아오는 채팅 한 턴을 고려해 보세요:

  • 입력: 6,000 x $0.15 / 1,000,000 = $0.0009
  • 출력: 800 x $0.50 / 1,000,000 = $0.0004
  • 총합: 턴당 $0.0013

작업일 중 100번의 전환 시 $0.13입니다. $0.50 체험금은 이 크기의 약 380번의 전환을 커버합니다($0.50 / $0.0013은 약 385). 크레딧은 선불이며, 만료되지 않으며, 충전은 $20에서 $500까지 정수 금액으로 이루어지며, $50부터 5%, $100부터 10%, $200부터 15%의 보너스가 제공됩니다. 가격 책정 페이지에서 결제 방법을 확인하세요.

컨텍스트 창은 100,000 토큰이며, 프롬프트와 생성을 포함합니다. 확장 프로그램이 전체 리포지토리를 각 프롬프트에 인덱싱하면 큰 요청은 더 많은 비용이 발생하며 그 한계에 가까워집니다. 실제로 필요한 파일로 컨텍스트 범위를 좁히세요.

개인정보 및 더 많은 정보

프롬프트는 학습에 사용되지 않습니다. 그러나 소스 코드에는 종종 시크릿이 포함되어 있으므로 채팅에 첨부하는 파일에서 .env 파일과 자격 증명을 제외하세요. 대부분의 확장 프로그램은 컨텍스트에서 경로를 제외할 수 있습니다.

모델은 텍스트 전용입니다. 코딩 질문에 답변하고 함수를 작성하며 오류를 설명하고 함수 호출 및 JSON 모드를 지원하지만 이미지, 오디오 또는 비디오를 생성하지 않습니다. 이 페이지를 넘어 요청 필드와 예제를 보려면 API 문서를 읽으세요. 위의 확인 후에도 여전히 실패하는 경우, 일반적인 Qwen API 오류에 대한 이전 기사가 더 많은 오류 패턴과 수정 사항을 나열합니다.

질문과 답변

VS Code용 Qwen API 키는 어떻게 받나요?

사이트에서 회원가입하고 API 키 페이지를 열어 키를 생성하세요. 카드 없이도 해당 페이지에서 한 번의 클릭으로 $0.50 체험 크레딧을 청구할 수 있습니다.

확장 프로그램에 어떤 Base URL을 입력해야 하나요?

https://api.uncensoredqwen.com/v1을 사용하고 /chat/completions을 생략하세요. 모델 ID는 uncensored입니다.

확장 프로그램에서 401이 반환되는 이유는 무엇인가요?

키가 일반적으로 잘못되었거나 불필요한 공백이 있거나 다른 계정에 속해 있습니다. 다시 복사하여 /v1/models에 대한 curl 호출로 테스트하세요.

탭 자동 완성용으로 사용할 수 있나요?

OpenAI 호환 자동 완성 설정을 통해 작동하지만 빈번한 요청은 분당 60개의 체험 한도에 도달할 수 있습니다. 전체 키는 분당 300개를 허용합니다.

키는 양식 하나만 작성하면 받을 수 있습니다

계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.

API 키 받기