跳轉到主要內容

簡介

DeepSeek 是 Ace Data Cloud 提供的 AI 聊天服務,DeepSeek 系列大語言模型。透過 Ace Data Cloud 統一 API,你可以使用 JavaScript 快速整合 DeepSeek,實現多輪對話、系統提示詞、串流輸出、JSON 輸出模式、深度推理等功能。

前置條件

  • 擁有 Ace Data Cloud 帳號並取得 API Token
  • Node.js 18+ 或現代瀏覽器環境

基礎用法

呼叫 DeepSeek API 的主端點為:
POST https://api.acedata.cloud/deepseek/chat/completions
本範例使用 deepseek-r1 模型。 可用模型包括:deepseek-r1deepseek-r1-0528deepseek-v3deepseek-v3-250324 完整 JavaScript 程式碼範例:
const response = await fetch("https://api.acedata.cloud/deepseek/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "deepseek-r1",
  "messages": [
    {
      "role": "user",
      "content": "你好,請介紹一下你自己"
    }
  ],
  "max_tokens": 1024,
  "temperature": 0.7
}),
});

const result = await response.json();
console.log(result);
請將 YOUR_API_TOKEN 替換為你在 Ace Data Cloud 平台取得的實際 Token。

回應處理

建議檢查回應狀態碼並處理錯誤:
if (response.ok) {
  const result = await response.json();
  console.log("呼叫成功:", result);
} else {
  console.error(`呼叫失敗,狀態碼: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

Node.js 封裝

建議封裝為可重複使用函式:
async function callDeepSeek(data) {
  const response = await fetch("https://api.acedata.cloud/deepseek/chat/completions", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`API error: ${response.status}`);
  return response.json();
}

錯誤處理

常見錯誤碼:
狀態碼說明
401認證失敗,請檢查 API Token
403餘額不足或無權訪問
429請求頻率超限
500伺服器內部錯誤

下一步