部落格 / 排障指南

Kimi K3 API 價格與快取寫入費：5 分鐘還是 1 小時 TTL，moonshot-v1 返回 404 怎麼辦

2026-10-19cdnping 編輯部約 3 分鐘讀完

Kimi K3 API 價格按每百萬 token 計：快取命中輸入 ¥2，未命中輸入 ¥20，輸出 ¥100，上下文 1,048,576 tokens；另外多了一項快取寫入費，5 分鐘 TTL 為 ¥20，1 小時 TTL 為 ¥40。如果你的老專案最近突然返回 404，多半是用了已下線的 kimi-k2.5 或 moonshot-v1 系列，需要遷移到 K3 或其他在售模型。

以下內容截至 2026 年 10 月，依據 Kimi 開放平臺的定價頁和更新日誌。價格可能調整，下單前請再看一遍官方頁面。

#K3 的價格到底怎麼算？

定價頁給出的 kimi-k3 價格（單位：每百萬 token）：

同一頁還列了幾個價格更低的選項，上下文都是 262,144 tokens，頁面沒有為它們列快取寫入費和 TTL 檔位：

選哪個取決於任務：需要百萬級上下文或更強能力才值得上 K3，日常程式碼類任務可以先在便宜的型號上跑一遍，再比較結果。

#快取寫入費是什麼，TTL 怎麼選？

按定價頁的說明，快取分 5 分鐘和 1 小時兩檔，不指定時預設 5 分鐘。在有效期內命中，只按快取命中價計費；命中會自動續期，不會再收一次寫入費。具體怎麼在請求裡指定 TTL，以官方文件為準。

選擇的關鍵是你的請求間隔。下面是一個假設的例子，只用來演示演算法：一段 10 萬 token 的固定字首，連續呼叫 20 次，只計這段字首的輸入費用，並假設首次請求只收寫入費、不再額外按未命中計費（實際以賬單為準）。

結論很直接：請求密集、間隔不到 5 分鐘，用 5 分鐘檔更省；間隔拉長到 5 分鐘以上又在 1 小時之內，1 小時檔更划算；字首每次都變，快取就沒有意義，寫入費反而是多出來的成本。上線後建議用一週的真實賬單校準這些假設，核對方法見《API 計費不對怎麼查》。

#呼叫返回 404，怎麼判斷是模型下線還是服務故障？

更新日誌在 2026 年 8 月寫明：kimi-k2.5 和 moonshot-v1 全系列（包括 vision-preview 和 moonshot-v1-auto）在所有國內外平臺下線，之後呼叫返回 404，官方建議遷移到 K3。日誌只寫了月份，沒有具體日期。

排查可以按這個順序：

1. 先看請求裡的 model 欄位。是 kimi-k2.5 或 moonshot-v1-* 的，就是已下線，不是網路問題。
2. 換成 kimi-k3 或表中其他在售模型，同一個 Key 再請求一次。成功就說明是下線。
3. 仍然失敗，再看是不是故障：開啟 /down/kimi 和 /status/moonshot，對照官方狀態與 cdnping 的探測結果。
4. 狀態正常但自己這裡不通，再按《ChatGPT 掛了嗎？三步判斷》的思路分清是服務端還是本地網路，同樣適用於 Kimi。

遷移時還要注意：K3 的價格和舊模型不同，換模型名之前先估一下月成本；輸出單價是表中最高的一檔。

#檔案介面變了什麼，要檢查什麼？

同一份更新日誌裡，檔案介面有這些變化：

• 新生成的檔案 ID 統一帶 file_ 字首。
• 表格、公式等複雜內容的解析有改進。
• 圖片不再做 OCR 文字提取；要做圖片理解，需用 purpose=image 上傳。
• 同名檔案上傳時，服務端會自動重新命名新檔案。

對照檢查清單：

• 程式碼裡有沒有按舊 ID 格式寫正則或長度校驗。
• 有沒有用檔案介面上傳圖片，再依賴 OCR 結果的流程；有的話改為 purpose=image。
• 有沒有靠檔名唯一性去查詢檔案；同名會被重新命名，改用返回的 ID。
• 解析結果有變化的表格和公式類文件，重跑一遍驗收樣例。

#怎麼不再被下線和調價打個措手不及？

模型下線和價格變動通常先出現在官方更新日誌裡。cdnping 的 /changes 會監控多家官方的更新日誌和價格頁，逐行記錄增刪並提供 RSS；整套追蹤方法見《大模型 API 價格變了怎麼第一時間知道》。Kimi 開放平臺近期的其他改動，可以看《Kimi 開放平臺 9 月更新》。如果在考慮官方直連之外的接入方式，《AI API 接入方式怎麼選》有對照。

#參考來源

• Kimi 開放平臺：Chat 定價
• Kimi 開放平臺：更新日誌