Claude Opus 5.5 已在 SeedRouter 上線
LogoSeedRouter
全部文章

DeepSeek V4.1 Flash API 怎麼用：取得金鑰並完成第一次呼叫

DeepSeek V4.1 Flash API 串接教學：取得 API 金鑰，用 OpenAI SDK 呼叫，開啟或關閉思考模式、串流輸出、傳送圖片，並修正新手常遇到的錯誤。

以 Markdown 閱讀

要呼叫 DeepSeek V4.1 Flash，你需要一個提供該模型的平台所發的 API 金鑰，以及一個帶有其模型 ID 的請求。在 DeepSeek 自家的 API 上，模型名稱是 deepseek-flash，舊名稱 deepseek-v4-flash 與 deepseek-v4-flash-vision-exp 也會被導向它。在 SeedRouter 上，模型 ID 是 deepseek-v4.1-flash，一把金鑰即可隨用隨付呼叫，使用官方請求格式：把 OpenAI SDK 指向 https://api.seedrouter.ai/v1，程式碼維持不變。

本指南使用 SeedRouter；請求內容與 DeepSeek 自家的 API 相同。

DeepSeek V4.1 Flash API 金鑰怎麼取得？

  1. 登入 SeedRouter，開啟 API keys。
  2. 建立金鑰並複製；它只會顯示一次。
  3. 需要時再儲值。新帳戶會附一小筆免費餘額，而且沒有訂閱制。

把金鑰存在環境變數中，例如 SEEDROUTER_API_KEY，並且只在伺服器端程式碼中使用。

怎麼用 Python 呼叫 DeepSeek V4.1 Flash？

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["SEEDROUTER_API_KEY"],
    base_url="https://api.seedrouter.ai/v1",
)

completion = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Give me three names for a coffee shop."}],
)
print(completion.choices[0].message.content)

思考模式預設為開啟，所以訊息中除了 content 裡的回答，還會在 reasoning_content 中附上模型的推理過程。

怎麼用 Node.js 或 cURL 呼叫？

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.SEEDROUTER_API_KEY,
  baseURL: "https://api.seedrouter.ai/v1",
});

const completion = await client.chat.completions.create({
  model: "deepseek-v4.1-flash",
  messages: [{ role: "user", content: "Give me three names for a coffee shop." }],
});
console.log(completion.choices[0].message.content);
curl https://api.seedrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-v4.1-flash", "messages": [{"role": "user", "content": "Give me three names for a coffee shop."}]}'

同一把金鑰也能透過 Responses API（/v1/responses）與 Anthropic Messages 格式（/v1/messages）呼叫 deepseek-v4.1-flash。

怎麼關閉思考模式或設定推理強度？

思考模式預設為開啟，推理強度為 high。用 thinking 關閉它，或用 reasoning_effort 選擇推理強度。OpenAI SDK 透過 extra_body 傳遞 thinking。第一個請求關閉思考，回答最快、最便宜；第二個使用最高的推理強度：

completion = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Classify: 'my card was charged twice'"}],
    extra_body={"thinking": {"type": "disabled"}},
)

completion = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "How many primes are there below 150?"}],
    reasoning_effort="max",
)
reasoning_effort效果
none關閉思考
low簡短推理
high（預設）適合大多數任務
max最困難的問題

DeepSeek 也接受 minimal（以 low 執行）、medium 與 xhigh（以 high 執行）。在我們針對一道質數計數題的測試中，關閉思考用了 2 個輸出 token，low 用了 258 個，max 用了 319 個。推理以輸出計費。

怎麼串流輸出回答？

加上 stream=True。開啟思考時，推理過程會先透過 delta.reasoning_content 送達，接著回答透過 delta.content 送達，最後一個 chunk 帶有 token 用量：

stream = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "Write a haiku about latency."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

可以傳送圖片嗎？

可以。DeepSeek V4.1 Flash 原生支援讀取圖片。在 image_url 部分中傳送公開網址或 base64 data URI：

completion = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": "https://example.com/chart.png"}},
            {"type": "text", "text": "What does this chart show?"},
        ],
    }],
)

圖片網址最長 8,192 個字元，指向的檔案最大 32 MiB。

可能會遇到哪些錯誤？

錯誤原因修正方式
response_format 回傳 400不支援 json_schema改用 {"type": "json_object"}，並在提示中描述結構
temperature 或 top_p 回傳 400超過 2 或超過 1維持在範圍內；開啟思考時它們本來就影響不大
圖片網址回傳 400檔案無法作為圖片下載確認網址是公開的，且指向一張圖片
401金鑰缺少或錯誤檢查 Authorization 標頭

錯誤會回傳 {"error": {"code": ..., "message": "..."}}，失敗的請求不收費。

常見問題

DeepSeek V4.1 Flash API 與 OpenAI 相容嗎？

相容。它接受 Chat Completions 與 Responses 格式，所以只要改 base URL 與模型，OpenAI SDK 就能使用。它也接受 Anthropic Messages 格式。

為什麼模型 ID 和 DeepSeek 的不一樣？

DeepSeek 在自家 API 上把模型命名為 deepseek-flash。SeedRouter 使用 deepseek-v4.1-flash，讓版本號成為名稱的一部分。除此之外，請求內容完全相同。

一次 DeepSeek V4.1 Flash 請求要多少錢？

以 token 計費，依所在時段套用尖峰時段或離峰時段費率。DeepSeek V4.1 Flash 價格指南 提供即時費率與計算範例。

完整的參數列表在哪裡？

DeepSeek V4.1 Flash API 文件 列出每個欄位，DeepSeek V4.1 Flash 頁面 提供 playground 與即時價格。

全部文章

相關指南