DeepSeek API 키: 어디에 무엇을 붙여넣고, 첫 호출하기

DeepSeek API 키는 요청을 누가 보내는지 API에 알려주는 비밀 문자열입니다. 하지만 도구는 키 하나만으로는 충분하지 않습니다. 키, base URL, 모델 id라는 세 가지 값을 함께 필요로 합니다. 이 세 가지를 설정하면 첫 호출이 작동합니다.

아마도 어떤 폼이 "당신의 DeepSeek API 키"를 요구하기 때문에 이 글을 검색하셨을 겁니다. 스크립트, 에디터 플러그인, n8n 노드 등이 그렇겠죠. 좋습니다. 각 필드가 무엇을 원하는지 살펴보고, 실제 요청을 하나 보내봅시다.

API 키란 정확히 무엇인가?#

호텔 키 카드를 생각해 보세요. 카드에는 당신이 누구인지 글로 적혀 있지 않습니다. 그저 문을 열어주고, 프런트 데스크에서 객실 요금을 청구할 뿐입니다. API 키도 같은 역할을 합니다. 서버는 요청에서 키를 보고 어느 계정에 청구할지 알며, 호출을 통과시킵니다. 카드를 잃어버리면 누구나 들어와서 당신 방 요금을 청구할 수 있습니다. 그래서 키는 코드나 채팅에 남기지 않습니다. (더 자세한 이야기는 What is an API key and how to store it safely에 있습니다.)

DeepSeek 자체 API 문서(2026년 11월 4일 확인)도 같은 습관을 보여줍니다. 예제를 실행하기 전에 키를 환경 변수 DEEPSEEK_API_KEY에 넣으며, API는 OpenAI 형식을 따릅니다. api_key와 base_url만 바꾸면 OpenAI SDK가 작동합니다. 이게 전부이고, 그래서 키는 절대 혼자 다니지 않습니다.

사람들이 자주 걸리는 부분이 하나 있습니다. 키는 발급한 서비스에 속합니다. CheapTokens 키는 CheapTokens 주소와 함께 쓰고, 모델 id는 CheapTokens가 나열한 것을 씁니다. 한 곳의 키를 다른 곳의 주소와 섞으면 답이 아니라 인증 오류가 나옵니다.

키를 환경 변수에 넣기#

CheapTokens 계정에서 키를 만들고(문서에 단계가 있습니다) 요청이 끌어올 잔액이 있도록 충전해 두세요. 그런 다음 키를 파일에 붙여넣지 말고 변수에 저장하세요.

macOS 또는 Linux:

export CHEAPTOKENS_API_KEY='paste-your-key-here'

Windows PowerShell(현재 창에만 적용):

$env:CHEAPTOKENS_API_KEY = 'paste-your-key-here'

paste-your-key-here 부분은 자리 표시자입니다. 실제 키는 본인 터미널에서만, 다른 곳에는 넣지 마세요. 왜 이것이 하드코딩된 키보다 나은지, 키가 유출되면 어떻게 해야 하는지는 Store an API key safely: env variable, .gitignore, leak fix에 있습니다.

첫 요청#

작동하는지 보고 싶다고 합시다. 모델에게 API 키를 한 문장으로 설명해 달라고 요청하세요. 같은 요청을 두 가지 방식으로 보여드리니, 사용하는 탭을 고르세요.

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Explain an API key in one sentence."}],
    "max_tokens": 200
  }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ['CHEAPTOKENS_API_KEY'],
    base_url='https://api.cheaptokens.dev/v1',
)

resp = client.chat.completions.create(
    model='deepseek-ai/DeepSeek-V4-Flash-0731',
    messages=[{'role': 'user', 'content': 'Explain an API key in one sentence.'}],
    max_tokens=200,
)

print(resp.choices[0].message.content)
print(resp.usage)

Python 버전은 pip install openai를 한 번 설치해야 합니다. OpenAI SDK용으로 작성된 스크립트와 비교해 무엇이 바뀌었는지 보세요. api_key, base_url, model — 같은 세 가지 값입니다. 나머지는 그대로입니다.

보게 될 것#

응답은 JSON입니다. 답변 텍스트는 choices[0].message.content에 있으며, Python 스크립트가 먼저 출력하는 것이 바로 이것입니다. 바로 옆에는 prompt_tokens, completion_tokens, total_tokens가 담긴 usage 블록이 있습니다. 입력된 토큰 수, 출력된 토큰 수, 그리고 합계입니다. 비용은 이 두 숫자로 계산되므로 첫 호출에서도 한번 볼 가치가 있습니다(Input vs output tokens에서 구분을 설명합니다).

규모를 가늠해 보세요. 이런 호출은 아주 작습니다. 입력 30토큰, 출력 200토큰 — 예제의 max_tokens 상한이므로 이 요청이 낼 수 있는 가장 비싼 호출입니다. 비용은 $0.00002입니다. 이런 호출 1,000번은 다음과 같으며, 참고로 OpenRouter를 옆에 두었습니다:

그 id 뒤의 모델은 DeepSeek-V4-Flash입니다. 380K 토큰 컨텍스트 윈도우와 한 답변에 최대 32,768토큰을 지원합니다. 가격은 시간대와 관계없이 같고 피크 시간 할증이 없으며, 하나의 잔액으로 모든 모델을 사용할 수 있습니다. 입력과 출력을 합친 총액 기준으로 OpenRouter보다 저렴하며, 위 표가 바로 그것을 보여줍니다. 모델에 대한 자세한 내용은 DeepSeek on CheapTokens, 현재 가격은 가격 페이지에서 확인하세요.

작동하지 않을 때#

첫 호출 실패는 거의 항상 세 값 중 하나가 잘못된 경우입니다. 증상을 원인과 맞춰 보세요:

이 오류들에 대한 전체 안내는 API 401 or 404 error: wrong key, base URL or model id에 있습니다. 어떤 id를 써야 할지 모르겠다면 API에 직접 물어보세요: List models with GET /v1/models.

같은 세 가지 값이 다음에 들어갈 곳#

한 번 익혀두면 이식이 가능하다는 것이 핵심입니다. OpenAI 호환 API와 통신하는 거의 모든 도구는 어떤 형태로든 같은 값들을 요구합니다. 키, 주소, 모델입니다. 스크립트(LangChain, LiteLLM)에서는 인자이고, 앱이나 노코드 노드에서는 필드나 설정입니다. 코드를 작성하지 않고 Postman에서도 시험해 볼 수 있습니다. 이 모델로 스트리밍과 긴 답변을 다루려면 DeepSeek-V4-Flash quickstart를 이어서 보세요.