应用接入指南

本页汇总常见 AI 客户端 / 编程工具接入本平台的方法。所有工具都只需两样东西：

项	值
Base URL	`https://api.token.heimatianqi.com/v1`
API Key	控制台 →「API 密钥」创建，形如 `sk-heima-xxxxxxxx`

多数工具要求 Base URL 以 /v1 结尾；部分工具（如 Claude Code）使用 Anthropic 协议，需要走各自的兼容开关，见下方分节。

Claude Code

Claude Code 使用 Anthropic 协议。接入时设置环境变量：

export ANTHROPIC_BASE_URL="https://api.token.heimatianqi.com"
export ANTHROPIC_AUTH_TOKEN="sk-heima-xxxxxxxx"

平台以 OpenAI 兼容接口为主；如需 Claude 原生协议，请先向平台确认该模型与渠道是否已开放 Anthropic 端点（控制台「模型与价格」→ 详情 → 支持的接口）。

OpenAI Codex CLI

Codex CLI 支持自定义 OpenAI 兼容端点，在 ~/.codex/config.toml 中配置：

model_provider = "heima"
model = "deepseek-v4-flash"

[model_providers.heima]
name = "Heima Token"
base_url = "https://api.token.heimatianqi.com/v1"
env_key = "HEIMA_API_KEY"

export HEIMA_API_KEY="sk-heima-xxxxxxxx"

Cherry Studio

设置 → 模型服务 → 添加提供商，类型选 OpenAI；
API 地址填 https://api.token.heimatianqi.com/v1；
API 密钥填 sk-heima-xxxxxxxx；
添加模型（模型名与控制台「模型与价格」一致，例如 deepseek-v4-flash）。

Cline / Roo Code（VS Code 插件）

设置 → API Provider 选 OpenAI Compatible；
Base URL：https://api.token.heimatianqi.com/v1；
API Key：sk-heima-xxxxxxxx；
Model ID：例如 deepseek-v4-flash（需支持工具调用的模型）。

Continue（VS Code / JetBrains）

在 ~/.continue/config.json 的 models 中添加：

{
  "title": "Heima Token",
  "provider": "openai",
  "model": "deepseek-v4-flash",
  "apiBase": "https://api.token.heimatianqi.com/v1",
  "apiKey": "sk-heima-xxxxxxxx"
}

Open WebUI

设置 → 连接 → OpenAI API；
API URL：https://api.token.heimatianqi.com/v1；
API Key：sk-heima-xxxxxxxx；
保存后在模型下拉中选择模型。

LobeChat

设置 → 语言模型 → OpenAI；
接口代理地址：https://api.token.heimatianqi.com/v1；
API Key：sk-heima-xxxxxxxx；
自定义模型名：填写平台模型名（如 deepseek-v4-flash）。

Aider

export OPENAI_API_BASE="https://api.token.heimatianqi.com/v1"
export OPENAI_API_KEY="sk-heima-xxxxxxxx"
aider --model openai/deepseek-v4-flash

通用排查

现象	处理
401 `invalid_api_key`	Key 复制不完整、被禁用或已过期 → 控制台重新创建
404 `model_not_found`	模型名拼写错误，或该 Key 的「允许模型」未包含它
401/403 但 Key 正常	Base URL 少了 `/v1`，或用了 OpenAI 官方地址
流式输出一次性出现	客户端或反向代理开了缓冲，关闭 proxy_buffering
余额不足	平台在调用前会按余额与 `max_tokens` 预估，不足直接拒绝，不会产生欠费