DeepSeek 全家桶 API 五項能力與閘道分流示意封面

11月13日DeepSeek把全家桶API放出來,官方說1:1複刻App,搜尋、讀連結、語音合成、語音辨識都拆成了介面。我在閘道上跑了一輪,對繁體開發者最要緊的結論是:語音辨識直接回傳繁體,不用再做轉換;語音合成要換模型名,而且音色合不合在地場景得自己聽過;搜尋和讀連結模型會發起、閘道不執行。

這篇寫給用OpenAI相容閘道、要服務繁體使用者的開發者。你只走官方api.deepseek.com的話,照官方文件就行。實測是2026年11月17日做的,讀連結11月20日補測;深度思考搜尋、檔案輸入、模型安全和OCR沒單獨驗證,不寫成結論。音色適配和延遲是選用前的提醒,不是我的實測資料,文中會標清楚。

先把順序講明白。下面幾件事我是按繁體開發者的優先順序排的,不是照官方文件的能力清單抄一遍:先講最有利的一項,再講選用前要判斷的一項,最後才是那些看起來正常、其實沒做事的部分。

全家桶API能力清單示意

一、先講最有利的一項:語音辨識直接給繁體

語音辨識是這輪裡最省事的一項。一段6秒的中文音訊,whisper-1回傳HTTP 200,轉寫內容正確。關鍵在於回傳的是繁體:那段音訊轉出來的文字是「DeepSeek的Harness團隊發了一篇長文,提出一種新的Agent型態叫SuperAgent」,「團隊」「型態」都是繁體用法,直接放進繁體介面就能用。

這一點值得特別講。同一個實測現象,換個讀者結論就反過來了:需要簡體輸出的開發者得在客戶端自己做繁簡轉換,這在別的地區是個坑;對繁體產品來說,開箱即用的就是繁體,反而省掉一道工序。

有個細節要記:wav格式請求卡到90秒逾時,換mp3立刻正常,上傳前先把格式轉好。這條跟簡繁無關,兩種使用者都會踩到。

STT轉寫結果

二、語音合成能用,但音色要自己聽過再決定

語音合成這項閘道接通了,模型名對不上。官方範例裡的tts-1在閘道報404,換成閘道自己的minimax-speech-2.8-turbo,回傳一段46KB的真實MP3,ID3標籤裡帶著ContentProducer=MiniMax和AIGC標識,是能正常播放的音訊,不是錯誤頁,可選的還有minimax-speech-2.8-hd。

要先說清楚:回傳的不是DeepSeek的語音。官方公布的TTS能力和閘道回傳的MiniMax語音是兩家東西,閘道提供的是自己接入的語音模型。

對繁體產品,這裡還多一層要判斷。MiniMax是大陸廠商的語音模型,預設音色是普通話腔調;如果你的應用面向台灣地區使用者,客服語音、有聲內容這類場景對口音通常敏感,建議實際播一段給目標使用者聽過再決定要不要用,或改用hd那一檔聽聽看。這是我依模型來源給的選用提醒,不是我做了口音比較測試的結果,別當成實測結論。

TTS生成的MP3檔案資訊

三、模型名先換,第一步才不會報404

官方文件把全家桶掛在deepseek-flash上,照填回傳model_not_found: Model deepseek-flash is not provided by Crazyrouter,換成閘道目錄裡的deepseek-v4.1-flash就通了。閘道側和廠商官方名本來就不一樣,別照官方名猜,對著Crazyrouter模型目錄核一遍最省事。

在地還有個實際問題:閘道除了主站,另列了東亞節點cn.crazyrouter.com,官方文件標的是同配置。台灣地區連線可以試試這個節點,延遲通常比跨區連主站好一些;延遲有沒有改善要看你自己的網路環境,我沒有單獨測這一段,這裡只提醒有這個入口。

還有一點:搜尋目前只在flash這一檔開放,換名時確認換過去那檔同樣支援工具呼叫,不然名字對了、能力又沒了。

模型名404報錯

四、搜尋和讀連結:看起來成功,其實沒執行

這項最容易被誤判,因為回傳值看著全是成功訊號。我把「deepseek_web_search」作為function tool傳進去,問11月13日DeepSeek發布了什麼,特意強調別憑記憶。閘道回傳HTTP 200,finish_reason是tool_calls,模型產生了兩個搜尋呼叫,arguments裡是正確的查詢詞。

閘道到這就停了。它把搜尋當普通function calling透傳,沒有服務端執行,也沒有回傳任何網頁內容。content是空的,我拿到的是一句「我來查一下」和一個要自己執行的函式名。官方那套服務端完成搜尋和上下文拼接,在這裡只剩一半。

按官方文件換「type:web_search」內建格式呢?直接400,報invalid_request_params,閘道不認這種私有工具類型。官方主打的開箱即用連網搜尋,在閘道上要嘛自己接一半,要嘛根本進不來。

tool_calls回傳但無搜尋結果

判別方法記一條:看回傳裡有沒有網頁內容和引用。有才是真搜了;只有tool_calls和一句「我來查一下」,就是模型發起、閘道沒執行。

讀連結我另外補測了一次,機制和搜尋完全一樣。把官方公告頁位址傳給「deepseek_read_url」,回傳的還是tool_calls,正文只有一句「我會為你讀取那個頁面」,網頁內容一個字都沒有;換成內建的「read_url」格式,直接400報參數錯誤。這項和搜尋同解。

五、五項對照:加上繁體開發者的判斷

同樣五項,換個讀者,注意的地方就不一樣。我在表格最後加了一列,寫繁體產品要特別看的點。

官方能力 閘道狀態 實測現象 繁體產品要注意
官方模型名deepseek-flash 不能用 404,須換成deepseek-v4.1-flash 地緣上可試東亞節點,配置相同
連網搜尋內建執行 不能用 回傳tool_calls但不搜尋,內建格式報400 抓繁體網頁要自己在客戶端做
閱讀連結deepseek_read_url 不能用 回傳tool_calls但不讀,內建格式報400 同上,別以為回傳成功就讀到了
TTS語音合成 換名可用 tts-1報404,minimax-speech-2.8-turbo回傳真實MP3 音色是普通話,面向在地使用者先試聽
STT語音辨識 直接可用 whisper-1加mp3回傳正確轉寫,輸出繁體 繁體直接可用,這是優勢不是坑

深度思考搜尋、檔案輸入、模型安全、OCR這四項沒單獨驗證,不在表裡。整體看,閘道接通的是語音兩端,搜尋和讀連結這類App級能力得自己搭。

六、自建用戶端要補的幾塊,以及成本怎麼算

官方那套在閘道上要自己搭,搭的時候有幾塊是服務端本來幫你做、現在落到客戶端的。這幾塊不是我這次在閘道上測出來的,是官方文件和幾篇一手實測反覆提到的,標了來源。

  1. 日期要自己傳。不傳當前日期,模型會把「今天」猜到訓練資料裡最密集的時間點。有人實測問「DeepSeek今天發布了什麼」,搜出來全是二月的舊聞。官方解法是每次請求在使用者訊息前緊挨著插一條固定格式的「latest_reminder」訊息傳日期和位置,注意每條訊息都插,不是開頭寫一次就複用,日期會過期。有開發者實測加上之後,同樣的提問從觸發12次搜尋變成3次就命中當日內容(來源:稀土掘金的配置教程)。
  2. signature要原樣回傳。讀過的網頁,內容被加密塞進「signature」欄位,客戶端拿不到明文。多輪對話時必須把這塊原樣傳回服務端,否則請求照樣成功、但模型已經「忘了」上一頁讀過的內容,還不報錯,很像是幻覺,其實是框架把不認識的欄位剝掉了(來源:yage.ai的獨立介面分析)。
  3. 取樣參數會失效。一旦宣告了連網搜尋、讀連結或開啟「safety_check」,temperature、top_p、thinking.budget_tokens這些取樣參數會被服務端直接忽略,寫的隨機度、思考深度全成裝飾。想自己握住取樣參數,這幾樣別在同一個請求裡開(來源:稀土掘金的參數坑分析)。
  4. 成本要疊著算。搜尋類按次計費、語音按字元或時長計費,都疊在token費之上。有人算過一筆帳:按次費疊加token費,最便宜的連網問答和最貴的長文朗讀,單次成本能差出一個量級(來源:稀土掘金的參數坑分析)。對台灣地區的獨立開發者和小團隊,我的建議是先用小額額度把全流程跑通、量出自己那句提問的實際單價,再決定要不要放大,不要一開始就照官方宣傳的用量估預算。計費口徑以DeepSeek官方公告為準,這裡不抄數字,免得過時。

日期和signature這兩項是拼裝客戶端時真正的隱性成本,服務端幫你做的越少,客戶端要處理的越多。

七、官方介面還是閘道

跑完這一圈,選擇看你要服務的是什麼。

你的情況 建議用哪個 理由
要完整複刻App、需要連網搜尋和檔案輸入 官方api.deepseek.com 服務端完成工具呼叫和上下文拼接,開箱即用
用閘道調對話和語音、服務繁體使用者 統一閘道 STT回傳繁體可直接用,東亞節點可試
想在閘道上用連網搜尋抓繁體網頁 閘道加自建客戶端 自己接獨立Search端點或回填工具結果
要看住語音音色和取樣參數 兩邊都要先驗證 音色先試聽,內建開關一開取樣參數就被忽略

統一閘道的Base URL是https://api.crazyrouter.com/v1,OpenAI相容SDK直接填這個位址即可,東亞節點cn.crazyrouter.com同配置可試。它的價值是一個入口呼叫多家模型,但不覆蓋DeepSeek的私有協定能力。

要完整複刻App、開箱即用連網搜尋,走官方介面;已經用閘道調對話和語音、要的是繁體輸出,閘道這邊語音兩端夠用,搜尋和讀連結按需在客戶端補。動手前先拿自己那句真實提問跑一遍回傳,看清楚是模型發起還是服務端執行,也順手確認轉寫出來的繁體和語音音色合不合你的使用者。

👉 想直接上手,可這裡取得 API Key:https://crazyrouter.com/en/pricing?utm_source=codelove&utm_medium=article&utm_campaign=offsite_article&utm_content=cr_f551e3c0288c_bottom_cta


一名对 AI 领域充满热情的爱好者。平时喜欢关注最新的模型发展,也会自己动手测试不同的 API 和提示词(Prompt)

共有 0 則留言


一名对 AI 领域充满热情的爱好者。平时喜欢关注最新的模型发展,也会自己动手测试不同的 API 和提示词(Prompt)
🏆 本月排行榜
🥇
boluoji
📝50   💬3   ❤️8
1,259
🥈
我愛JS
📝3   💬1   ❤️5
145
🥉
站長阿川
📝2   💬3   ❤️2
58
評分標準:發文×10 + 留言×3 + 獲讚×5 + 點讚×1 + 瀏覽數÷10
本數據每小時更新一次