外观
客户端总览
本站是 单主站。所有客户端只填这一条 API：
https://api.ashpetals.com控制台 / 令牌 / 钱包 / 模型广场 用 https://ai.ashpetals.com。不要再填地域节点或备用域名当「更快线路」。
七款软件怎么接
用户最常问的七款（外加 DeepSeek Harness）都在这里。每页都写 图形界面 和 命令行 / 配置文件 两套。
| 软件 | 形态 | 本站协议 | Base URL | 教程 |
|---|---|---|---|---|
| CC Switch | 桌面 GUI + CLI/TUI | 按目标应用切换 | 见该页 | 一键导入其它客户端 |
| ChatGPT / Codex | Codex CLI / 桌面 | OpenAI Responses | https://api.ashpetals.com/v1 | ChatGPT 官方 App 不能填第三方 Base |
| Claude Code | CLI / IDE 插件 | Anthropic Messages | https://api.ashpetals.com（不要 /v1） | 令牌需 Claude 分组 |
| OpenCode | TUI / 桌面 | OpenAI Chat Completions | https://api.ashpetals.com/v1 | opencode.json 或环境变量 |
| Grok Build | TUI /settings + config.toml | Responses / Chat / Messages | 按 api_backend | ~/.grok/config.toml |
| Hermes Agent | hermes model / YAML | OpenAI 或 Anthropic | Chat 用 /v1；Messages 不用 | 自定义 provider |
| OpenClaw | Control UI + CLI | openai-completions 等 | https://api.ashpetals.com/v1 | 必须 allowlist 模型 |
| DeepSeek Harness | Web UI + dsh CLI | openai-completions 等 | 必须带 /v1 | settings.yaml 的 llm-pi-ai |
| 通用 OpenAI 客户端 | SDK / 第三方 GUI | Chat Completions | https://api.ashpetals.com/v1 | NextChat / Lobe / Cherry 等 |
填错 Base 会怎样
| 客户端 | 正确 | 填错常见结果 |
|---|---|---|
| Codex / OpenCode / Hermes Chat / OpenClaw Chat / dsh completions | 带 /v1 | 404 或打到控制台 SPA |
| Claude Code / Anthropic Messages | 不带 /v1（客户端自己拼 /v1/messages） | 404 /v1/v1/messages |
Grok Build api_backend = "responses" 或 "chat_completions" | 带 /v1 | 404 |
Grok Build api_backend = "messages" | 不带 /v1 | 404 |
推荐模型（以 /v1/models 为准）
| 场景 | 模型 ID | 令牌分组 |
|---|---|---|
| Codex / 通用 Chat / OpenCode / Hermes | gpt-5.6-sol | ChatGPT-Main 或 ChatGPT-DR |
| Claude Code | claude-sonnet-5 | Claude-Main 或 Claude-Pro |
| Grok Build 原生风格 | grok-4.5 或 grok-build | Grok-Main |
| 性价比文本 | deepseek-v4-flash | 以广场为准 |
分组与价格见 分组与价格。模型必须出现在当前 Key 的 GET /v1/models 里，否则 model_not_found。
接入前准备（所有客户端通用）
- 在 ai.ashpetals.com 注册并充值（1.3 元 = 1 余额）。
- 「令牌」页创建
sk-Key，选对分组。 - 先用 curl 确认 Key 活着，再填客户端：
bash
curl -sS https://api.ashpetals.com/v1/models \
-H "Authorization: Bearer sk-你的APIKey"- 不要把 Key 写进 Git、截图发群、贴到公开文档。泄露后在令牌页删除并新建。
一键导入还是手写？
- 同时用好几款 CLI → 先看 CC Switch（桌面或
cc-switchCLI）。 - 只跑一款 → 打开对应教程，用该软件自己的 GUI / 配置文件，不必装切换器。
- 协议已经匹配时 直连本站，不必开本地代理。只有「在 Claude Code 里跑 GPT」这类跨协议才需要本地路由。
统一冒烟
bash
# OpenAI Chat
curl -sS https://api.ashpetals.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的APIKey" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"ping"}]}'
# OpenAI Responses（Codex / 部分 Grok Build）
curl -sS https://api.ashpetals.com/v1/responses \
-H "Authorization: Bearer sk-你的APIKey" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","input":"ping"}'
# Anthropic Messages（Claude Code；令牌需 Claude 分组）
curl -sS https://api.ashpetals.com/v1/messages \
-H "x-api-key: sk-你的APIKey" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"claude-sonnet-5","max_tokens":64,"messages":[{"role":"user","content":"ping"}]}'