常见问题
账户相关
Q: 如何注册账号？
访问 玄州API 官网，点击「注册」，填写邮箱和密码即可。详见 注册与充值。
Q: 余额会过期吗？
不会。预充值余额永久有效，不会过期。
Q: 如何查看消费明细？
登录控制台，进入「钱包管理」→「消费明细」，可查看每次 API 调用的详细扣费记录。
Q: 可以退款吗？
正常情况下余额不支持退款。如有特殊情况，请联系客服处理。
API Key 相关
Q: API Key 在哪里创建？
登录控制台 →「密钥管理」→「添加令牌」。详见 创建 API Key。
Q: API Key 丢失了怎么办？
API Key 一旦生成后无法再次查看。如果丢失，请在控制台重新创建一个新的 Key。
Q: API Key 可以多人共用吗？
可以。但建议为不同用户/应用创建不同的 Key，便于管理各渠道的用量和限额。
Q: 什么是分组？如何选择？
分组代表不同的上游资源渠道，不同分组的模型、稳定性和价格可能有所不同。建议在模型广场中查看各分组的模型列表和价格后选择，也可联系客服获取推荐。
计费相关
Q: 怎么计费？
按实际 token 使用量计费。输入 token、输出 token 分别计价（输出一般更贵），部分模型支持 cache。详见 模型价格。
Q: 调用失败扣费吗？
不扣。只有成功返回内容的调用才会计费。
Q: 1M tokens 大概能聊多少？
- GPT-5.5: 约 70 万中文字（输入），约 35 万中文字（输出）
- 一次普通对话大概消耗 1,000-3,000 tokens
- 1 块钱可以聊几十到上百次（取决于模型和对话长度）
Q: cache 是什么？怎么用？
Server-side cache（缓存）是部分模型支持的优化功能。当多次发送相同或相似的 system prompt 时，后续请求可享受缓存折扣。缓存由系统自动管理，无需手动操作。
技术相关
Q: 支持哪些 API 格式？
兼容 OpenAI Chat Completions API 格式（/v1/chat/completions）。部分 Claude 模型同时支持 Anthropic 原生 /v1/messages 格式。
Q: 支持流式输出（streaming）吗？
支持。设置 stream: true 即可。所有模型均支持流式输出。
Q: 支持 function calling / tools 吗？
支持。用法与 OpenAI 官方 API 一致，在请求参数中添加 tools 字段即可。
Q: 支持图片识别吗？
支持。使用多模态模型（gpt-5.5、claude-opus-4-7、claude-sonnet-4-6、gemini-3.5-flash 等），在 messages 中使用 image_url 格式即可。
Q: 并发限制是多少？
默认根据账户等级有不同的并发限制。如有更高需求，请联系客服提升配额。
Q: 如何在 Claude Code 中使用？
设置环境变量即可，详见 Claude Code 集成教程。
Q: 如何在 Cursor 中使用？
在 Cursor 设置中配置自定义 API，详见 Cursor 集成教程。
Q: 如何在 CodeX CLI 中使用？
设置 OPENAI_BASE_URL 和 OPENAI_API_KEY 环境变量，详见 CodeX CLI 集成教程。
Q: 请求的 base_url 应该怎么写？
通常使用 https://xuanzhouapi.top 或 https://xuanzhouapi.top/v1。具体参考各客户端的要求：
- OpenAI SDK：
https://xuanzhouapi.top/v1 - Claude Code：
https://xuanzhouapi.top - NextChat：
https://xuanzhouapi.top - 部分需要完整路径的：
https://xuanzhouapi.top/v1/chat/completions
服务相关
Q: 服务可用性如何？
我们部署在国内主流云服务器上，通过多上游渠道保证服务稳定性。如遇到问题，可在 QQ 群反馈。
Q: 支持企业发票吗？
请联系客服咨询企业发票事宜。
Q: 有 QQ 群吗？
有，QQ群号：1085586242。如有疑问或企业级客户需要协助，请加群联系管理员。
Q: API 响应慢怎么办？
- 检查网络连接是否正常
- 部分模型（如大参数模型）首次调用可能稍慢
- 可在控制台日志查询中查看 API 延迟详情
- 如持续缓慢，请联系客服
还有其他问题？请加 QQ 群 1085586242 联系我们。