通用调用步骤

基础信息

所有工具在配置 Echoly API 时，需要两个核心参数：

参数	值
Base URL	https://api.echoly.cn
API Key	sk-你的令牌（在 令牌管理 创建）

API 端点

根据你使用的协议，选择对应的端点：

协议	端点	适用场景
OpenAI Chat	https://api.echoly.cn/v1/chat/completions	通用对话、编程
OpenAI Responses	https://api.echoly.cn/v1/responses	Codex CLI
Claude Messages	https://api.echoly.cn/v1/messages	Claude Code
Gemini	https://api.echoly.cn/v1beta/models/{model}:generateContent	Gemini CLI

配置流程

无论什么工具，配置步骤基本一致：

1. 在工具的设置中找到 API 提供商 / Provider 设置
2. 选择 OpenAI 兼容格式（或自定义 / Custom）
3. 填入 Base URL：https://api.echoly.cn（有些工具需要 https://api.echoly.cn/v1）
4. 填入 API Key：sk-xxx
5. 选择你要使用的模型名称

模型名称要完全匹配

在工具里填的模型名必须和 模型列表 中的名称完全一致，比如 kimi-k2.6，不能写成 kimi 或 Kimi-K2.6。

流式输出

支持流式输出（SSE），在请求中设置 "stream": true 即可。大多数工具会自动处理流式响应。

常见配置

在支持 OpenAI 格式的工具中

绝大多数 AI 客户端工具（Cherry Studio、OpenCat、BotGem 等）都支持自定义 OpenAI 接口：

• Provider / 提供商 → OpenAI 或 Custom OpenAI
• API Base / 接口地址 → https://api.echoly.cn
• API Key → sk-你的Key
• Model → 手动输入模型名

在代码中

使用 OpenAI 官方 SDK，只需修改 base_url：

client = OpenAI(api_key="sk-你的Key", base_url="https://api.echoly.cn/v1")

const client = new OpenAI({ apiKey: "sk-你的Key", baseURL: "https://api.echoly.cn/v1" });