模型与接口
打开 1A1API 控制台 小白智库
接口与模型

Base URL 与模型能力

先按工具选择接口根地址（Base URL），再从当前 API 密钥可用的模型列表中选择模型。模型能力值只在本页集中维护。

能力数据最后验证：2026-07-20 可用模型：以控制台或 /v1/models 返回结果为准

返回文档首页 打开 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 返回结果为准。

GPT-5.6 Sol 官方当前公开值上下文窗口 1,050,000 tokens；最大输入 922,000 tokens；最大输出 128,000 tokens。来源：OpenAI 模型页。
Claude 模型不要把静态推荐当作长期默认值；从当前 API 密钥可用的 Sonnet、Opus 或 Haiku 模型中按任务选择。
图片与其他模型先确认当前分组提供的准确模型 ID 和能力，再小额测试；本页不维护容易过时的完整库存。
不知道选哪个：先用当前分组可用的通用模型完成最小测试；再根据质量、速度和费用切换。页面中的模型 ID 是示例，不代表所有分组均可用。
高质量与复杂任务可从当前分组的旗舰模型开始测试，例如 gpt-5.6-sol。
摘要、分类和批处理选择当前分组提供的轻量模型，并用真实任务比较速度与费用。
Claude Code从当前 API 密钥可用的 Sonnet 模型中选择一个完成测试；具体模型 ID 以控制台为准。
图片生成确认 API 密钥所属分组有图片模型权限，再使用控制台列出的模型 ID 小额测试。
接口路径

Base URL 之外，客户端还会调用这些接口

Chat Completions

用于兼容依赖 messages / choices 的旧项目和传统 OpenAI 兼容客户端。

POST /v1/chat/completions

Responses API

推荐新项目使用，适合 Agent、Coding、长上下文和工具调用。

POST /v1/responses

Claude Messages

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

POST /v1/messages

Images

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

POST /v1/images/generations
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。