Khóa API DeepSeek: dán gì vào đâu, và lần gọi đầu tiên

Một khóa API DeepSeek là một chuỗi bí mật cho API biết ai đang gửi yêu cầu. Tuy nhiên, một công cụ không bao giờ chỉ cần khóa: nó cần ba giá trị cùng nhau — khóa, base URL và model id. Đặt ba giá trị đó là lần gọi đầu tiên sẽ chạy được.

Bạn có lẽ đã tìm đến đây vì một biểu mẫu nào đó đang hỏi "khóa API DeepSeek của bạn": một script, một plugin trình soạn thảo, một node n8n. Được thôi. Hãy xem mỗi trường cần gì, rồi gửi một yêu cầu thật.

API key thực chất là gì?#

Hãy nghĩ đến thẻ từ mở cửa khách sạn. Nó không nói bạn là ai bằng lời; nó chỉ mở cửa phòng bạn và lễ tân tính tiền vào phòng bạn. Một API key làm đúng việc đó: máy chủ thấy nó trong yêu cầu, biết tài khoản nào bị trừ tiền, và cho phép cuộc gọi đi qua. Mất thẻ thì ai cũng có thể bước vào và tính tiền vào phòng bạn — vì vậy khóa được giữ ngoài mã nguồn và ngoài các cuộc trò chuyện. (Câu chuyện dài hơn nằm trong What is an API key and how to store it safely.)

Tài liệu API của chính DeepSeek (kiểm tra ngày 4 tháng 11 năm 2026) cho thấy thói quen tương tự: khóa được đặt vào một biến môi trường, DEEPSEEK_API_KEY, trước khi bạn chạy bất kỳ ví dụ nào, và API tuân theo định dạng OpenAI — SDK OpenAI hoạt động sau khi bạn đổi api_key và base_url. Đó là toàn bộ mẹo, và đó là lý do một khóa không bao giờ đi một mình.

Một chi tiết khiến nhiều người vấp: một khóa thuộc về dịch vụ đã phát hành nó. Khóa CheapTokens đi với địa chỉ CheapTokens, và model id là cái mà CheapTokens liệt kê. Trộn khóa từ một nơi với địa chỉ của nơi khác thì bạn nhận được lỗi xác thực, chứ không phải câu trả lời.

Đặt khóa vào biến môi trường#

Tạo một khóa trong tài khoản CheapTokens của bạn (các bước nằm trong docs) và giữ số dư được nạp để yêu cầu có thứ để trừ. Sau đó lưu khóa vào một biến thay vì dán vào tệp.

macOS hoặc Linux:

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

Windows PowerShell (chỉ cửa sổ hiện tại):

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

Phần paste-your-key-here là chỗ giữ chỗ; hãy đặt khóa thật của bạn ở đó trong terminal của riêng bạn và không ở đâu khác. Vì sao cách này tốt hơn khóa viết cứng, và phải làm gì nếu một khóa bị lộ, nằm trong Store an API key safely: env variable, .gitignore, leak fix.

Yêu cầu đầu tiên#

Giả sử bạn chỉ muốn thấy nó hoạt động: yêu cầu model giải thích API key trong một câu. Cùng một yêu cầu, hai cách — chọn tab bạn dùng.

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)

Phiên bản Python cần pip install openai một lần. Hãy xem điều gì đã thay đổi so với một script viết cho SDK OpenAI: api_key, base_url và model — vẫn là ba giá trị đó. Mọi thứ còn lại giữ nguyên.

Bạn sẽ thấy gì#

Phản hồi là JSON. Văn bản của câu trả lời nằm trong choices[0].message.content; đó là thứ script Python in ra đầu tiên. Ngay bên cạnh là một khối usage với prompt_tokens, completion_tokens và total_tokens — bao nhiêu token vào, bao nhiêu token ra, và tổng. Chi phí được tính từ hai con số này, nên đáng để liếc qua ngay cả ở lần gọi đầu tiên (Input vs output tokens giải thích cách chia).

Để cảm nhận quy mô: một lần gọi như thế này rất nhỏ. Lấy 30 token vào và 200 token ra — mức trần max_tokens từ ví dụ, tức lần gọi đắt nhất mà yêu cầu này có thể tạo ra. Nó tốn $0.00002. Một nghìn lần như vậy trông thế này, với OpenRouter bên cạnh để tham khảo:

Model đằng sau id đó là DeepSeek-V4-Flash: cửa sổ ngữ cảnh 380K token và tối đa 32.768 token trong một câu trả lời. Giá giữ nguyên mọi giờ, không phụ phí giờ cao điểm, và một số dư bao trùm mọi model. Tổng cộng — đầu vào và đầu ra gộp lại — nó rẻ hơn OpenRouter, đúng như bảng trên cho thấy. Thêm về model: DeepSeek on CheapTokens, giá hiện tại trên trang giá.

Khi nó không chạy#

Gần như mọi lỗi lần gọi đầu đều là một trong ba giá trị bị sai. Khớp triệu chứng với thủ phạm:

Hướng dẫn đầy đủ về các lỗi này nằm trong API 401 or 404 error: wrong key, base URL or model id. Và nếu bạn không chắc dùng id nào, hãy hỏi chính API: List models with GET /v1/models.

Ba giá trị đó đi tiếp đến đâu#

Điểm hay của việc học chúng một lần là chúng có thể mang đi. Gần như mọi công cụ nói chuyện với API tương thích OpenAI đều hỏi ba giá trị này dưới một dạng nào đó: khóa, địa chỉ và model. Trong một script (LangChain, LiteLLM) chúng là đối số; trong một ứng dụng hoặc node no-code chúng là trường hoặc cài đặt. Bạn cũng có thể thử chúng mà không viết mã trong Postman. Để streaming và câu trả lời dài với model này, tiếp tục với DeepSeek-V4-Flash quickstart.