优先选openai兼容接口，若需混元特有功能（如长文本增强、来源引用、联网检索、多模态增强）则必须选原生接口。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在腾讯混元的原生接口和OpenAI兼容接口之间做选择，这直接决定后续SDK调用方式、参数写法、错误排查路径以及是否能无缝切换其他厂商模型。选错会导致代码重写、调试耗时翻倍，甚至部分高级功能不可用。
先看核心差异
原生接口是腾讯云为混元单独设计的专属协议，路径、鉴权头、参数名、响应字段全部自定义；OpenAI兼容接口则严格对齐OpenAI官方v1规范，/v1/chat/completions路径、Bearer Token鉴权、messages数组结构、stream布尔开关等全部一致。
兼容接口不是“模拟”，而是腾讯官方实现的标准化中转层——它把你的OpenAI格式请求翻译成混元原生调用，再把混元响应反向映射回OpenAI标准JSON。
如果你正在用OpenAI SDK或LangChain
选OpenAI兼容接口。只需改两处：base_url设为https://api.hunyuan.cloud.tencent.com/v1/，api_key换成混元密钥。其余代码一行不改，model参数填hunyuan-pro或hunyuan-vision即可发起调用。
LangChain的ChatOpenAI类可直接复用，stream=True自动走SSE流式通道，tools参数传入函数列表也能被正确解析并触发混元的Function Calling能力。
【注意：model参数必须填混元实际支持的型号，不能填gpt-4-turbo之类OpenAI专属名，否则返回404】
如果你需要混元特有功能
必须选原生接口。例如：
• 启用enable_enhancement开启长文本增强理解
• 设置citation要求答案附带来源引用
• 使用force_search_enhancement强制联网检索
• 调用hunyuan-vision图生文时传enable_multimedia=true启用多模态增强
这些参数在OpenAI兼容接口里被过滤或忽略，原生接口才能生效。
迁移成本对比
第一步：确认当前技术栈是否已深度绑定OpenAI生态。如果是，跳过原生接口评估，直接走兼容路径。
第二步：检查业务是否依赖混元独有的增强能力（如文档精读溯源、微信生态内容检索、Hy4 preview的专家模式逻辑链输出）。若依赖，必须切原生。
第三步：验证响应延迟。兼容接口因多一层协议转换，平均增加80～120ms RTT；原生接口直连混元后端，P95延迟低15%～20%。
第四步：查看错误日志。兼容接口报错时返回OpenAI标准error格式（如{"error":{"message":"invalid model","type":"invalid_request_error"}}）；原生接口返回腾讯云标准Code/Message结构，调试需适配不同错误码表。
