快速开始

3 分钟跑通第一次请求

先别急着配置复杂客户端。先用最小请求确认 API Key、Base URL 和模型 ID 都可用。

打开控制台 · 创建 API Key 看常见排错

主要接口 /v1/chat/completions

传统 OpenAI 兼容聊天接口。

Agent 接口 /v1/responses

适合 Codex、Claude Code、OpenCode。

推荐模式 stream: true

长任务更稳，也更不容易超时。

快速接入

快速开始

三步跑通：创建 API Key、选对 Base URL、发起一次测试请求。新手默认填 gpt-5.5；如果客户端界面显示 GPT-5.5 也能识别。

OpenAI SDK / Cursor / Cherry StudioBase URL 推荐填 https://1a1api.top/v1。如果你的网络访问 .top 不稳定，再尝试备用 https://1a1api.com/v1。

Codex CLI / Responses 客户端Base URL 填 root：https://1a1api.top，不要手动加 /v1。

Claude Code / Anthropic SDKBase URL 填 root：https://api.1a1api.top，不要手动加 /v1/messages。

手写 curl 测试Chat 用 /v1/chat/completions；Responses 用 /v1/responses。

创建 API Key

打开 1A1API 控制台，进入“API 密钥”页面，点击新建并复制 sk- 开头的 Key 自行保管。

不要把 API Key 写进前端代码、公开仓库、截图或聊天记录，更不要发到任何公开教程或群里。

选择 Base URL

先按上方对照表填写。最常见错误是客户端自己会拼端点，但你又手动加了一次 /v1 或 /v1/messages。

开启流式输出

长文本、代码生成、Agent 任务建议启用 stream: true。

如大型项目、长时间 Agent 任务或大图生成遇到 Cloudflare 报错，可尝试使用备用接口 https://api.1a1api.top/v1 连接；部分地区访问该接口可能需要调整网络环境。

curl 测试 Chat Completions

curl https://1a1api.top/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "用一句话介绍 1A1API。"
      }
    ],
    "stream": true
  }'

curl 测试 Responses API

curl https://1a1api.top/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "Reply with exactly: ok",
    "stream": true
  }'