API 文档

本文档详细阐述了API的认证方法、可用模型、配置参数及核心技术优势，旨在为开发者提供清晰、完整的接入与使用指南。

🔑 API 认证凭证

本API遵循OpenAI协议标准，可与所有兼容该协议的客户端和服务无缝集成。

💡 推荐模型: gemini-2.5-pro

为获取最佳性能与体验，推荐使用当前的旗舰模型 gemini-2.5-pro。其核心能力如下：

• 超长上下文窗口:
  拥有高达100万令牌的处理能力，可以一次性分析整个代码库、数百页的文档乃至于长达一小时的视频内容。
• 原生多模态理解:
  无需预处理，即可在单个提示中同时理解和分析文本、图像、音频和视频，实现跨模态的复杂推理。
• 高级推理与代码能力:
  在逻辑推理、问题解决和代码生成与解释方面表现卓越，是复杂任务的理想选择。
• 与谷歌工具链集成:
  内置谷歌搜索以获取实时信息，并能调用其他谷歌工具，具备高度的可扩展性。

🤖 实时可用模型列表

下表为通过API动态获取的实时模型列表。该列表会在页面加载时自动刷新。

您也可以通过 `curl` 命令获取最新模型列表：

curl https://api.xh6.top/v1/models -H "Authorization: Bearer sk-3AEY28Or8ORvWbwgYJo7DXftapQPk7GyMI7pDaQyi4XOpKyP"

⚙️ 高级配置与参数详解

为实现更深度的模型推理能力，建议在API请求的JSON主体中包含 `generationConfig` 对象。这可以为模型分配更多的计算预算以进行前置思考。

{
  "generationConfig": {
    "thinkingConfig": {
      "thinkingBudget": 32768
    }
  }
}

参数配置建议

• Temperature (温度值): 1
  该参数控制生成文本的随机性。设置为 `1` 可使模型输出更具多样性和创造性，适用于需要探索多种可能性的任务，如内容创作或头脑风暴。
• Top-p (核心采样): 1
  此参数通过限制词汇选择范围来控制随机性。设置为 `1` 意味着模型会从整个词汇表中进行采样，不进行任何概率限制，与高 `Temperature` 配合使用能最大化生成的多样性。
• Context Length (上下文长度): 无限制
  理论上不设上下文长度限制，允许模型在处理长对话或复杂文档时，维持长距离的依赖关系和语境连贯性。实际限制取决于所使用的客户端软件。

🌟 模型核心技术优势

• 集成谷歌搜索能力: 模型内置Google Search API调用功能，能够获取并整合实时网络信息，确保响应的即时性与事实准确性（此功能可按需启用或禁用）。
• 零成本访问: 作为一项免费服务提供，旨在消除财务壁垒，促进开发者、研究人员及应用集成商进行广泛的实验与部署。
• 原生思维链可视化: 支持对模型“思维链”（Chain-of-Thought）的原生展示，为用户提供了透明的窗口，以观察模型从接收问题到生成最终答案的完整推理路径和中间步骤。
• 企业级云API基础设施: 依托谷歌云（Google Cloud）的企业级API服务架构，保障了高可用性、低延迟和持续稳定的性能，有效避免了模型能力降级问题。
• 支持MCP架构模式: 兼容模型-控制器-代理（Model-Controller-Proxy）架构，为实现高级请求路由、负载均衡和复杂的多模型工作流管理提供了支持。

🖥️ 推荐的客户端软件

为获得最优体验，推荐使用以下支持OpenAI API协议的客户端软件：

• CheeryStudio - 功能丰富的桌面端应用，提供全面的AI交互体验。
• Chatbox - 设计简洁、支持跨平台的流行客户端。
• OpenWebUI - 一款强大的开源Web用户界面，支持自托管和高度定制。

✍️ 推荐提示词 (System Prompt)

强制使用中文回答
当前时间: {{datetime}}