腾讯混元向量化接口如何调用
必须调用腾讯混元GetEmbedding接口生成1024维向量,不可误用ChatCompletions;需配置API密钥、安装SDK、构造合法请求(单文本或批量)、严格按v3签名规范组装请求头(含X-TC-Action: GetEmbedding),否则报错或计费异常。
要让文本变成1024维向量用于语义检索或聚类,必须调用腾讯混元的GetEmbedding接口,而不是误用ChatCompletions等聊天接口——后者不返回向量,且会按token计费更高。
准备身份凭证与环境
登录腾讯云控制台 → 进入【访问管理】→ 【API密钥】→ 创建新的密钥(secret_id + secret_key),并记录下来。这组密钥将用于签名计算,【切勿硬编码在代码中,生产环境必须使用环境变量或密钥管理服务】。
安装腾讯云 Python SDK:pip install tencentcloud-sdk-python。
确认 Python 版本 ≥ 3.8,否则 hmac 签名生成可能失败。
构造合法请求体
方法一:单文本向量化(最常用)
设置请求参数 Action=GetEmbedding、Version=2024-09-01;Input 字段填入待向量化的中文文本,注意总长度不能超过 1024 个 Token,超长会被自动截断末尾内容——这意味着“摘要前置”比“长尾补充”更安全。
方法二:批量文本向量化
使用 InputList.N 参数传入最多 50 个字符串组成的数组,例如 ["产品功能说明", "售后服务政策", "价格对比表"];此时 Input 字段必须留空,否则接口会报错 InvalidParameter.InputAndInputList。
签名与请求头组装
第一步:按腾讯云签名 v3 规范生成 Authorization 请求头,需包含 SecretId、Signature、SignedHeaders、X-TC-Timestamp 等字段;【跳过此步直接发请求必然返回 AuthFailure.SignatureFailure】。
第二步:在 HTTP Header 中显式设置 X-TC-Action: GetEmbedding,这是区分向量接口和聊天接口的关键标识——没有它,请求默认路由到 ChatCompletions。
第三步:Content-Type 必须为 application/json,否则返回 MalformedRequest。
发送请求并解析响应
向域名 hunyuan.tencentcloudapi.com 发起 POST 请求,Body 为 JSON 格式,示例:{"Input": "人工智能正在改变世界"}。
成功响应中 Data 字段是一个数组,每个元素含 Embedding(float32 类型的 1024 维列表)、Index 和 Object 字段;Usage 中 PromptTokens 表示本次实际消耗 token 数,按此计费。
若返回 {"Error":{"Code":"InvalidParameter.InputAndInputList","Message":"Input and InputList cannot be both specified"}},说明你同时设置了 Input 和 InputList.N,删掉其中一个即可。
-
07.24
世界之光手游创造之地怎么玩 世界之光手游创造之地详细玩法攻略
-
07.24
天堂2盟约 奥林匹克副本通关攻略|详细流程 职业搭配与BOSS机制解析
-
07.24
魔界战记 DISGAEA6 之父炮轰索尼取消光驱:称 PlayStation 干脆把主机也取消算了
-
07.24
新三国志曹操传阵容搭配指南 新三国志曹操传阵容搭配教程推荐
-
07.24
新三国志曹操传最强阵容推荐 新三国志曹操传最强阵容组建指南
-
07.24
天堂2盟约匕首加点攻略 天堂2盟约匕首职业玩法与技能搭配详解
-
-
-
- 可灵AI排队时间长有啥办法
- 07.24
-
- 智谱清言联网搜索怎样开启
- 07.24
-
- 可灵AI首尾帧如何做转场
- 07.24
-
- 秘塔AI搜索结果如何导出PDF
- 07.24
-
-
下载
- |
-
-
下载
- 《行尸走肉第一章》免安装中文汉化硬盘版下载
- 单机|436 MB
- 一款以动作冒险为主题的游戏
-
-
下载
- 《街头霸王X铁拳》免安装中文汉化硬盘版下载
- 单机|111MB
- 一款非常好玩的格斗游戏
-
-
下载
- |
-
-
下载
- 《暗黑破坏神3》免安装繁体中文正式版下载
- 单机|7630 MB
- 一款以角色扮演为主题的游戏
-
-
下载
- 《马克思佩恩3》免安装硬盘版下载
- 单机|27033 MB
- 一款以第三人称射击为主题的游戏