区块链API推荐，快速开发去中心化应用
如何获取腾讯混元API密钥(分步指南)
2024-11-13
腾讯混元大模型是由腾讯精心研发的大语言模型。它拥有极为强大的中文创作能力，在复杂语境中也能展现出色的逻辑推理能力，并且还具备高度可靠的任务执行能力，能为用户提供优质、高效、精准的服务与支持。在当今数字化时代，腾讯混元API作为一款强大的文本生成与处理工具，已广泛应用于内容创作、客户服务、教育娱乐等多个领域。为了帮助你轻松解锁这一高效的文本处理能力，本文将分步指导你如何获取腾讯混元API的密钥。
1. 注册并登录腾讯云
2. 进入腾讯云控制台
3. 进入 混元大模型 并点击 API KEY 管理
创建一个 API 密钥
- 初次使用时需要完成账号认证
- 点击创建好的 API 密钥
- 在弹出的对话框中复制并保存 API 密钥
4. 发起请求
1. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| 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 |
2. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。本接口为流式响应接口，当请求成功时，RequestId 会被放在 HTTP 响应的 Header “X-TC-RequestId” 中。 |
3. 示例
示例1 执行会话
输入示例
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
}4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation.EngineRequestTimeout | 引擎层请求超时；请稍后重试。 |
| FailedOperation.EngineServerError | 引擎层内部错误；请稍后重试。 |
| FailedOperation.EngineServerLimitExceeded | 引擎层请求超过限额；请稍后重试。 |
| FailedOperation.FreeResourcePackExhausted | 免费资源包余量已用尽，请购买资源包或开通后付费。 |
| FailedOperation.ResourcePackExhausted | 资源包余量已用尽，请购买资源包或开通后付费。 |
| FailedOperation.ServiceNotActivated | 服务未开通，请前往控制台申请试用。 |
| FailedOperation.ServiceStop | 用户主动停服。 |
| FailedOperation.ServiceStopArrears | 欠费停服。 |
| InternalError | 内部错误。 |
| InvalidParameter | 参数错误。 |
| InvalidParameterValue | 参数取值错误。 |
| InvalidParameterValue.Model | 模型不存在。 |
| LimitExceeded | 超过配额限制。 |
5. 常见问题
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？
6. 总结
本文详细概述了获取腾讯混元API密钥的完整流程，从注册腾讯云账号成为开发者，到申请并获取API密钥，每一步都进行了详尽的阐述。同时，本文还强调了在使用API过程中需要注意的鉴权认证机制、密钥的安全管理以及API调用的基本规则等关键因素，旨在帮助开发者更加高效、安全地将腾讯混元API集成到应用中，从而提升应用的文本生成能力和用户体验。
同话题下的热门内容
