DeepSeek API 키 작동 안 함: 원인 및 해결법

한 줄 테스트로 시작하세요

앱에서 변경하기 전에 클라이언트를 제외하세요. 단일 curl 호출은 키, URL 및 모델 이름이 함께 작동하는지 알려줍니다. 제공업체 대시보드 및 문서의 값으로 자리 표시자를 바꾸세요.

Copycurl -i https://YOUR-PROVIDER/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR-MODEL","messages":[{"role":"user","content":"ping"}]}'

-i 플래그는 상태 행과 헤더를 출력하며, 본문보다 이 두 가지가 더 중요합니다. curl은 작동하지만 앱이 작동하지 않으면 문제는 앱 설정에 있습니다. curl도 실패하면 문제는 키, 계정 또는 엔드포인트에 있습니다.

먼저 상태 코드를 읽으세요

이것은 OpenAI 스타일 제공업체 전반의 일반적인 의미입니다. 각 제공업체는 자체 정확한 코드를 문서화하므로 세부 정보는 최신 문서를 확인하세요.

키 자체

키는 긴 문자열이며 지루한 방식으로 끊어질 수 있습니다. 키를 일반 텍스트 편집기에 붙여넣고 뒤따르는 공백이나 줄바꿈, 시작 따옴표, 채팅 앱이 추가한 줄바꿈이 있는지 확인하세요. 헤더가 Authorization: Bearer KEY로 되어 있고 Bearer 뒤에 단일 공백이 있는지 확인하세요. 키를 환경 변수에 설정한 경우, 앱에서 키의 길이를 출력하여(값이 아닌) 로드되었는지 확인하세요.

두 가지 다른 경우가 흔합니다. 첫째, 키를 생성하고 페이지를 닫은 후 마스킹된 버전을 복사했습니다. 대부분의 대시보드는 키를 한 번만 표시하므로 새 키를 생성하세요. 둘째, 한 서비스의 키를 다른 서비스의 URL에 사용하고 있습니다. 키는 발급한 제공업체에서만 유효합니다.

잔액, 청구 및 무료 크레딧

많은 API 키는 계정에 크레딧이 있을 때만 작동합니다. 잔액이 없으면 키가 고장 난 것처럼 보일 수 있습니다. 제공업체의 청구 페이지를 열고 자금이 있는지, 충전이 실제로 처리되었는지, 프로모션 크레딧이 만료되지 않았는지 확인하세요. 암호화폐 충전은 표시되는 데 몇 분이 걸릴 수 있습니다.

다른 선불 서비스가 이를 어떻게 처리하는지 비교하고 싶다면, 우리의 모델은 단순합니다: 크레딧을 구매하고, 호출 시 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50로 크레딧이 차감되며, 실패하거나 거부된 요청에는 요금이 부과되지 않고, 크레딧은 만료되지 않습니다. GET /v1/balance 또는 각 응답의 X-Balance-USD 헤더를 통해 잔액을 확인할 수 있습니다.

베이스 URL 및 모델 이름

SillyTavern, Janitor AI 및 편집기 플러그인과 같은 도구에서 가장 흔한 원인은 Base URL이 약간 잘못 입력된 것입니다. 흔한 실수: /v1 누락, /v1/v1 중복, http 대신 https 사용, 또는 이미 이를 추가하는 필드에 /chat/completions 전체 경로를 붙여넣기. 모델 필드는 다른 함정입니다. 제공업체가 나열한 모델 ID와 일치해야 합니다. 제공업체가 지원하면 GET /v1/models로 목록을 확인하거나 현재 문서를 읽으세요.

특정 도구에 대한 설정 가이드는 이 사이트에 있습니다: SillyTavern에서 키 사용하기, Janitor AI에서 및 VS Code에서.

속도 제한 및 동시 요청

동시 요청의 급증은 유효한 키에서도 429 오류를 유발할 수 있습니다. Retry-After 헤더를 확인하고 백오프하세요. Python의 최소 재시도 코드는 다음과 같습니다:

Copyimport time
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.deepseekapikey.com/v1", api_key="YOUR_KEY")

def ask(prompt):
    for attempt in range(4):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 * (attempt + 1))
    raise RuntimeError("still rate limited")

우리의 엔드포인트에서는 전체 키가 8개의 동시 요청과 분당 300개의 요청을 허용합니다. 스트리밍 요청은 스트림이 완료될 때까지 슬롯을 유지합니다. 오류 코드는 rate_limited 또는 concurrency이며, 일시적인 과부하는 Retry-After: 5와 함께 429를 반환합니다.

네트워크 및 지역 문제

curl이 멈추거나 연결이 끊기면 문제는 귀하와 제공업체 사이에 있을 수 있습니다: 기업 프록시, VPN, DNS 또는 지역 차단. 다른 네트워크를 시도하고 프록시가 Authorization 헤더를 전달하는지 확인하며, 긴 생성을 위해 클라이언트 타임아웃을 높이세요. 스트리밍 응답은 버퍼링하는 프록시로 인해 차단될 수도 있으므로 stream: false로 테스트하여 두 문제를 분리하세요.

5분 안에 실행할 수 있는 체크리스트

1. curl 테스트를 실행하고 상태 코드를 기록하세요.
2. 새로운 키를 생성하고 테스트하세요. 새 키가 작동하면 이전 키가 잘못 복사되었거나 취소되었습니다.
3. 잔액 및 크레딧의 만료일(존재하는 경우)을 확인하세요.
4. 베이스 URL 및 모델 ID를 제공업체 문서와 문자 단위로 비교하세요.
5. 스트리밍 없음, 도구 없음, 짧은 프롬프트로 하나의 요청을 보내세요. 기능을 하나씩 추가하세요.
6. 동시 호출을 확인하세요. 앱이 여러 요청을 동시에 보내면 동시성을 낮추세요.
7. 다른 네트워크를 시도하거나 VPN을 끄세요.
8. 요청 ID를 포함한 응답 헤드를 확인하세요. 지원 팀은 해당 ID로 귀하의 호출을 찾을 수 있습니다.

5단계에서는 놀라운 수의 버그를 찾습니다. 약간 유효하지 않은 도구 정의, 매우 큰 max_tokens 값 또는 크기 제한을 초과하는 요청 바디는 모두 키 문제처럼 보이는 오류를 반환할 수 있습니다. 우리의 엔드포인트에서 바디 제한은 8 MB이며, 모든 응답에는 지원에 인용할 수 있는 X-Request-Id 헤더가 포함되어 있습니다.

백업 엔드포인트를 설정하세요

중단 및 제한은 모든 제공업체에서 발생하므로 구성에 두 번째 OpenAI 호환 엔드포인트를 유지하세요. 우리의 것은 합법적인 성인 사용에 콘텐츠 거부를 하지 않도록 조정된 호스팅 오픈 웨이트 모델입니다. 이는 DeepSeek의 공식 API가 아니며 라우터도 아니므로 다른 답변과 다른 동작을 기대하세요. 전환에는 두 가지 설정이 필요합니다: 기본 URL https://api.deepseekapikey.com/v1 및 모델 uncensored.

Copycurl https://api.deepseekapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'

새로운 사용자는 API 키 페이지에서 한 번의 클릭으로 $0.50의 체험 크레딧을 청구할 수 있으며, 이는 7일 동안 유효합니다. 충전은 암호화폐로 $20에서 $500까지 진행됩니다. 자세한 내용은 가격 페이지 및 문서를 참조하세요.

더 많은 가이드

• DeepSeek API 키: 무료 또는 유료? 실제 비용
• SillyTavern에서 DeepSeek API 키 사용하기: 당사 API 연결하기