如何将 API 客户端连接到 ApiClo

开始之前

• 创建 ApiClo 账户，并为此集成单独创建一个 API 密钥。
• 在账户中检查余额和当前模型列表。复制准确的 Model ID；模型显示名称不能替代 API 标识符。

操作步骤

1. 设置接口地址

   将 Base URL 设为 https://apiclo.com/v1。如果客户端自动追加 /chat/completions，最终路径应为 /v1/chat/completions。不要重复添加 /v1。

2. 设置身份验证

   将 ApiClo 密钥保存在客户端的受保护字段或后端环境变量中。直接发送 HTTP 请求时使用 Authorization: Bearer YOUR_APICLO_API_KEY。不要将密钥提交到代码仓库或放入公开 HTML。

3. 选择模型

   从 ApiClo 当前目录复制 Model ID，保持原样。先发送简短文本并设置 stream=false，再测试流式输出和工具调用。

检查结果

从自己的客户端发送一条简短测试消息。检查 HTTP 状态、返回内容以及 ApiClo 中的用量记录。文本请求成功不代表所有可选 API 功能均兼容。

常见问题

• 401：检查密钥是否由 ApiClo 创建、是否有效以及是否含有多余空格。不要在支持请求中发送密钥。
• 404：检查最终 URL，特别是重复的 /v1 或使用了错误的接口类型。
• 模型错误：重新复制当前 Model ID，并确认该模型支持所选接口。
• 流式输出或工具调用错误：先测试最小的非流式文本请求，再查阅对应客户端的教程。

兼容性与计费

OpenAI 兼容客户端与 Anthropic Messages 客户端使用不同的地址规则。会自行追加 /v1/messages 的客户端应使用 https://apiclo.com，不加 /v1。系统先尝试所选模型；已说明的供应商或容量故障可能触发受控回退，仍按所选模型费率计费。Hermes 托管服务单独收费。ApiClo 是独立服务，并非 OpenAI 或 Anthropic 的官方产品。