必须调用腾讯混元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，删掉其中一个即可。