常见问题

基础问题

HuanCode 是什么？

HuanCode 是一个 AI 模型 API 聚合平台，提供兼容 OpenAI 格式的统一接口，让你通过一个 API Key 访问多种大语言模型。

与直接使用 OpenAI 有什么区别？

• 多模型支持：一个 Key 访问所有模型，无需分别注册各平台
• 按量付费：充值即用，不需要绑定信用卡或订阅
• 国内直连：国内网络可直接访问

如何注册？

前往 huancode.com/register 注册账号即可。

API 使用

支持哪些 SDK？

HuanCode 兼容 OpenAI API 格式，所有支持 OpenAI API 的 SDK 和工具都可以直接使用：

• OpenAI Python SDK
• OpenAI Node.js SDK
• LangChain
• LlamaIndex
• 其他兼容 OpenAI 的工具

只需将 base_url 设置为 https://api.huancode.com/v1 即可。

如何切换模型？

在请求参数中修改 model 字段即可，无需更换 API Key：

# GPT-4o
client.chat.completions.create(model="gpt-4o", ...)

# Claude Sonnet
client.chat.completions.create(model="claude-sonnet-4-20250514", ...)

支持流式输出吗？

支持。设置 stream: true 即可开启 SSE 流式输出，详见 快速开始。

请求失败怎么办？

1. 检查 API Key 是否正确
2. 确认账户余额充足
3. 检查模型名称是否正确（参考 支持的模型）
4. 查看返回的错误信息和 错误码说明

计费与充值

如何计费？

按实际使用的 token 数量计费，不同模型价格不同。查看 定价页面 了解详情。

如何充值？

登录后在 控制台 进行充值，支持微信支付。

余额会过期吗？

不会，充值余额永久有效。