AI Token API 使用说明

1. 注册与登录

1. 打开主站 https://aitokenapi.cc。
2. 点击注册，填写邮箱、用户名和密码。
3. 如系统要求邮箱验证，请按邮件提示完成验证。
4. 注册后登录账号，进入控制台继续充值和创建密钥。

2. 钱包管理 / 兑换码充值

1. 购买后复制收到的兑换码，注意不要带空格或换行。
2. 登录主站后进入钱包管理页面。
3. 粘贴兑换码并提交，成功后余额会自动进入当前账号。
4. 兑换后可在钱包、额度或使用日志中查看余额变化。

钱包管理 / 兑换码充值入口：https://aitokenapi.cc/console/topup

3. 创建 API 密钥

1. 登录主站后进入“API 令牌”或“API 密钥”页面。
2. 点击创建，填写一个方便识别的名称，例如“Codex 自用”。
3. 普通用户保持默认设置即可；如页面提供额度、过期时间等选项，可按自己的使用场景调整。
4. 保存后立即复制密钥，密钥通常只完整显示一次。

API 密钥页面：https://aitokenapi.cc/console/token
模型广场页面：https://aitokenapi.cc/pricing
使用日志页面：https://aitokenapi.cc/console/log

4. 接口地址怎么填

公开客户端只需要填写下面这个 Base URL。不要把文档地址、登录地址、兑换码地址填到客户端里。

用户页面地址

客户端 API 地址

连通测试

curl "https://aitokenapi.cc/v1/models" \
  -H "Authorization: Bearer sk-xxxxxx"

如果返回模型列表，说明地址和密钥正常。若返回 401 或 403，请检查密钥是否复制完整、余额是否充足、密钥是否被停用或过期。

5. 客户端安装

已经安装过客户端的用户可以跳过本节，直接进入对应配置说明。

6. 编辑器配置说明

如果你是在 VS Code、Cursor、Trae、Windsurf 或其它编辑器里使用 Codex / Claude Code / OpenClaw，请先分清“编辑器本身”和“命令行工具”的配置位置。多数报错不是账号问题，而是地址或密钥填错。

如果你是在终端里运行 Codex / Claude Code，就按后面的命令行配置；如果是在编辑器插件里填写供应商信息，就只填写 Base URL、API Key 和模型名。

7. Codex 配置

Codex 推荐使用 OpenAI 兼容的 Responses 接口。日常任务可用 gpt-5.4，代码项目可优先使用 gpt-5.3-codex。

macOS / Linux / WSL

# ~/.codex/config.toml
model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://aitokenapi.cc/v1"
wire_api = "responses"
requires_openai_auth = true

# ~/.codex/auth.json
{
  "OPENAI_API_KEY": "sk-xxxxxx"
}

Windows

# %userprofile%\.codex\config.toml
model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://aitokenapi.cc/v1"
wire_api = "responses"
requires_openai_auth = true

# %userprofile%\.codex\auth.json
{
  "OPENAI_API_KEY": "sk-xxxxxx"
}

编程模型推荐参数

model = "gpt-5.3-codex"
review_model = "gpt-5.3-codex"
model_context_window = 272000
model_auto_compact_token_limit = 244800

8. Claude Code 配置

Claude Code 使用时可把本站接口作为兼容网关。不同版本客户端对模型名支持可能不同，如提示模型不可用，请在客户端内重新选择当前可用模型。

# macOS / Linux / WSL
export ANTHROPIC_BASE_URL="https://aitokenapi.cc/v1"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxx"

# Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://aitokenapi.cc/v1"
$env:ANTHROPIC_AUTH_TOKEN="sk-xxxxxx"

# Windows CMD
set ANTHROPIC_BASE_URL=https://aitokenapi.cc/v1
set ANTHROPIC_AUTH_TOKEN=sk-xxxxxx

# ~/.claude/settings.json 或 %userprofile%\.claude\settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aitokenapi.cc/v1",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxx",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

9. Hermes / ccswitch 配置

如果工具提示 Hermes provider is missing the api_mode field，说明供应商配置缺少接口模式。可以按下面模板填写。

{
  "name": "AI Token API",
  "base_url": "https://aitokenapi.cc/v1",
  "api_key": "sk-xxxxxx",
  "api_mode": "openai"
}

10. OpenClaw 配置

{
  "models": {
    "mode": "merge",
    "providers": {
      "openai": {
        "baseUrl": "https://aitokenapi.cc/v1",
        "apiKey": "sk-xxxxxx",
        "api": "openai-responses"
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "openai/gpt-5.4" }
    }
  },
  "gateway": {
    "mode": "local",
    "port": 18789
  }
}

常见错误：baseUrl 末尾多加斜杠、模型名缺少 provider 前缀、密钥复制时多了空格。

11. API 调用示例

Responses 文本调用

curl "https://aitokenapi.cc/v1/responses" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
    "model": "gpt-5.4",
    "input": "用三句话解释什么是 API 中转。",
    "temperature": 0.7,
    "max_output_tokens": 800
  }'

Chat Completions 调用

curl "https://aitokenapi.cc/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {"role": "user", "content": "你好，测试一下接口。"}
    ]
  }'

12. 图片接口

图片生成

curl "https://aitokenapi.cc/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张简洁清爽的科技产品海报，蓝绿色主色，中文标题",
    "size": "1024x1024",
    "quality": "high",
    "output_format": "png",
    "n": 1
  }'

参考图编辑

curl "https://aitokenapi.cc/v1/images/edits" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -F "model=gpt-image-2" \
  -F "prompt=保留主体和构图，改成电商海报风格，背景换成浅色摄影棚" \
  -F "image=@source.png" \
  -F "size=1024x1024" \
  -F "quality=high" \
  -F "output_format=png"

13. 模型选择建议

14. 常见问题

15. 售后支持

请不要在公开截图里展示完整 API 密钥。发给客服排查时，也建议只展示密钥前后几位。