模型与接口

Base URL 先填对，问题少一半

OpenAI 兼容、Responses、Claude Messages 对 Base URL 的要求不同。先看这一页，再复制配置。

返回文档首页打开 1A1API 控制台看常见排错

模型与接口

实际可用模型以你的 API Key 所属分组权限为准。新手默认先用 gpt-5.5 测试；如果客户端显示或复制为 GPT-5.5 也能识别。

gpt-5.5推荐默认模型 ID，适合通用高质量任务、复杂代码、长文生成和 Agent 工作流；GPT-5.5 也能识别。

gpt-5.4 / gpt-5.4-mini适合轻量任务、批处理、摘要、低成本自动化和对速度更敏感的场景。

gpt-5.3-codex适合 Codex / Coding 类任务；具体可用性以 API Key 所属分组为准。

claude-opus-4-7复杂推理、架构设计、长任务复核，成本更高。

claude-sonnet-4-6日常编码、文案、客服、知识库问答的主力选择。

claude-haiku-4-5分类、摘要、批量轻任务、低成本自动化。

gpt-image-1 / gpt-image-1.5 / gpt-image-2图片生成模型，适合海报、产品图、插画和 Agent 工作流中的图片任务。

不知道选哪个：1. OpenAI 兼容客户端先用 gpt-5.5 跑通；2. 摘要、分类、轻量批处理再换 mini；3. Claude Code 优先用 claude-sonnet-4-6；4. 图片生成先确认 Key 分组支持图片模型，再用 gpt-image-2 小额测试。

日常聊天 / 轻量任务优先 gpt-5.4-mini 或当前分组提供的轻量模型，适合低成本摘要、分类、批处理。

代码修复 / 中等开发优先 gpt-5.4，适合普通项目改代码、写脚本、解释报错。

Codex / OpenAI Responses / 大项目优先 gpt-5.5，长上下文、复杂项目和 Agent 工作流更稳。

Claude Code优先 claude-sonnet-4-6；复杂架构或复核任务再考虑 claude-opus-4-7；轻量分类和摘要可用 claude-haiku-4-5。

图片生成使用 gpt-image-1.5 或 gpt-image-2，并确认 Key 分组有生图权限。

Chat Completions

适合传统 OpenAI 兼容客户端，也可以调用被分组授权的 Claude 模型映射。

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

备用地址

什么时候用 .com 或 api 子域名

首页只放主推地址，避免新手混淆。需要备用线路时，再看这一段。

主推 OpenAI 兼容地址https://1a1api.top/v1，适合 OpenAI SDK、Cursor、Cherry Studio、OpenCode、WorkBuddy。

.com 备用 OpenAI 兼容地址https://1a1api.com/v1 也可用。新手默认先用 .top，网络不稳时再切换。

api 子域 OpenAI 备用地址https://api.1a1api.top/v1 可用于部分长任务或备用线路，末尾通常要带 /v1。

Claude Code / Anthropic SDKhttps://api.1a1api.top，这是 root，不要手动追加 /v1/messages。

Claude 模型接入

Claude 模型怎么接入 1A1API

Claude 模型有两条接入路线：普通程序优先走 OpenAI 兼容接口；Claude Code、CC Switch、Anthropic SDK 这类工具优先走 Claude Messages 接口。

确认 Key 所在分组

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

选择接入方式

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

用最小请求测试

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

claude-opus-4-7复杂推理、架构设计、长任务复核，成本更高。

claude-sonnet-4-6日常编码、文案、客服、知识库问答的主力选择。

claude-haiku-4-5分类、摘要、批量轻任务、低成本自动化。

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

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": "claude-sonnet-4-6",
    "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": "claude-sonnet-4-6",
    "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="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-7"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

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。