在调用腾讯混元向量化接口时，很多开发者第一步就陷入误区：误以为使用ChatCompletions聊天接口就能获取文本向量，实际上返回的是对话内容，不仅没有向量，还会按token消耗计费，造成不必要的开销。正确的做法是调用专用的GetEmbedding接口，该接口能生成1024维浮点数向量，广泛应用于语义检索、文本聚类和相似度计算等场景。下面详细拆解整个调用流程，从凭证准备到签名计算、请求发送、结果解析，每一步都有易错点，值得仔细了解。

准备身份凭证与开发环境

首先，登录腾讯云控制台，进入【访问管理】→【API密钥】页面，创建一对密钥（SecretId和SecretKey）。这对密钥是后续签名计算的关键凭证，切勿硬编码在代码中，生产环境下建议通过环境变量或密钥管理服务来安全存储。

接着，安装腾讯云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错误。

签名计算逻辑较为复杂，建议直接使用SDK封装好的方法，或参考官方示例代码手动实现。关键步骤：

• 在HTTP Header中必须显式设置X-TC-Action: GetEmbedding，这是区分向量化接口与聊天接口的关键标识，缺少该字段会导致请求默认路由到ChatCompletions。
• Content-Type需设置为application/json，否则会返回MalformedRequest错误。

发送请求并解析响应

向域名hunyuan.tencentcloudapi.com发送POST请求，请求体为JSON格式，例如：

{"Input": "人工智能正在改变世界"}

成功响应中，Data字段包含一个数组，每个元素包含：

• Embedding：float32类型的1024维列表
• Index：对应输入的顺序
• Object：固定值"embedding"

另外，Usage中的PromptTokens字段表示本次请求消耗的Token数量，用于计费。如果返回：

{"Error":{"Code":"InvalidParameter.InputAndInputList","Message":"Input and InputList cannot be both specified"}}

说明同时设置了Input和InputList.N，只需删除其中一个参数即可。该错误提示非常明确，按照提示操作即可。