火星 API 接入文档

Step 01

一、开始之前

接入火星 API 前，请先确认账号和客户端都已经准备好。缺少其中一项时，客户端通常会连接失败或提示鉴权错误。

火星 API 账号
已充值余额
已创建令牌 API Key
一个支持 OpenAI 或 Anthropic 格式接口的客户端

准备清单

1登录火星 API

2充值并创建令牌

3打开客户端填写参数

建议先在火星 API 控制台确认余额和模型列表，再开始配置客户端。

Step 02

二、基础接入参数

大多数 OpenAI 或 Anthropic 格式接口客户端，只需要填写 Base URL、API Key 和模型名称。

OpenAI 格式 Base URLhttps://huoxingapi.com/v1

Anthropic 格式 Base URLhttps://huoxingapi.com

API Key在火星 API 控制台创建令牌后复制

基础参数

OpenAI 格式 Base URL: https://huoxingapi.com/v1
Anthropic 格式 Base URL: https://huoxingapi.com
API Key: 在火星 API 控制台创建令牌后复制

Step 03

三、价格分组倍率

火星 API 按模型官方输入/输出计费逻辑计算用量，并根据不同通道分组提供对应倍率。客户选择模型时，可以参考倍率、价格和稳定性来选择合适渠道。

计算原则：所有模型同步官方输入/输出计费逻辑，火星 API 在官方基础上提供折扣和渠道优化。

计算公式：实际扣费（人民币）= 官方原价（美元）× 分组倍率。

平台基础汇率：1 USD = 1 CNY。

在线充值：扣费根据所选模型倍率计算。

倍率说明：倍率越高，价格越高；1× 表示官方 1 美元按 1 元人民币计费。

选择建议

日常测试高性价比渠道

商业生产企业稳定渠道

最终模型名以控制台显示为准

分组定价与特点

渠道类型	倍率	价格	稳定性	适用场景	说明
高性价比渠道	0.5× ~ 3×	价格友好	良好（约 98 分）	个人开发、学习实验、轻量使用	多源聚合转发，日常体验流畅，适合预算敏感或轻量项目。
企业稳定渠道	4× ~ 7×	较高	高（约 99 分）	商业生产、Claude Code 企业项目、严格框架	企业级转发，稳定性和适配接近官方，适合关键业务和零容错要求。

注意：所有渠道模型均来自官方，功能与模型能力一致。倍率差异主要反映通道稳定性和适配能力，大多数日常体验对 98 分与 99 分差异无明显感知。Anthropic 风控期间，高性价比渠道稳定性可能波动，会切换备用资源；对稳定性要求更高的项目，建议优先选择企业稳定渠道。

Step 04

四、创建 API Key 教程

打开 https://huoxingapi.com
登录账号
进入控制台
找到“令牌”或“API 密钥”
点击新建令牌
复制生成的 Key
妥善保存，不要泄露给别人

控制台示意

控制台令牌 / API 密钥

操作+ 新建令牌

复制sk-huoxing-••••••••

API Key 相当于账号调用权限。请不要发到公开群、截图或提交到代码仓库。

Step 05

五、ccswitch 接入教程

ccswitch 常用于切换 Claude Code 的服务商配置。接入火星 API 时，重点是把服务商地址、令牌和模型名称改成火星 API 控制台里的信息。

打开 ccswitch
进入服务商或 Provider 配置
新建一个配置，名称可以填写：火星 API
Base URL 填写：https://huoxingapi.com
API Key / Token 填写火星 API 令牌
Model 填写火星 API 后台支持的模型名称
保存后切换到“火星 API”配置，再重新打开 Claude Code 测试

ccswitch 配置

Provider火星 API

Base URLhttps://huoxingapi.com

Token你的火星API令牌

Model以控制台显示为准

ccswitch 参数示例

Provider: 火星 API
Base URL: https://huoxingapi.com
API Key: 你的火星API令牌
Model: 火星 API 控制台支持的模型名称

如果 ccswitch 是给 Claude Code 使用，一般不要在地址后面加 /v1。如果提示模型不存在，请先去火星 API 控制台复制正确模型名。

Step 06

六、Codex 接入教程

Codex 使用 OpenAI 兼容接口时，可以将火星 API 作为兼容服务商接入。

API Key 替换成自己的令牌。
模型名称要选择火星 API 后台支持的模型。
如果报模型不存在，先去火星控制台查看模型名称。

Codex 填写位置

base_urlhttps://huoxingapi.com/v1

api_key你的火星API令牌

modelgpt-5.5

Codex 配置示例

base_url = "https://huoxingapi.com/v1"
api_key = "你的火星API令牌"
model = "gpt-5.5"

Step 07

七、Claude Code 接入教程

Claude Code 通常通过环境变量配置接口地址、令牌和模型。

Claude Code 一般不要在地址后面加 /v1。
模型名称以火星 API 控制台显示为准。
如果提示模型不存在，换成后台已有模型。

环境变量示意

ANTHROPIC_BASE_URLhttps://huoxingapi.com

ANTHROPIC_AUTH_TOKEN你的火星API令牌

ANTHROPIC_MODELclaude-sonnet-4-5-20250929

环境变量示例

ANTHROPIC_BASE_URL=https://huoxingapi.com
ANTHROPIC_AUTH_TOKEN=你的火星API令牌
ANTHROPIC_MODEL=claude-sonnet-4-5-20250929

Step 08

八、Cherry Studio 接入教程

打开 Cherry Studio
进入设置
添加 OpenAI 兼容服务商
Base URL 填写：https://huoxingapi.com/v1
API Key 填写火星 API 令牌
模型填写后台支持的模型名称
保存并测试

Step 09

九、OpenClaw / 龙虾接入教程

打开 OpenClaw
找到模型服务商设置
选择 OpenAI Compatible 或自定义接口
Base URL 填写：https://huoxingapi.com/v1
API Key 填写火星 API 令牌
模型填写后台支持的模型
保存后重启客户端再测试

Step 10

十、酒馆 / SillyTavern 接入教程

打开 SillyTavern
进入 API Connections
选择 Chat Completion / OpenAI Compatible
API 地址填写：https://huoxingapi.com/v1
API Key 填写火星 API 令牌
模型选择火星 API 支持的模型
点击连接测试

Step 11

十一、常见问题

1. 401 Unauthorized

API Key 填错或令牌失效。请重新复制火星 API 控制台里的令牌，并确认没有多余空格。

2. 404 Not Found

接口地址填错。OpenAI 兼容客户端一般填写 https://huoxingapi.com/v1，注意末尾的 /v1。

3. model not found

模型名称不存在。请去火星 API 控制台查看正确模型名，并在客户端里改成后台已有模型。

4. 余额不足

账号余额不足，需要先充值后再调用。

5. 请求很慢

请检查网络、客户端配置以及当前模型是否拥堵。也可以切换其他可用模型测试。

6. Claude Code 不生效

检查地址是否多加了 /v1，以及环境变量是否保存并在当前终端会话中生效。

接入文档