DeepSeek API + Full Integration Guide

Bắt đầu với DeepSeek API

Thiết lập quyền truy cập API bắt đầu bằng việc tạo tài khoản nhà phát triển trên nền tảng DeepSeek và tạo API key đầu tiên từ phần thông tin xác thực. Quy trình bắt đầu nhanh bao gồm ba bước cốt lõi: cấu hình xác thực, cài đặt SDK và thực hiện yêu cầu đầu tiên. Hầu hết các nhà phát triển hoàn thành thử nghiệm yêu cầu đầu tiên trong vòng 15 phút bằng cách sử dụng các mẫu mã nguồn được cung cấp.

Xác thực sử dụng định dạng bearer token với các khóa bắt đầu bằng tiền tố "sk-". URL cơ sở cho tất cả các API endpoint là https://api.deepseek.com/v1, tuân theo các quy ước RESTful. Các tiêu đề bắt buộc bao gồm Authorization với API key của bạn và Content-Type được đặt thành application/json. Giới hạn tốc độ được áp dụng cho mỗi khóa thay vì cho mỗi tài khoản, cho phép các nhóm phân bổ hạn ngạch trên nhiều dự án khác nhau.

Để cài đặt Python SDK, hãy sử dụng pip để thêm thư viện máy khách chính thức. Mã nguồn sau đây minh họa quy trình yêu cầu đầu tiên hoàn chỉnh bằng cách sử dụng endpoint chat completion với DeepSeek V3:

pip install deepseek-sdk

from deepseek import DeepSeek

client = DeepSeek(api_key="sk-your-api-key-here")

response = client.chat.completions.create(
    model="deepseek-chat-v3",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Explain quantum computing in simple terms."}
    ],
    max_tokens=500,
    temperature=0.7
)

print(response.choices[0].message.content)

Đối với các nhà phát triển thích sử dụng curl, lệnh HTTP tương đương yêu cầu cấu hình tiêu đề rõ ràng. Cách tiếp cận này hoạt động tốt để thử nghiệm mà không cần phụ thuộc vào SDK:

curl https://api.deepseek.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat-v3",
    "messages": [{"role": "user", "content": "Hello, API!"}],
    "max_tokens": 100
  }'

API trả về phản hồi JSON chứa văn bản được tạo, số liệu thống kê sử dụng token và siêu dữ liệu yêu cầu. Các phản hồi thành công bao gồm một mảng choices với đầu ra của mô hình, trong khi các lỗi trả về mã tiêu chuẩn để gỡ lỗi. Số lượng token xuất hiện trong đối tượng usage, theo dõi prompt_tokens, completion_tokens và total_tokens để thanh toán chính xác.

• Lấy thiết lập API key từ tab bảo mật trong bảng điều khiển nhà phát triển.
• Cài đặt Python SDK hoặc sử dụng yêu cầu HTTP trực tiếp để linh hoạt ngôn ngữ.
• Kiểm tra kết nối bằng một chat completion đơn giản trước khi tích hợp sản xuất.
• Theo dõi các tiêu đề phản hồi để biết trạng thái giới hạn tốc độ và hạn ngạch còn lại.

Hướng dẫn bắt đầu nhanh API trong tài liệu bao gồm các ngôn ngữ bổ sung như Node.js và Go, với các ví dụ cụ thể cho Express, Flask và FastAPI. Cấu hình webhook để xử lý bất đồng bộ yêu cầu xác minh endpoint trong quá trình thiết lập ban đầu.