2. 創建密鑰

在 賬戶信息中找到API Key 管理菜單,并創建新的密鑰

填寫一個 API 密鑰的名稱并創建

在彈出的對話框中復制 API 密鑰,并妥善保存

3. 快速接入

復制完整代碼并執行

Kimi API 提供了與 Kimi 大模型交互的能力,以下是一個簡單示例代碼:

from openai import OpenAI

client = OpenAI(
api_key="MOONSHOT_API_KEY", # 在這里將 MOONSHOT_API_KEY 替換為你從 Kimi 開放平臺申請的 API Key
base_url="https://api.moonshot.cn/v1",
)

completion = client.chat.completions.create(
model = "moonshot-v1-8k",
messages = [
{"role": "system", "content": "你是 Kimi,由 Moonshot AI 提供的人工智能助手,你更擅長中文和英文的對話。你會為用戶提供安全,有幫助,準確的回答。同時,你會拒絕一切涉及恐怖主義,種族歧視,黃色暴力等問題的回答。Moonshot AI 為專有名詞,不可翻譯成其他語言。"},
{"role": "user", "content": "你好,我叫李雷,1+1等于多少?"}
],
temperature = 0.3,
)

# 通過 API 我們獲得了 Kimi 大模型給予我們的回復消息(role=assistant)
print(completion.choices[0].message.content)

為了成功運行上述代碼,你可能需要準備:

  1. Python 環境 或 Node.js 環境,我們推薦使用 Python 3.8 及以上版本的 Python 解釋器;
  2. OpenAI SDK,我們的 API 完全兼容 OpenAI 的 API 格式,因此你可以直接使用 Python 或 Node.js OpenAI SDK 進行調用,你可以通過如下方式來安裝 OpenAI SDK:pip install --upgrade 'openai>=1.0' #Pythonnpm install openai@latest #Node.js
  3. 將你從 Kimi 開放平臺申請的 API Key,將其傳入 OpenAi Client 以便于我們能正確識別你的身份;

如果您成功運行上述代碼,且沒有任何報錯,那么您將看到類似如下的內容輸出:

你好,李雷!1+1 等于 2。這是一個基本的數學加法問題。如果你有其他問題或需要幫助,請隨時告訴我。

字段說明

字段是否必須說明類型取值
messagesrequired包含迄今為止對話的消息列表List[Dict]這是一個結構體的列表,每個元素類似如下:{"role": "user", "content": "你好"} role 只支持 system,user,assistant 其一,content 不得為空
modelrequiredModel ID, 可以通過 List Models 獲取string目前是 moonshot-v1-8k,moonshot-v1-32k,moonshot-v1-128k 其一
max_tokensoptional聊天完成時生成的最大 token 數。如果到生成了最大 token 數個結果仍然沒有結束,finish reason 會是 “length”, 否則會是 “stop”int這個值建議按需給個合理的值,如果不給的話,我們會給一個不錯的整數比如 1024。特別要注意的是,這個 max_tokens 是指您期待我們返回的 token 長度,而不是輸入 + 輸出的總長度。比如對一個 moonshot-v1-8k 模型,它的最大輸入 + 輸出總長度是 8192,當輸入 messages 總長度為 4096 的時候,您最多只能設置為 4096,否則我們服務會返回不合法的輸入參數( invalid_request_error ),并拒絕回答。如果您希望獲得“輸入的精確 token 數”,可以使用下面的“計算 Token” API 使用我們的計算器獲得計數
temperatureoptional使用什么采樣溫度,介于 0 和 1 之間。較高的值(如 0.7)將使輸出更加隨機,而較低的值(如 0.2)將使其更加集中和確定性float默認為 0,如果設置,值域須為 [0, 1] 我們推薦 0.3,以達到較合適的效果
top_poptional另一種采樣方法,即模型考慮概率質量為 top_p 的標記的結果。因此,0.1 意味著只考慮概率質量最高的 10% 的標記。一般情況下,我們建議改變這一點或溫度,但不建議 同時改變float默認 1.0
noptional為每條輸入消息生成多少個結果int默認為 1,不得大于 5。特別的,當 temperature 非常小靠近 0 的時候,我們只能返回 1 個結果,如果這個時候 n 已經設置并且 > 1,我們的服務會返回不合法的輸入參數(invalid_request_error)
presence_penaltyoptional存在懲罰,介于-2.0到2.0之間的數字。正值會根據新生成的詞匯是否出現在文本中來進行懲罰,增加模型討論新話題的可能性float默認為 0
frequency_penaltyoptional頻率懲罰,介于-2.0到2.0之間的數字。正值會根據新生成的詞匯在文本中現有的頻率來進行懲罰,減少模型一字不差重復同樣話語的可能性float默認為 0
response_formatoptional設置為 {"type": "json_object"} 可啟用 JSON 模式,從而保證模型生成的信息是有效的 JSON。當你將 response_format 設置為 {"type": "json_object"} 時,你需要在 prompt 中明確地引導模型輸出 JSON 格式的內容,并告知模型該 JSON 的具體格式,否則將可能導致不符合預期的結果object默認為 {“type”: “text”}
stopoptional停止詞,當全匹配這個(組)詞后會停止輸出,這個(組)詞本身不會輸出。最多不能超過 5 個字符串,每個字符串不得超過 32 字節String, List[String]默認 null
streamoptional是否流式返回bool默認 false, 可選 true

4. 常見問題

Q:如何找到Moonshot AI

A:冪簡集成是國內領先的API集成管理平臺,專注于為開發者提供全面、高效、易用的API集成解決方案。冪簡API平臺可以通過以下兩種方式找到所需API:通過關鍵詞搜索API(例如,輸入’Moonshot AI ‘這類品類詞,更容易找到結果)、或者從API hub分類頁進入尋找。

Q:為什么 API 返回的結果和 Kimi 智能助手返回的結果不一致?
A:API 和 Kimi 智能助手使用的是同一模型,如果你發現模型輸出結果不一致,可以嘗試修改 System Prompt,Kimi 智能助手的 System Prompt,可以參考這里(opens in a new tab)的例子;另一方面 Kimi 智能助手提供了諸如計算器等工具,而 API 并未默認提供這些工具,需要用戶自行組裝;

Q:Kimi API 是否擁有 Kimi 智能助手的“上網沖浪”功?
A:現在,Kimi API 提供了聯網搜索功能,請查閱我們的指南:使用 Kimi API 的聯網搜索功能。如果你想自己通過 Kimi API 實現聯網搜索功能,也可以參考我們撰寫的工具調用 tool_calls 指南

Q:Kimi API 返回的內容不完整或被截斷?
A:如果你發現 Kimi API 返回的內容不完整、被截斷或長度不符合預期,你可以先檢查響應體中的 choice.finish_reason 字段的值,如果該值為 length,則表明當前模型生成內容所包含的 Tokens 數量超過請求中的 max_tokens 參數,在這種情況下,Kimi API 僅會返回 max_tokens 個 Tokens 內容,多余的內容將會被丟棄,即上文所說“內容不完整”或“內容被截斷”。

Q:Kimi 大模型的輸出長度是多少?
A:

Q:文件抽取內容不準確、圖像無法被識別

A:我們提供各種格式的文件上傳和文件解析服務,對于文本文件,我們會提取文件中的文字內容;對于圖片文件,我們會使用 OCR 識別圖片中的文字;對于 PDF 文檔,如果 PDF 文檔中只包含圖片,我們會使用 OCR 提取圖片中的文字,否則僅會提取文本內容。;注意,對于圖片,我們只會使用 OCR 提取圖片中的文字內容,因此如果你的圖片中不包含任何文字內容,則會引起解析失敗的錯誤。

Q:Moonshot AI 的替代品有哪些?

提供AI大模型API的服務商除了Moonshot AI ,還有其他替代服務商也提供類似api服務,例如:

360多模態大語言模型語音大模型服務MiniMax-稀宇科技通用大模型開放平臺-華藏訊飛星火認知大模型

更多競品可以在冪簡集成開放平臺中找到。

Q:通義千問API這個密鑰還適用于哪些api?

語音生成視頻生成音樂生成

5.  總結

本文為開發者提供了獲取Moonshot AI 密鑰的詳細分步指南,從注冊賬號到完成開發者認證,直至獲取密鑰,每一步都清晰明了。此外,還強調了獲取密鑰后進行測試的重要性,以確保順利集成API至應用中。本文為開發者提供了一個全面、實用的指南,幫助他們順利獲取Moonshot AI 密鑰,并有效地將這一能力集成到應用中,從而提升應用的交互性和功能性。

上一篇:

如何獲取Deepseek API key 密鑰(分步指南)

下一篇:

如何獲取Minimax API Key 密鑰(分步指南)
#你可能也喜歡這些API文章!

我們有何不同?

API服務商零注冊

多API并行試用

數據驅動選型,提升決策效率

查看全部API→
??

熱門場景實測,選對API

#AI文本生成大模型API

對比大模型API的內容創意新穎性、情感共鳴力、商業轉化潛力

25個渠道
一鍵對比試用API 限時免費

#AI深度推理大模型API

對比大模型API的邏輯推理準確性、分析深度、可視化建議合理性

10個渠道
一鍵對比試用API 限時免費