創建一個 API 密鑰
以下請求參數列表僅列出了接口請求參數和部分公共參數，完整公共參數列表見 公共請求參數。
| 參數名稱 | 必選 | 類型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 本接口取值：RunThread。 |
| Version | 是 | String | 本接口取值：2023-09-01。 |
| Region | 否 | String | 此參數為可選參數。 |
| ThreadID | 是 | String | 會話 ID 示例值：thread_OteLtAcmh7prn7tb8uQ3SJzh |
| AssistantID | 否 | String | 助手 ID 示例值：asst_x39o8phGyiIC8llpaVShxVmL |
| Model | 否 | String | 模型名稱，可選值包括 hunyuan-lite、hunyuan-standard、hunyuan-standard-256K、hunyuan-pro、 hunyuan-code、 hunyuan-role、 hunyuan-functioncall、 hunyuan-vision、 hunyuan-turbo。各模型介紹請閱讀 產品概述 中的說明。注意：不同的模型計費不同，請根據 購買指南 按需調用。 示例值：hunyuan-pro |
| AdditionalMessages.N | 否 | Array of ThreadAdditionalMessage | 附加消息 示例值：[] |
| Temperature | 否 | Float | 說明：1. 影響模型輸出多樣性，模型已有默認參數，不傳值時使用各模型推薦值，不推薦用戶修改。2. 取值區間為 [0.0, 2.0]。較高的數值會使輸出更加多樣化和不可預測，而較低的數值會使其更加集中和確定。 |
| TopP | 否 | Float | 說明：1. 影響輸出文本的多樣性。模型已有默認參數，不傳值時使用各模型推薦值，不推薦用戶修改。2. 取值區間為 [0.0, 1.0]。取值越大，生成文本的多樣性越強。 |
| Stream | 否 | Boolean | 是否流式輸出，當前只允許 true 示例值：true |
| MaxPromptTokens | 否 | Integer | 運行過程中可使用的 token 最大數量。 示例值：0 |
| MaxCompletionTokens | 否 | Integer | 運行過程中可使用的完成 token 的最大數量。 示例值：0 |
| Tools.N | 否 | Array of Tool | 可調用的工具列表，僅對 hunyuan-pro、hunyuan-turbo、hunyuan-functioncall 模型生效。 |
| ToolChoice | 否 | String | 工具使用選項，可選值包括 none、auto、custom。說明：1. 僅對 hunyuan-pro、hunyuan-turbo、hunyuan-functioncall 模型生效。2. none：不調用工具；auto：模型自行選擇生成回復或調用工具；custom：強制模型調用指定的工具。3. 未設置時，默認值為auto 示例值：auto |
| 參數名稱 | 類型 | 描述 |
|---|---|---|
| RequestId | String | 唯一請求 ID，由服務端生成，每次請求都會返回（若請求因其他原因未能抵達服務端，則該次請求不會獲得 RequestId）。定位問題時需要提供該次請求的 RequestId。本接口為流式響應接口，當請求成功時，RequestId 會被放在 HTTP 響應的 Header “X-TC-RequestId” 中。 |
POST / HTTP/1.1
Host: hunyuan.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: RunThread
<公共請求參數>
{
"ThreadID": "thread_zqkehzQBog4v4lJxBPQRXtYW",
"Model": "hunyuan-pro",
"AdditionalMessages": [
{
"Role": "user",
"Content": "你是誰"
}
],
"Stream": true
}{
"ID": "run_cRpe4PGgXxTwwvuee55anOO4",
"Object": "thread.run",
"CreatedAt": 1727355339,
"ThreadID": "thread_zqkehzQBog4v4lJxBPQRXtYW",
"AssistantID": "",
"Status": "created",
"RequiredAction": null,
"LastError": null,
"ExpiresAt": 0,
"StartedAt": 0,
"CancelledAt": 0,
"FailedAt": 0,
"CompletedAt": 0,
"InCompleteDetails": null,
"Model": "hunyuan",
"Instructions": "",
"Tools": [],
"Metadata": {},
"Usage": null,
"Temperature": 0,
"TopP": 0,
"MaxPromptTokens": 0,
"MaxCompletionTokens": 0,
"TruncationStrategy": {
"Type": "",
"LastMessages": null
},
"ParallelToolCalls": false,
"ResponseFormat": null
}以下僅列出了接口業務邏輯相關的錯誤碼，其他錯誤碼詳見 公共錯誤碼。
| 錯誤碼 | 描述 |
|---|---|
| FailedOperation.EngineRequestTimeout | 引擎層請求超時；請稍后重試。 |
| FailedOperation.EngineServerError | 引擎層內部錯誤；請稍后重試。 |
| FailedOperation.EngineServerLimitExceeded | 引擎層請求超過限額；請稍后重試。 |
| FailedOperation.FreeResourcePackExhausted | 免費資源包余量已用盡，請購買資源包或開通后付費。 |
| FailedOperation.ResourcePackExhausted | 資源包余量已用盡，請購買資源包或開通后付費。 |
| FailedOperation.ServiceNotActivated | 服務未開通，請前往控制臺申請試用。 |
| FailedOperation.ServiceStop | 用戶主動停服。 |
| FailedOperation.ServiceStopArrears | 欠費停服。 |
| InternalError | 內部錯誤。 |
| InvalidParameter | 參數錯誤。 |
| InvalidParameterValue | 參數取值錯誤。 |
| InvalidParameterValue.Model | 模型不存在。 |
| LimitExceeded | 超過配額限制。 |
Q：如何找到騰訊混元API
A：冪簡集成是國內領先的API集成管理平臺，專注于為開發者提供全面、高效、易用的API集成解決方案。冪簡API平臺可以通過以下兩種方式找到所需API：通過關鍵詞搜索API(例如，輸入’騰訊混元API‘這類品類詞，更容易找到結果)、或者從API hub分類頁進入尋找。
Q：提示錯誤碼 10060 時如何處理？
A：當出現 Socket error 10060 - Connection timed out 錯誤碼提示時，實際是 Socket 編程接口給出的錯誤，表示網絡連接超時。您的機器將無法和騰訊云云 API 服務器進行連通，請排查以下問題：本地訪問外網是否需要設置代理。本地機器防火墻是否有限制外訪的規則。路由器是否有限制外訪的規則。
Q：騰訊云 API 的錯誤碼有哪些？
A：騰訊云 API 的錯誤碼通常分為公共錯誤碼和非公共錯誤碼：公共錯誤碼：您可以前往各產品文檔中的 API 文檔 > 調用方式 > 返回結果，在返回結果文檔中進行查看。非公共錯誤碼：您可以在具體的接口文檔中查看，例如，查看 創建實例 接口的錯誤碼。
Q： .NET 依賴沖突
A：SDK 依賴的 FluentClient 使用的是3.2版本，但 FluentClient 目前發布了4.0版本且不兼容低版本，若在 nuget 中升級此包到4.0版本會導致無法調用或調用失敗等問題。
Q： 舊版 SDK
A：舊版本 SDK 已不再維護，推薦使用新版 SDK。舊版本 SDK 存放在 QcloudApi 目錄下，詳情請參見 舊版 SDK。
Q： DigiCert 根證書升級說明
A：受知名瀏覽器廠商 Mozilla 的根證書信任策略更新影響（全球所有 CA 的可信根證書使用年限是15年更換一次，超過時間的可信根證書將會逐步被 Mozilla 停止信任，詳情請參見 官方說明），DigiCert 部分舊根證書將逐步升級為新根體系（G2）證書。由于騰訊云 API 的域名使用了 DigiCert 簽發的證書，為保障用戶請求不受影響，云 API 計劃將舊證書升級為最新的 G2 根體系證書。為保障您的業務不受影響，建議及時驗證與更新環境上的根證書及中間證書。
Q：提供AI大模型 API的服務商除騰訊混元API，還有其他替代服務商也提供類似api服務，例如：
A：360多模態大語言模型、語音大模型服務MiniMax-稀宇科技、通用大模型開放平臺-華藏、訊飛星火認知大模型
更多競品可以在冪簡集成開放平臺中找到。
Q：騰訊混元API秘鑰還適用于哪些api？
本文詳細概述了獲取騰訊混元API密鑰的完整流程，從注冊騰訊云賬號成為開發者，到申請并獲取API密鑰，每一步都進行了詳盡的闡述。同時，本文還強調了在使用API過程中需要注意的鑒權認證機制、密鑰的安全管理以及API調用的基本規則等關鍵因素，旨在幫助開發者更加高效、安全地將騰訊混元API集成到應用中，從而提升應用的文本生成能力和用戶體驗。