Hướng dẫn cách lấy API Key của DeepSeek chi tiết A-Z (cập nhật 10/2026)

Để lấy API key DeepSeek, bạn đăng nhập platform.deepseek.com, chọn mục API keys, nhấn Create new API key, đặt tên rồi sao chép key bắt đầu bằng sk-… ngay lúc tạo. Key chỉ gọi được model khi tài khoản có số dư: DeepSeek tính phí trả trước, bạn nạp tiền ở mục Top up.

DeepSeek không công bố gói API miễn phí rõ ràng; nếu bạn cần API key miễn phí để thử, bài LLM API key miễn phí tổng hợp 11 nền tảng có hạn mức miễn phí, trong đó vài nền tảng có model DeepSeek. Giới thiệu về DeepSeek có ở bài DeepSeek AI là gì. Tên model trong bài đối chiếu tài liệu DeepSeek ngày 29/10/2026.

Tổng quan về DeepSeek API

DeepSeek API cho phép gọi các model của DeepSeek bằng code, tính phí theo token và dùng chung định dạng với OpenAI API, nên đa số thư viện, công cụ agent chỉ cần đổi base URL và key. Hai model hiện hành trên API là deepseek-flash và deepseek-v4-pro.

DeepSeek API là gì?

DeepSeek API là cổng giao tiếp lập trình ứng dụng, đóng vai trò cầu nối kỹ thuật cho phép các nhà phát triển và doanh nghiệp tích hợp trực tiếp sức mạnh trí tuệ nhân tạo của DeepSeek vào hệ thống phần mềm, website hoặc ứng dụng di động riêng biệt.

Thay vì phải thao tác thủ công trên giao diện web, người dùng có thể gửi yêu cầu và nhận phản hồi tự động từ các mô hình ngôn ngữ lớn (hiện là deepseek-flash và deepseek-v4-pro, theo trang cập nhật của DeepSeek) thông qua mã lệnh. Giải pháp này giúp tối ưu hóa quy trình xử lý dữ liệu, cho phép hệ thống vận hành linh hoạt và mở rộng khả năng ứng dụng AI vào thực tế sản xuất kinh doanh một cách hiệu quả.

Xem thêm: DeepSeek AI là gì?

Tại sao cần sử dụng API Key DeepSeek?

API Key đóng vai trò như “chìa khóa” định danh và cấp quyền truy cập vào hạ tầng máy chủ của DeepSeek. Việc sở hữu mã khóa này là bước bắt buộc để triển khai các trường hợp sử dụng thực tế sau:

• Tích hợp AI vào sản phẩm phần mềm: Doanh nghiệp có thể nhúng khả năng xử lý ngôn ngữ tự nhiên vào các ứng dụng Chatbot chăm sóc khách hàng, công cụ viết content tự động hoặc phần mềm hỗ trợ lập trình (Coding Assistant) để nâng cao trải nghiệm người dùng.
• Tự động hóa quy trình làm việc: API cho phép kết nối DeepSeek với các công cụ như Excel, Google Sheets hoặc hệ thống CRM để tự động tóm tắt văn bản, phân loại dữ liệu khách hàng hoặc dịch thuật tài liệu số lượng lớn mà không cần sự can thiệp của con người.
• Phát triển ứng dụng chuyên sâu: Lập trình viên kết hợp API với dữ liệu riêng (ví dụ qua RAG) để xây trợ lý cho một lĩnh vực cụ thể như y tế, luật hay tài chính.
• Tối ưu hóa chi phí vận hành: Giá token của DeepSeek thuộc nhóm thấp, lại có giờ thấp điểm giảm còn một nửa giá (từ 16/08/2026), phù hợp tác vụ khối lượng lớn.

Xem thêm: Các model của DeepSeek hiện có 

Điều kiện cần trước khi tạo API Key DeepSeek

Bạn cần chuẩn bị:

• Tài khoản DeepSeek Platform hợp lệ: Bạn cần đăng ký một tài khoản chính chủ trên trang dành cho nhà phát triển của DeepSeek. Bạn có thể sử dụng tài khoản DeepSeek đã có hoặc đăng ký mới bằng email. Tuy nhiên, việc sử dụng tài khoản Google để liên kết sẽ giúp quá trình đăng nhập nhanh chóng hơn.
• Số điện thoại xác thực (đăng ký tài khoản bằng email): Trong một số trường hợp, hệ thống có thể sẽ yêu cầu liên kết số điện thoại để nhận mã OTP nhằm tăng cường bảo mật. Đây là bước quan trọng để kích hoạt đầy đủ các tính năng của tài khoản.
• Phương thức thanh toán quốc tế: DeepSeek tính phí trả trước, nên bạn cần thẻ Visa/Mastercard thanh toán quốc tế hoặc PayPal để nạp số dư (theo trang Top up lúc chụp ảnh).
• Kiến thức cơ bản về kỹ thuật (Tùy chọn): Để sử dụng API Key hiệu quả, người dùng nên có hiểu biết cơ bản về cách gửi yêu cầu HTTP hoặc sử dụng các ngôn ngữ lập trình phổ biến như Python, JavaScript (Node.js) để cấu hình kết nối.

Hướng dẫn cách lấy API Key của DeepSeek nhanh chóng

Lấy API key DeepSeek gồm hai phần: tạo key trong mục API keys và nạp số dư ở mục Top up. Có thể tạo key trước, nhưng request chỉ chạy khi số dư lớn hơn 0. Ảnh minh hoạ chụp 12/2025; giao diện có thể đã đổi.

Các bước lấy API Key của DeepSeek

Bước 1: Đầu tiên, bạn cần truy cập vào cổng thông tin dành riêng cho nhà phát triển (Developer Platform) của DeepSeek tại: platform.deepseek.com

Sau đó, đăng nhập bằng tài khoản DeepSeek của bạn. Hoặc bạn cũng có thể đăng ký một tài khoản riêng cho việc sử dụng API Key.

Bước 2: Sau khi đăng nhập thành công vào bảng điều khiển (Dashboard), giao diện sẽ hiển thị các thông số kỹ thuật và trạng thái tài khoản.

Nhìn sang thanh menu điều hướng bên trái màn hình. Tìm và nhấp chuột vào mục “API Keys”.

Tại đây, hệ thống sẽ hiển thị danh sách các Key đang hoạt động hoặc đã bị vô hiệu hóa (nếu có).

Bước 3: Nhấn vào nút “Create new API Key” (Tạo mã khóa API mới).

Một hộp thoại sẽ xuất hiện yêu cầu nhập tên cho Key. Bạn nên đặt tên theo dự án cụ thể để dễ dàng quản lý và phân biệt nguồn truy cập sau này.

Sau khi nhập tên, nhấn “Create”.

Hệ thống sẽ tạo ra một chuỗi ký tự bắt đầu bằng sk-…

Nhấn vào biểu tượng sao chép (Copy) bên cạnh mã và dán chuỗi này vào một trình quản lý mật khẩu hoặc tệp tin ghi chú bảo mật ngay lập tức.

Lưu ý: DeepSeek chỉ hiển thị toàn bộ chuỗi ký tự này duy nhất một lần ngay tại thời điểm khởi tạo vì lý do bảo mật. Sau khi bạn đóng hộp thoại này, bạn sẽ không bao giờ xem lại được đầy đủ mã khóa này nữa. Nếu làm mất, người dùng buộc phải xóa Key cũ và tạo một Key mới thay thế.

Hướng dẫn nạp tiền để kích hoạt API

Việc sở hữu API Key là chưa đủ để hệ thống hoạt động. Tài khoản DeepSeek hoạt động theo cơ chế trả trước: bạn nạp số dư, mỗi request trừ dần theo token. Số dư bằng 0 thì API trả lỗi 402.

Bước 1: Tại thanh menu bên trái, chọn mục “Top up” (Nạp tiền).

Bước 2: Chọn số tiền muốn nạp (giao diện lúc chụp có các mức từ 2 USD và tuỳ chọn Custom).

Sau đó, lựa chọn phương thức thanh toán phù hợp (Hỗ trợ thẻ Visa, Mastercard, UnionPay hoặc PayPal).

Sau khi giao dịch thành công, số dư sẽ được cập nhật và API Key vừa tạo sẽ chính thức có hiệu lực để gửi yêu cầu xử lý dữ liệu.

Các lỗi thường gặp khi tạo và sử dụng API Key DeepSeek

Ba mã lỗi hay gặp khi gọi DeepSeek API là 401 (key sai hoặc đã xoá), 402 (hết số dư) và 429 (gửi request quá nhanh). Đọc mã lỗi trước rồi xử lý theo đúng nguyên nhân sẽ nhanh hơn tạo lại key.

Lỗi xác thực (Authentication Error – 401)

• Mô tả: Hệ thống trả về thông báo từ chối truy cập ngay khi gửi yêu cầu.
• Nguyên nhân: Chuỗi API Key trong cấu hình không chính xác, bị sai định dạng hoặc Key cũ đã bị xóa/vô hiệu hóa.
• Cách khắc phục: Kiểm tra kỹ lưỡng từng ký tự trong mã khóa (bắt đầu bằng sk-…). Đảm bảo không có khoảng trắng thừa ở đầu hoặc cuối chuỗi khi sao chép. Nếu vẫn không thành công, hãy tạo một Key mới và cập nhật lại vào ứng dụng.

Lỗi không đủ số dư (Insufficient Balance – 402)

• Mô tả: API ngừng hoạt động đột ngột dù trước đó vẫn chạy ổn định.
• Nguyên nhân: Tài khoản trả trước đã hết số dư.
• Cách khắc phục: Truy cập mục Usage trên trang quản trị để kiểm tra số dư hiện tại. Hãy nạp thêm tiền (Top-up) để khôi phục dịch vụ ngay lập tức.

Lỗi vượt quá giới hạn (Rate Limit Exceeded – 429)

• Mô tả: Thông báo lỗi yêu cầu người dùng “thử lại sau”.
• Nguyên nhân: Ứng dụng gửi quá nhiều yêu cầu trong một khoảng thời gian ngắn, vượt quá ngưỡng quy định của DeepSeek nhằm bảo vệ hệ thống.
• Cách khắc phục: Điều chỉnh lại code để giảm tần suất gửi yêu cầu hoặc thiết lập cơ chế “Exponential Backoff” (tăng dần thời gian chờ giữa các lần thử lại) để không dồn request khi hệ thống đang quá tải.

Model và giá API DeepSeek

Theo trang cập nhật của DeepSeek (đối chiếu 29/10/2026), API hiện có hai model: deepseek-flash (đang chạy DeepSeek-V4.1-Flash, cập nhật 17/10/2026, đa phương thức) và deepseek-v4-pro (V4-Pro, phát hành 13/08/2026). Giờ thấp điểm giá bằng nửa giờ cao điểm.

• Tên model cũ: deepseek-chat và deepseek-reasoner đã được thông báo ngừng từ 24/07/2026. Code mẫu cũ dùng hai tên này nên đổi sang model mới.
• Model đã gỡ: deepseek-v4-flash và bản thử nghiệm vision đã ngừng, request tạm được chuyển sang V4.1 Flash.
• Giá và độ dài ngữ cảnh: bài không ghi số vì DeepSeek đổi giá theo khung giờ và theo đợt; xem trực tiếp trang giá DeepSeek API trước khi tính ngân sách.
• Trọng số mở: DeepSeek-V4.1-Flash và V4-Pro có bản tải về trên Hugging Face, giấy phép MIT; danh sách model ở bài các model của DeepSeek.

Nguyên tắc bảo mật API Key cần nhớ

API Key là tài sản số quan trọng, tương đương với mật khẩu ngân hàng của doanh nghiệp trên môi trường DeepSeek. Việc để lộ mã khóa này có thể dẫn đến thất thoát ngân sách nghiêm trọng do kẻ xấu lợi dụng tài nguyên. Bốn nguyên tắc sau giữ key an toàn:

• Không nhúng trực tiếp vào Code: Không viết thẳng mã khóa vào mã nguồn, đặc biệt là code chạy trên trình duyệt hay ứng dụng di động. Thay vào đó, hãy sử dụng biến môi trường (Environment Variables – ví dụ: file .env) để gọi Key ra khi cần thiết. Cách làm này giúp tách biệt dữ liệu nhạy cảm khỏi logic chương trình.
• Không đẩy lên các kho lưu trữ công khai: Trước khi tải code lên GitHub, GitLab hay Bitbucket, hãy kiểm tra kỹ file .gitignore để chắc chắn tệp tin chứa API Key không bị công khai. Đã có rất nhiều trường hợp bot quét tự động đánh cắp Key chỉ vài giây sau khi lập trình viên lỡ tay tải lên.
• Xoay vòng khóa định kỳ: Để tăng cường an ninh, doanh nghiệp nên thay đổi API Key định kỳ (ví dụ: mỗi 3-6 tháng). Hành động này đảm bảo rằng nếu một Key cũ bị rò rỉ âm thầm, kẻ gian cũng không thể tiếp tục sử dụng.
• Thiết lập giới hạn ngân sách: Vì DeepSeek trả trước, số dư bạn nạp chính là giới hạn cứng: chỉ nạp vừa đủ cho một giai đoạn. Bật cảnh báo số dư (mục Balance alert trong Usage) để nhận email khi số dư xuống thấp.

Lộ key: xoá key ở mục API keys, tạo key mới và kiểm tra Usage. Nếu key nằm trong workflow n8n, xem cách bảo mật credentials và API key trong n8n.

Dùng API key DeepSeek cho agent chạy 24/7

Key DeepSeek dùng được trong OpenClaw, Hermes Agent, n8n qua provider DeepSeek hoặc provider OpenAI-compatible. Agent cần chạy liên tục nên thường đặt trên VPS, phần suy luận vẫn do DeepSeek xử lý; cách đổi provider và key trong OpenClaw có ở bài đổi provider, model và API key trong OpenClaw.

Muốn chạy OpenClaw 24/7 mà không tự cài? VPS OpenClaw của Tino cài sẵn OpenClaw trên VPS NVMe đặt tại Việt Nam; bạn vẫn có quyền root để cấu hình. Xem cấu hình và giá trên trang sản phẩm.

Câu hỏi thường gặp