模型 API / 中转站 · 小白

怎么按工具选择 1A1API 接口

1A1API 有 OpenAI 兼容、Codex / Responses、Claude Code / Anthropic 三类入口。先按工具选 Base URL，再从当前 Key 分组复制模型名并发送最小测试。

  • 1A1API
  • 接入
  • 教程
更新于 2026-07-26

一句话结论

一个账号和控制台，按工具选择对应兼容入口；不要把三个 Base URL 混用。

适用场景

  • 想把 OpenAI SDK、Cursor 或 Cherry Studio 接到 OpenAI 兼容入口
  • 想把 Codex 接到 Responses 入口
  • 想把 Claude Code 接到 Anthropic 兼容入口

常见现象

  • 知道有 1A1API，但不确定怎么开始
  • 不确定三个 Base URL 分别给什么工具
  • 不知道模型名怎么写

原因解释

  • 不同工具使用的协议和路径不同，不能只靠一个通用地址覆盖全部客户端
  • OpenAI SDK、Codex 和 Claude Code 的 Base URL 规则不同
  • 模型名和权限会随 Key 分组变化，必须从当前控制台或 `/v1/models` 读取

解决步骤

  1. 在控制台创建一个测试 Key，命名写清工具和用途。
  2. OpenAI SDK、Cursor、Cherry Studio 使用 `https://1a1api.top/v1`。
  3. Codex、Responses 类客户端使用 `https://1a1api.top`，不要手动补 `/v1`。
  4. Claude Code、Anthropic SDK 使用 `https://api.1a1api.top`。
  5. 从当前 Key 分组或模型列表复制模型 ID，示例里的 `YOUR_MODEL_ID` 必须替换。
  6. 先发一次最小测试，再到控制台核对请求状态和日志。完整配置以 https://help.1a1api.top/ 为准。

可复制命令

# OpenAI 兼容最小测试；OPENAI_BASE_URL 已经包含 /v1，不要再拼一次 /v1
export OPENAI_BASE_URL="https://1a1api.top/v1"
export OPENAI_API_KEY="sk-你的测试Key"
export MODEL_ID="YOUR_MODEL_ID"

curl "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$MODEL_ID\",\"messages\":[{\"role\":\"user\",\"content\":\"hi\"}]}"

仍然不行怎么办

  • 出现 404 或路径重复：检查是否把已经带 `/v1` 的地址又拼成了 `/v1/v1/...`。
  • 出现 401：先在控制台确认 Key 状态和所属分组，不要把完整 Key 发给别人。
  • 出现 model_not_found：从当前 Key 分组重新复制模型 ID，不要照抄旧文章中的固定模型名。
  • 出现 429、503 或 524：先看控制台日志，再按 https://help.1a1api.top/troubleshooting 分流。

小白先准备什么

  1. 确认要接入的工具是 OpenAI 兼容、Codex / Responses，还是 Claude Code / Anthropic。
  2. 创建一个仅用于本次测试的 Key，并设置合适的分组和额度。
  3. 从当前 Key 分组记录可用模型 ID，不使用文章里的旧固定型号。
  4. 准备好环境变量或工具设置页，不把 Key 写进公开前端、仓库或聊天消息。

验收标准

  • 已经按工具选择正确的三类 Base URL 之一
  • 在控制台生成了测试 Key，命名带用途标识
  • 环境变量里的 Base URL、Key 和模型 ID 来自同一分组
  • 最小测试返回正常响应
  • 控制台能看到这次测试请求的记录和扣费

可复制提示词

接入完成后，用这段提示词验证你的配置是否正确：

我刚接入了 1A1API，请帮我检查配置。不要要求我提供完整 Key。

我的配置：
- 工具：<OpenAI SDK / Cursor / Codex / Claude Code / 其他>
- BASE_URL：<地址>
- Key：已确认存在，只写“已配置”
- 模型：<从当前 Key 分组复制的模型 ID>
- 报错：<删除 Authorization、Cookie、Token 和环境变量值后的错误片段>

请帮我：
1. 判断工具属于 OpenAI 兼容、Codex / Responses 还是 Claude Code / Anthropic。
2. 核对 Base URL 是否属于对应类别。
3. 给出不包含真实密钥的最小测试。
4. 告诉我去控制台查看哪些日志字段。

常见误区

  • 误区：所有工具共用同一个 Base URL → 三类协议入口不同，先按工具选择。
  • 误区：Base URL 已有 `/v1`，请求路径又写 `/v1/chat/completions` → 会变成 `/v1/v1/...`。
  • 误区：照抄文章中的固定模型名 → 以当前 Key 分组和模型列表为准。
  • 误区：只要有余额就一定能调用 → 还要检查 Key 状态、分组权限、并发和模型可用性。
  • 误区：一个 Key 给所有项目用 → 建议每个项目单独生成 Key，方便追踪和控制

三类 Base URL 对照

地址按协议和工具选择；不要擅自互换，也不要把完整 endpoint 填进 Base URL 字段。

最小测试流程

  1. 先从当前 Key 分组复制一个可用模型 ID，发一次 `hi`。
  2. 确认成功后再换成正式项目需要的模型。
  3. 不同协议的工具分别配置，不要把同一组 Base URL 原样填到 Codex 和 Claude Code。
  4. 最后去 1A1API 控制台看请求记录、状态码和扣费，确认流量真的走到正确账号。
export OPENAI_BASE_URL="https://1a1api.top/v1"
export OPENAI_API_KEY="sk-你的测试Key"
export MODEL_ID="YOUR_MODEL_ID"

curl "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"$MODEL_ID\",\"messages\":[{\"role\":\"user\",\"content\":\"hi\"}]}"

Key 安全提醒

  • 每个项目单独建 Key，方便限额、停用和排查扣费。
  • 截图、日志和邮件里不要保留 Key 的任何真实片段；统一替换为 `<REDACTED>`。
  • 怀疑泄露时直接停用旧 Key，重新生成，不要继续观察。
  • 给客户 Demo 时用临时 Key 和小额度，不要用主账号管理员 Key。
  • 前端静态站不能暴露真实 Key；需要后端代理或安全的密钥托管。
  • 最新地址、模型、计费和购买说明统一查看 https://help.1a1api.top/。

相关问题

还卡着？

仅把删除凭证、客户数据和环境变量值后的必要截图、日志片段、需求说明或当前页面链接发到 zhemuy@gmail.com。