Kimi 系列

月之暗面的 Kimi 模型，包括 Kimi K3、K2.6 與專為程式設計打造的 K2.7 Code。透過 OpenAI 相容介面呼叫，同時支援 Anthropic 原生介面，可在 Claude Code 中使用。

常見任務

模型

完整的模型清單與即時價格請參閱模型頁 。模型 ID 的前綴為 moonshotai/，可省略。

Kimi 模型由月之暗面官方（moonshot）提供，部分模型另有 Azure AI Foundry、阿里雲百煉等供應商，預設自動選擇。指定方法見供應商路由。

呼叫範例

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="moonshotai/kimi-k3",
    messages=[{"role": "user", "content": "用一句話解釋什麼是冪等性。"}],
    extra_body={"thinking": {"type": "disabled"}},
)
print(resp.choices[0].message.content)

curl https://api.ofox.ai/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moonshotai/kimi-k3",
    "messages": [{"role": "user", "content": "用一句話解釋什麼是冪等性。"}],
    "thinking": {"type": "disabled"}
  }'

思考模式

實測同一道數學題：Kimi K3 預設約 30 秒，關閉思考後約 3 秒；K2.6 預設思考約 1.1 萬 token、耗時約 4.5 分鐘，關閉思考後約 40 秒。思考 token 按輸出單價計費，數量見 usage.completion_tokens_details.reasoning_tokens。

讀取思考內容：串流回應中位於 delta.reasoning_content；非串流回應中位於 message.reasoning_details，請將各項的 text 依序串接。

網路搜尋

在 Responses 介面的 tools 中加入 web_search，模型會自行搜尋並在回答中附上引用來源：

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.responses.create(
    model="moonshotai/kimi-k3",
    tools=[{"type": "web_search"}],
    input="Python 最新的穩定版本是多少？",
)
print(resp.output_text)
for item in resp.output:
    if item.type == "message":
        for part in item.content:
            for a in getattr(part, "annotations", None) or []:
                print("來源:", a.title, a.url)

• 實測 Kimi K3 與 K2.6 支援。output 中依序出現 reasoning、web_search_call 與 message 項目，引用來源位於 message 內容的 annotations 中。
• 搜尋按次計費，單價見模型頁 。

在 Claude Code 中使用

Kimi 模型支援 Anthropic 原生介面，位址為 https://api.ofox.ai/anthropic：

透過 Anthropic 介面呼叫時，思考內容以 thinking 區塊返回。Claude Code 的完整設定步驟見 Claude Code 設定。

圖片輸入與結構化輸出

• Kimi K3、K2.6 支援圖片輸入，使用標準的 image_url 內容區塊，寫法見視覺理解。
• response_format 支援 json_schema 與 json_object；工具呼叫使用標準的 tools 參數。寫法見結構化輸出。
• 自動快取重複的請求前綴，命中量見 usage.prompt_tokens_details.cached_tokens。

常見錯誤

其他通用錯誤見錯誤處理。

官方文件

• Kimi 開放平台 · 文件 

常見問題