DeepSeek API 入門指南：快速上手教程

2024-12-31

DeepSeek API 概述

DeepSeek API 採用與 OpenAI 相容的 API 格式，這意味著您可以通過簡單的配置修改，使用 OpenAI SDK 或任何與 OpenAI API 相容的軟體來訪問 DeepSeek API。本指南將幫助您快速開始使用 DeepSeek API。

基本配置參數

主要配置參數包括：

base_url: https://api.deepseek.com
- 為保持與 OpenAI 相容，您也可以使用 https://api.deepseek.com/v1
- 注意：此處的 v1 與模型版本無關
api_key: 需要申請 API 密鑰
model: 使用 deepseek-chat 即可調用最新的 DeepSeek-V3 模型

API 調用示例

使用 curl 調用

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <DeepSeek API Key>" \
  -d '{
        "model": "deepseek-chat",
        "messages": [
          {"role": "system", "content": "You are a helpful assistant."},
          {"role": "user", "content": "Hello!"}
        ],
        "stream": false
      }'

使用 Python SDK

from openai import OpenAI

client = OpenAI(api_key="<DeepSeek API Key>", base_url="https://api.deepseek.com")

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "You are a helpful assistant"},
        {"role": "user", "content": "Hello"},
    ],
    stream=False
)

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

使用 Node.js SDK

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: process.env.DEEPSEEK_BASE_URL,
  apiKey: "<DeepSeek API Key>",
});

async function main() {
  const completion = await openai.chat.completions.create({
    messages: [{ role: "system", content: "You are a helpful assistant." }],
    model: "deepseek-chat",
  });

  console.log(completion.choices[0].message.content);
}

main();

重要說明

在開始使用前，請確保已經：
- 申請了 DeepSeek API 密鑰
- 安裝了相應的 SDK（如使用 Python 需要 pip install openai，使用 Node.js 需要 npm install openai）
串流輸出：
- 預設為非串流輸出
- 可以通過設置 stream=true 啟用串流輸出
- 串流輸出適合需要即時回應的場景
模型說明：
- deepseek-chat 模型已全面升級為 DeepSeek-V3
- 介面保持不變，無需修改現有程式碼
- 通過指定 model='deepseek-chat' 即可使用最新版本

後續步驟

完成基本配置後，您可以：

探索更多進階 API 參數
實現串流輸出功能
整合到您的應用程式中
優化 API 調用效率

現在，您可以開始使用 DeepSeek API 構建您的 AI 應用了！