Base URL 与模型选择｜1A1API 帮助中心

Base URL 对照

按工具选择主地址或备用线路

先找到自己的工具，再复制对应地址。仅在线路异常时考虑备用地址，不要把带 /v1 的地址填给 Codex 或 Claude Code。

默认 OpenAI 兼容线路https://1a1api.top/v1，适合 OpenAI SDK、Cursor、Cherry Studio、OpenCode、WorkBuddy。

一般网络不稳定https://1a1api.com/v1，只在默认线路访问不稳定时切换。

部分长任务或 CF 超时https://api.1a1api.top/v1，仅供 OpenAI 兼容客户端按需尝试。

Claude Code 主地址https://api.1a1api.top，这是 root，不要追加 /v1 或 /v1/messages。

Codex 主地址https://1a1api.top，这是 Responses root，不要直接复制带 /v1 的地址。

模型能力

核对模型权限与能力限制

示例模型只用于跑通测试。实际可用模型取决于当前 API 密钥所属分组，请以控制台模型列表或 /v1/models 返回结果为准。

上下文与输出限制从准确模型 ID 对应的官方模型页核对上下文窗口和最大输出，再确认客户端与当前分组的实际限制。上下文窗口不等于一次可发送的输入长度；不要用“窗口减去最大输出”推导固定最大输入值。/v1/models 用于核对可用模型 ID，不能单独证明所有接口与能力已开放。

Claude 模型不要把静态推荐当作长期默认值；从当前 API 密钥可用的 Sonnet、Opus 或 Haiku 模型中按任务选择。

图片与其他模型先确认当前分组提供的准确模型 ID 和能力，再小额测试；本页不维护容易过时的完整库存。

先用当前密钥可用的通用模型完成测试，再根据质量、速度和费用选择其他模型。示例模型不代表所有分组均可用。

高质量与复杂任务从当前 API 密钥可用模型列表中选择高能力模型进行测试；实际可用模型以控制台或 /v1/models 为准。

摘要、分类和批处理选择当前分组提供的轻量模型，并用真实任务比较速度与费用。

Claude Code从当前 API 密钥可用的 Sonnet 模型中选择一个完成测试；具体模型 ID 以控制台为准。

图片生成确认 API 密钥所属分组有图片模型权限，再使用控制台列出的模型 ID 小额测试。

接口路径

区分根地址与请求路径

Chat Completions

用于接收 messages、返回 choices 的项目和 OpenAI 兼容客户端。

POST /v1/chat/completions

Responses API

新项目可优先考虑 Responses；工具调用等能力仍需模型、客户端与当前分组共同支持。

POST /v1/responses

Claude Messages

适合 Claude SDK、Claude Code、CC Switch 的 Claude 提供商（Provider）。

POST /v1/messages

Images

适合图像生成和 Agent 工作流中的图片任务。

POST /v1/images/generations

Claude 模型

配置 Claude 模型的接入方式

01

确认 API 密钥所在分组

先确认当前 API 密钥所属分组已经开通 Claude 模型。没有权限时通常会返回 403 或模型 ID 不存在。

02

选择接入方式

OpenAI SDK 用 https://1a1api.top/v1；Claude Code / Anthropic SDK 用 https://api.1a1api.top。

03

用最小请求测试

先发一句 Reply with exactly: ok，确认能返回，再放进项目或 Agent 工作流里。

Sonnet 类通常适合日常编码和通用任务；从控制台列出的当前可用模型中选择。

Opus 类通常面向更复杂、质量优先的任务；先确认权限和费用。

Haiku 类通常面向轻量与高频任务；用真实样本验证质量是否够用。

Base URL 容易写错：OpenAI 兼容接口一般写到 /v1；Claude Messages / Claude Code 通常写 root，不要手动追加 /v1/messages，客户端会自己拼接接口路径。

展开 curl、OpenAI 兼容与 Claude Code 示例

Anthropic Messages curl 测试

export ANTHROPIC_API_KEY="sk-your-api-key"

curl https://api.1a1api.top/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "YOUR_CLAUDE_MODEL_ID",
    "max_tokens": 256,
    "messages": [
      {
        "role": "user",
        "content": "Reply with exactly: ok"
      }
    ]
  }'

OpenAI 兼容方式调用 Claude 模型

export OPENAI_API_KEY="sk-your-api-key"

curl https://1a1api.top/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CLAUDE_MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "Reply with exactly: ok"
      }
    ],
    "stream": true
  }'

Claude Code 临时环境变量接入

export ANTHROPIC_BASE_URL="https://api.1a1api.top"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
export ANTHROPIC_MODEL="YOUR_CLAUDE_MODEL_ID"

claude

Claude 模型能不能用 OpenAI SDK 调？

可以，但前提是当前分组给这个模型做了 OpenAI 兼容映射。最稳的是先用上面的 curl 测试，成功后再放进 SDK。

api.1a1api.top 和 1a1api.top 怎么选？

OpenAI SDK、Chat Completions、Images 优先用 https://1a1api.top/v1；Claude Code、Anthropic SDK、Claude Messages 优先用 https://api.1a1api.top。

报 404 或重复 /v1/v1 怎么办？

把 Base URL 改回 root 或 /v1 中正确的那个。Claude Code 这类客户端通常不要在 Base URL 里写 /v1/messages。