2. 進(jìn)入騰訊云控制臺(tái)

3. 進(jìn)入 混元大模型 并點(diǎn)擊 API KEY 管理

創(chuàng)建一個(gè) API 密鑰

4. 發(fā)起請(qǐng)求

1. 輸入?yún)?shù)

以下請(qǐng)求參數(shù)列表僅列出了接口請(qǐng)求參數(shù)和部分公共參數(shù),完整公共參數(shù)列表見(jiàn) 公共請(qǐng)求參數(shù)。

參數(shù)名稱必選類型描述
ActionString本接口取值:RunThread。
VersionString本接口取值:2023-09-01。
RegionString此參數(shù)為可選參數(shù)。
ThreadIDString會(huì)話 ID
示例值:thread_OteLtAcmh7prn7tb8uQ3SJzh
AssistantIDString助手 ID
示例值:asst_x39o8phGyiIC8llpaVShxVmL
ModelString模型名稱,可選值包括 hunyuan-lite、hunyuan-standard、hunyuan-standard-256K、hunyuan-pro、 hunyuan-code、 hunyuan-role、 hunyuan-functioncall、 hunyuan-vision、 hunyuan-turbo。各模型介紹請(qǐng)閱讀 產(chǎn)品概述 中的說(shuō)明。注意:不同的模型計(jì)費(fèi)不同,請(qǐng)根據(jù) 購(gòu)買指南 按需調(diào)用。
示例值:hunyuan-pro
AdditionalMessages.NArray of ThreadAdditionalMessage附加消息
示例值:[]
TemperatureFloat說(shuō)明:1. 影響模型輸出多樣性,模型已有默認(rèn)參數(shù),不傳值時(shí)使用各模型推薦值,不推薦用戶修改。2. 取值區(qū)間為 [0.0, 2.0]。較高的數(shù)值會(huì)使輸出更加多樣化和不可預(yù)測(cè),而較低的數(shù)值會(huì)使其更加集中和確定。
TopPFloat說(shuō)明:1. 影響輸出文本的多樣性。模型已有默認(rèn)參數(shù),不傳值時(shí)使用各模型推薦值,不推薦用戶修改。2. 取值區(qū)間為 [0.0, 1.0]。取值越大,生成文本的多樣性越強(qiáng)。
StreamBoolean是否流式輸出,當(dāng)前只允許 true
示例值:true
MaxPromptTokensInteger運(yùn)行過(guò)程中可使用的 token 最大數(shù)量。
示例值:0
MaxCompletionTokensInteger運(yùn)行過(guò)程中可使用的完成 token 的最大數(shù)量。
示例值:0
Tools.NArray of Tool可調(diào)用的工具列表,僅對(duì) hunyuan-pro、hunyuan-turbo、hunyuan-functioncall 模型生效。
ToolChoiceString工具使用選項(xiàng),可選值包括 none、auto、custom。說(shuō)明:1. 僅對(duì) hunyuan-pro、hunyuan-turbo、hunyuan-functioncall 模型生效。2. none:不調(diào)用工具;auto:模型自行選擇生成回復(fù)或調(diào)用工具;custom:強(qiáng)制模型調(diào)用指定的工具。3. 未設(shè)置時(shí),默認(rèn)值為auto
示例值:auto
2. 輸出參數(shù)
參數(shù)名稱類型描述
RequestIdString唯一請(qǐng)求 ID,由服務(wù)端生成,每次請(qǐng)求都會(huì)返回(若請(qǐng)求因其他原因未能抵達(dá)服務(wù)端,則該次請(qǐng)求不會(huì)獲得 RequestId)。定位問(wèn)題時(shí)需要提供該次請(qǐng)求的 RequestId。本接口為流式響應(yīng)接口,當(dāng)請(qǐng)求成功時(shí),RequestId 會(huì)被放在 HTTP 響應(yīng)的 Header “X-TC-RequestId” 中。
3. 示例
示例1 執(zhí)行會(huì)話
輸入示例
POST / HTTP/1.1
Host: hunyuan.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: RunThread
<公共請(qǐng)求參數(shù)>

{
"ThreadID": "thread_zqkehzQBog4v4lJxBPQRXtYW",
"Model": "hunyuan-pro",
"AdditionalMessages": [
{
"Role": "user",
"Content": "你是誰(shuí)"
}
],
"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
}
4. 錯(cuò)誤碼

以下僅列出了接口業(yè)務(wù)邏輯相關(guān)的錯(cuò)誤碼,其他錯(cuò)誤碼詳見(jiàn) 公共錯(cuò)誤碼。

錯(cuò)誤碼描述
FailedOperation.EngineRequestTimeout引擎層請(qǐng)求超時(shí);請(qǐng)稍后重試。
FailedOperation.EngineServerError引擎層內(nèi)部錯(cuò)誤;請(qǐng)稍后重試。
FailedOperation.EngineServerLimitExceeded引擎層請(qǐng)求超過(guò)限額;請(qǐng)稍后重試。
FailedOperation.FreeResourcePackExhausted免費(fèi)資源包余量已用盡,請(qǐng)購(gòu)買資源包或開(kāi)通后付費(fèi)。
FailedOperation.ResourcePackExhausted資源包余量已用盡,請(qǐng)購(gòu)買資源包或開(kāi)通后付費(fèi)。
FailedOperation.ServiceNotActivated服務(wù)未開(kāi)通,請(qǐng)前往控制臺(tái)申請(qǐng)?jiān)囉谩?/td>
FailedOperation.ServiceStop用戶主動(dòng)停服。
FailedOperation.ServiceStopArrears欠費(fèi)停服。
InternalError內(nèi)部錯(cuò)誤。
InvalidParameter參數(shù)錯(cuò)誤。
InvalidParameterValue參數(shù)取值錯(cuò)誤。
InvalidParameterValue.Model模型不存在。
LimitExceeded超過(guò)配額限制。

5. 常見(jiàn)問(wèn)題

Q:如何找到騰訊混元API

A:冪簡(jiǎn)集成是國(guó)內(nèi)領(lǐng)先的API集成管理平臺(tái),專注于為開(kāi)發(fā)者提供全面、高效、易用的API集成解決方案。冪簡(jiǎn)API平臺(tái)可以通過(guò)以下兩種方式找到所需API:通過(guò)關(guān)鍵詞搜索API(例如,輸入’騰訊混元API‘這類品類詞,更容易找到結(jié)果)、或者從API hub分類頁(yè)進(jìn)入尋找。

Q:提示錯(cuò)誤碼 10060 時(shí)如何處理?

A:當(dāng)出現(xiàn) Socket error 10060 - Connection timed out 錯(cuò)誤碼提示時(shí),實(shí)際是 Socket 編程接口給出的錯(cuò)誤,表示網(wǎng)絡(luò)連接超時(shí)。您的機(jī)器將無(wú)法和騰訊云云 API 服務(wù)器進(jìn)行連通,請(qǐng)排查以下問(wèn)題:本地訪問(wèn)外網(wǎng)是否需要設(shè)置代理。本地機(jī)器防火墻是否有限制外訪的規(guī)則。路由器是否有限制外訪的規(guī)則。

Q:騰訊云 API 的錯(cuò)誤碼有哪些?

A:騰訊云 API 的錯(cuò)誤碼通常分為公共錯(cuò)誤碼和非公共錯(cuò)誤碼:公共錯(cuò)誤碼:您可以前往各產(chǎn)品文檔中的 API 文檔 > 調(diào)用方式 > 返回結(jié)果,在返回結(jié)果文檔中進(jìn)行查看。非公共錯(cuò)誤碼:您可以在具體的接口文檔中查看,例如,查看 創(chuàng)建實(shí)例 接口的錯(cuò)誤碼。

Q: .NET 依賴沖突

A:SDK 依賴的 FluentClient 使用的是3.2版本,但 FluentClient 目前發(fā)布了4.0版本且不兼容低版本,若在 nuget 中升級(jí)此包到4.0版本會(huì)導(dǎo)致無(wú)法調(diào)用或調(diào)用失敗等問(wèn)題。

Q: 舊版 SDK

A:舊版本 SDK 已不再維護(hù),推薦使用新版 SDK。舊版本 SDK 存放在 QcloudApi 目錄下,詳情請(qǐng)參見(jiàn) 舊版 SDK。

Q: DigiCert 根證書升級(jí)說(shuō)明

A:受知名瀏覽器廠商 Mozilla 的根證書信任策略更新影響(全球所有 CA 的可信根證書使用年限是15年更換一次,超過(guò)時(shí)間的可信根證書將會(huì)逐步被 Mozilla 停止信任,詳情請(qǐng)參見(jiàn) 官方說(shuō)明),DigiCert 部分舊根證書將逐步升級(jí)為新根體系(G2)證書。由于騰訊云 API 的域名使用了 DigiCert 簽發(fā)的證書,為保障用戶請(qǐng)求不受影響,云 API 計(jì)劃將舊證書升級(jí)為最新的 G2 根體系證書。為保障您的業(yè)務(wù)不受影響,建議及時(shí)驗(yàn)證與更新環(huán)境上的根證書及中間證書。

Q:提供AI大模型 API的服務(wù)商除騰訊混元API,還有其他替代服務(wù)商也提供類似api服務(wù),例如:

A:360多模態(tài)大語(yǔ)言模型語(yǔ)音大模型服務(wù)MiniMax-稀宇科技、通用大模型開(kāi)放平臺(tái)-華藏、訊飛星火認(rèn)知大模型

更多競(jìng)品可以在冪簡(jiǎn)集成開(kāi)放平臺(tái)中找到。

Q:騰訊混元API秘鑰還適用于哪些api?

A:人臉識(shí)別、圖像理解、聲音工坊 TTSW

6.  總結(jié)

本文詳細(xì)概述了獲取騰訊混元API密鑰的完整流程,從注冊(cè)騰訊云賬號(hào)成為開(kāi)發(fā)者,到申請(qǐng)并獲取API密鑰,每一步都進(jìn)行了詳盡的闡述。同時(shí),本文還強(qiáng)調(diào)了在使用API過(guò)程中需要注意的鑒權(quán)認(rèn)證機(jī)制、密鑰的安全管理以及API調(diào)用的基本規(guī)則等關(guān)鍵因素,旨在幫助開(kāi)發(fā)者更加高效、安全地將騰訊混元API集成到應(yīng)用中,從而提升應(yīng)用的文本生成能力和用戶體驗(yàn)。

上一篇:

如何獲取Minimax API Key 密鑰(分步指南)

下一篇:

如何獲取零一萬(wàn)物 API Key 密鑰(分步指南)
#你可能也喜歡這些API文章!

我們有何不同?

API服務(wù)商零注冊(cè)

多API并行試用

數(shù)據(jù)驅(qū)動(dòng)選型,提升決策效率

查看全部API→
??

熱門場(chǎng)景實(shí)測(cè),選對(duì)API

#AI文本生成大模型API

對(duì)比大模型API的內(nèi)容創(chuàng)意新穎性、情感共鳴力、商業(yè)轉(zhuǎn)化潛力

25個(gè)渠道
一鍵對(duì)比試用API 限時(shí)免費(fèi)

#AI深度推理大模型API

對(duì)比大模型API的邏輯推理準(zhǔn)確性、分析深度、可視化建議合理性

10個(gè)渠道
一鍵對(duì)比試用API 限時(shí)免費(fèi)