混元 Hy3 API 怎么接入
最后更新:
在 KK 文本接口中填写 hy3，用短文本验证调用，再接入中文摘要、提取与问答任务。
用 hy3 发送第一条请求
Base URL 填 https://api.kkaiapi.com/v1，密钥使用 KKAIAPI Key，model 精确填写 hy3。下面先提取一段文本中的待办，适合确认消息格式与结果读取。
curl https://api.kkaiapi.com/v1/chat/completions \
-H "Authorization: Bearer $KKAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"hy3","messages":[{"role":"user","content":"从记录中提取负责人、任务和日期：小陈负责整理用户反馈，截止周四。没有写明的字段填未提供。"}]}'Hy3 的当前价格
KK 当前提供的 hy3 使用文本 Chat Completions 接口。输入和输出分别计费，历史消息也可能进入输入用量。将任务所需材料和预期输出一起估算，比仅按“调用一次”做预算更准确。
| 模型 | 模型 ID | 输入（CNY） | 输出（CNY） | 官方参考价（约数标记 ≈） |
|---|---|---|---|---|
| hy3 | hy3 | ¥0.9 / 1M tokens | ¥3.5 / 1M tokens | CNY 输入 ¥1 / 输出 ¥4 / 1M tokens；USD 输入 ≈$0.1 / 输出 ≈$0.5 / 1M tokens |
中文文档任务怎样组织输入
先把文档转换成可以核对的文字，保留标题、段落编号与原始出处。让模型输出结论时附上对应段落编号，缺失信息明确写“未提供”，再由应用或人工检查。把结论与原文对应起来，比只获得一段流畅摘要更适合业务使用。
例如处理会议记录，先约定负责人、任务、截止日期三项；处理长文，先限定要回答的问题和材料范围。不要把模型生成的日期或数字直接当成原文事实。
客户端里如何添加混元模型
在支持自定义 OpenAI 兼容服务的客户端中新增服务，填写 KK Base URL 与 Key，再手动添加 hy3。打开一个新会话发出短请求，确认用量记录出现在对应 KK 账户后，再保存为常用配置。
模型名字与应用功能是两层设置。本文接入的是文本模型；文档上传、文件解析、知识库检索等功能由客户端或你的程序完成。需要这些能力时，先确认工具能把处理后的内容发送给模型。
区分型号资料和接入接口
腾讯的 Hy3 发布资料介绍了模型背景。本页具体可用 ID、价格与请求路径来自 KK 当前目录，直接使用腾讯云时应按腾讯云的账号、密钥和接口文档配置。
如果应用要求 Anthropic Messages 或其他协议，不要仅凭“兼容多模型”就填写 hy3。先检查 KK 模型页支持的接口，再选择正确的客户端连接方式。
常见问题
混元在 KK 里的 model 填什么？
本页文本接入填写 hy3，大小写和符号按模型目录复制，不要填营销名称或自行添加版本后缀。
需要腾讯云的密钥吗？
通过 KKAIAPI 调用使用 KK 的 Key 和余额。腾讯云密钥用于腾讯云自己的接入方式。
可以直接把 PDF 文件放进这个请求吗？
本页示例发送文本消息。PDF 解析和检索应由支持该功能的应用完成，或先提取需要的文字再调用。
怎么确认提取结果可靠？
准备有标准答案的小样，检查字段、日期、数量与原文对应关系。缺失信息应保留为空或标明未提供，不让模型补造。