helicone

环境要求

• 一个 Helicone 账号（用于获取 API Key）
• 账号内需有可用额度（credits）
• 代码中原先调用 LLM 的 OpenAI SDK（示例使用 TypeScript/Node 版 openai 包）
• 可访问 https://ai-gateway.helicone.ai 的网络环境

安装与启动步骤

1. 1注册并获取API Key

   打开 https://helicone.ai/signup 注册账号，注册完成后在控制台获取你的 Helicone API Key。

2. 2为账号添加额度

   前往 https://us.helicone.ai/credits 添加 credits，否则通过网关发出的请求会因额度不足而失败。

3. 3修改baseURL接入网关

   把代码里的 baseURL 指向 Helicone 网关，apiKey 传入你的 Helicone API Key，其余调用逻辑不用改。

   import OpenAI from "openai";
   
   const client = new OpenAI({
     baseURL: "https://ai-gateway.helicone.ai",
     apiKey: process.env.HELICONE_API_KEY,
   });
   
   const response = await client.chat.completions.create({
     model: "gpt-4o-mini",  // claude-sonnet-4, gemini-2.0-flash or any model from https://www.helicone.ai/models
     messages: [{ role: "user", content: "Hello!" }]
   });

   复制

4. 4查看日志与用量

   请求发出后，登录 https://us.helicone.ai/dashboard 查看日志、成本、延迟和 token 用量。

5. 5可选：Docker自托管

   README 提到可用官方 docker-compose 文件本地自托管，但未给出具体命令，需按官方文档操作。

关键配置

如何确认成功

在 https://us.helicone.ai/dashboard 中能看到刚发出的请求日志、成本与延迟，即接入成功。

常见问题

注意事项

• README 示例基于 OpenAI 官方 TypeScript SDK（import OpenAI from "openai"），使用前请确保项目中已安装并可用该依赖。
• 接入方式是替换 baseURL 为 https://ai-gateway.helicone.ai，而不是替换整个模型调用代码。
• API Key 建议通过环境变量 HELICONE_API_KEY 传入，不要硬编码在源码里。
• Docker 自托管部分 README 只给出 docker-compose 文档链接，未提供具体命令，请以官方文档为准。