完整操作流程

从注册到正式调用，按下面顺序走一遍即可。流程来自现有使用手册，并整理成更适合网页阅读的步骤。

令牌与密钥管理

所有 API 请求都需要绑定有效令牌。建议不同工具、不同项目分别创建密钥，方便管理和止损。

创建令牌

1. 进入 控制台令牌页面。
2. 点击新建令牌或添加令牌。
3. 填写清晰备注，例如 codex-local、team-api-prod。
4. 根据业务需要设置额度、有效期和状态。
5. 保存后复制完整密钥，密钥通常以 sk- 开头。

推荐管理方式

密钥泄露时

1. 立即进入令牌管理页面禁用或删除旧密钥。
2. 创建新令牌并更新本地工具或服务端环境变量。
3. 检查最近用量记录，确认是否有异常请求。

API 接入说明

aimodel.run 当前使用 New API 网关。OpenAI 兼容客户端一般只需要配置 Base URL 和 API Key。

常用接口

调用示例

下面的示例只演示请求格式。请把 sk-你的密钥 和 YOUR_MODEL_ID 换成自己的真实配置。

curl

curl https://aimodel.run/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {"role": "user", "content": "Hello, please introduce yourself briefly."}
    ],
    "stream": false
  }'

Python OpenAI SDK

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://aimodel.run/v1",
)

resp = client.chat.completions.create(
    model="YOUR_MODEL_ID",
    messages=[
        {"role": "user", "content": "Say hello in one sentence."}
    ],
)

print(resp.choices[0].message.content)

Node.js OpenAI SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的密钥",
  baseURL: "https://aimodel.run/v1",
});

const resp = await client.chat.completions.create({
  model: "YOUR_MODEL_ID",
  messages: [{ role: "user", content: "Say hello in one sentence." }],
});

console.log(resp.choices[0].message.content);

CC-Switch 配置

CC-Switch 适合不想手动改多个 CLI 配置文件的用户。New API 控制台已暴露 CC Switch 入口，优先使用一键导入。

推荐方式：控制台一键导入

1. 安装并打开 CC-Switch。
2. 进入 aimodel.run 控制台的令牌页面，找到你要使用的令牌。
3. 在令牌操作区寻找聊天工具或快速配置入口，选择 CC Switch。
4. 浏览器会拉起 CC-Switch 并写入供应商配置。
5. 回到 CC-Switch，分别为 Claude Code、Codex、Gemini 选择刚导入的供应商，保存后重启对应 CLI。

手动添加供应商

Claude Code 配置

Claude Code 通过 Anthropic 环境变量读取网关地址与密钥。这里给出环境变量方式和 settings.json 方式。

方式一：环境变量

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://aimodel.run", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的密钥", "User")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", "User")

# 关闭当前终端，重新打开后测试
claude

export ANTHROPIC_BASE_URL="https://aimodel.run"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

# 如需永久生效，写入 ~/.zshrc 或 ~/.bashrc
claude

方式二：settings.json

如果你更喜欢配置文件，可在 Claude Code 配置目录创建 settings.json。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥",
    "ANTHROPIC_BASE_URL": "https://aimodel.run",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

Codex CLI / App 配置

Codex 使用 OpenAI 兼容配置。New API 官方 helper 会把基础地址规范到 /v1，本页直接给出手动配置。

安装 Codex CLI

npm install -g @openai/codex@latest

打开配置目录

mkdir "$env:USERPROFILE\.codex" -Force
explorer "$env:USERPROFILE\.codex"

mkdir -p "$HOME/.codex"
open "$HOME/.codex" 2>/dev/null || xdg-open "$HOME/.codex"

创建 config.toml

model = "YOUR_MODEL_ID"
model_provider = "aimodel"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.aimodel]
name = "aimodel"
base_url = "https://aimodel.run/v1"
wire_api = "responses"

创建 auth.json

{
  "OPENAI_API_KEY": "sk-你的密钥"
}

启动与测试

codex

Gemini CLI 配置

Gemini CLI 通常读取 ~/.gemini/.env。如果你使用 CC-Switch，一键导入会更省事。

安装 Gemini CLI

npm install -g @google/gemini-cli

打开配置目录

mkdir "$env:USERPROFILE\.gemini" -Force
notepad "$env:USERPROFILE\.gemini\.env"

mkdir -p "$HOME/.gemini"
nano "$HOME/.gemini/.env"

写入 .env

GOOGLE_GEMINI_BASE_URL=https://aimodel.run
GEMINI_API_KEY=sk-你的密钥
GEMINI_MODEL=YOUR_MODEL_ID

额度、充值与用量

额度由兑换码核销到账。调用成功后会按模型、输入输出和平台计费规则扣减。

核心规则

• 兑换码通常为一次性凭证，重复兑换无效。
• 套餐额度可能存在有效期，以购买页面或订单说明为准。
• 虚拟额度和兑换码一经兑换到账，非平台故障通常不做退款处理。
• 用量可在个人中心、令牌页或用量统计页面查询。

减少异常消耗

FAQ 与技术支持

遇到问题先看错误码。反馈时请提供时间、令牌备注、工具名称、请求地址和完整错误信息。

使用安全

• 不要把密钥上传到 GitHub、论坛、公开文档、聊天群或前端代码。
• 不要转卖、出租、共享账号额度和密钥。
• 不要使用自动化脚本恶意高频请求、压测或绕过平台访问控制。
• 使用平台能力时，请遵守上游模型服务条款以及你所在地区适用的规则。