接入文档 - 6B AI

接入前须知

可用模型和能力由 API Key 所属分组决定。不要照抄其他用户的模型名称，请先使用自己的 Key 查询模型列表。

GET STARTED

快速开始

1

登录并准备额度

前往控制台登录。如使用兑换码，可在兑换中心完成兑换。
2

创建 API Key

在密钥管理中新建 Key，并选择与你要调用的模型对应的分组。密钥只会完整显示一次，请妥善保存。
3

查询模型并发起请求

先调用模型列表接口取得模型 ID，再使用下方示例完成首次请求。

AUTHENTICATION

鉴权方式

推荐使用标准 Bearer 鉴权。不同兼容客户端也可以使用对应的原生请求头，三种方式均由网关支持。

适用场景	请求头	值
OpenAI / 通用	`Authorization`	`Bearer YOUR_API_KEY`
Anthropic	`x-api-key`	`YOUR_API_KEY`
Gemini	`x-goog-api-key`	`YOUR_API_KEY`

不要在浏览器前端暴露 API Key

Key 应保存在服务端环境变量或密钥管理服务中，不要写入网页源码、Git 仓库、日志或截图。

MODEL DISCOVERY

查询可用模型

模型列表会根据 API Key 的分组动态返回。后续示例中的 YOUR_MODEL_ID 必须替换为接口返回的实际 id。

Terminal

curl https://api.6bai.top/v1/models \
  -H "Authorization: Bearer $SIXB_API_KEY"

建议在程序启动或定时任务中缓存模型列表，不要为每一次生成请求重复查询。

REST API

API 调用示例

Chat Completions

适用于大多数 OpenAI 兼容客户端，也是验证接入是否成功的最直接方式。

cURL

curl https://api.6bai.top/v1/chat/completions \
  -H "Authorization: Bearer $SIXB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {"role": "user", "content": "用一句话介绍你自己"}
    ]
  }'

Responses API

OpenAI 分组支持 Responses API。Codex 等新客户端使用该协议；具体模型是否支持工具、图片等能力，以模型和分组配置为准。

cURL

curl https://api.6bai.top/v1/responses \
  -H "Authorization: Bearer $SIXB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "input": "写一个用于检查服务健康状态的 Bash 命令"
  }'

OFFICIAL SDK

OpenAI SDK 示例

Python

Python 3.9+

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["SIXB_API_KEY"],
    base_url="https://api.6bai.top/v1",
)

response = client.chat.completions.create(
    model="YOUR_MODEL_ID",
    messages=[
        {"role": "user", "content": "你好，请回复连接成功"}
    ],
)

print(response.choices[0].message.content)

pip install --upgrade openai

Node.js

JavaScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.SIXB_API_KEY,
  baseURL: "https://api.6bai.top/v1",
});

const response = await client.chat.completions.create({
  model: "YOUR_MODEL_ID",
  messages: [
    { role: "user", content: "你好，请回复连接成功" },
  ],
});

console.log(response.choices[0].message.content);

npm install openai

SERVER-SENT EVENTS

流式输出

在请求体中加入 "stream": true 即可启用 SSE 流式响应。生产环境应逐事件消费数据，不要等待整个响应完成后再读取。

cURL

curl -N https://api.6bai.top/v1/chat/completions \
  -H "Authorization: Bearer $SIXB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [{"role": "user", "content": "逐步解释快速排序"}],
    "stream": true
  }'

客户端读取超时建议设为 300 秒以上，并保留对 429、502、503、504 的有限重试。

COMPATIBILITY

协议与端点

协议	Base URL / 端点	用途
OpenAI	`https://api.6bai.top/v1`	Models、Responses、Chat Completions
Anthropic	`https://api.6bai.top/v1/messages`	Claude SDK、Claude Code
Gemini	`https://api.6bai.top/v1beta`	Gemini 原生 generateContent

端点存在不等于当前 Key 一定可用。Key 所属分组必须支持对应协议和模型，否则会返回权限、模型或平台不兼容错误。

CODEX CLI

Codex 接入

在 ~/.codex/config.toml（Windows 为 %USERPROFILE%\.codex\config.toml）中添加自定义模型提供方：

config.toml

model_provider = "6bai"
model = "YOUR_MODEL_ID"

[model_providers.6bai]
name = "6B AI"
base_url = "https://api.6bai.top/v1"
env_key = "SIXB_API_KEY"
wire_api = "responses"

启动 Codex 前设置密钥环境变量：

macOS / Linux

export SIXB_API_KEY="YOUR_API_KEY"
codex

Windows PowerShell

$env:SIXB_API_KEY="YOUR_API_KEY"
codex

推荐从控制台生成配置

进入“密钥管理”，点击对应 Key 的“使用”，可根据 Key 分组获得更精确的 Codex 配置。

CLAUDE CODE

Claude Code 接入

仅适用于支持 Anthropic Messages 协议的 Key 分组。

macOS / Linux

export ANTHROPIC_BASE_URL="https://api.6bai.top"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export CLAUDE_CODE_ATTRIBUTION_HEADER=0
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL="https://api.6bai.top"
$env:ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
$env:CLAUDE_CODE_ATTRIBUTION_HEADER="0"
claude

GEMINI NATIVE

Gemini 原生协议

Gemini 分组支持原生 v1beta 路径。先查询模型，再替换下方路径中的模型 ID。

cURL

curl "https://api.6bai.top/v1beta/models/YOUR_MODEL_ID:generateContent" \
  -H "x-goog-api-key: $SIXB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"parts": [{"text": "你好，请回复连接成功"}]}
    ]
  }'

PRODUCTION

生产环境建议

密钥隔离：开发、测试、生产分别创建 Key，定期轮换并及时删除泄露 Key。
超时设置：普通请求建议 120 秒以上，长上下文和流式请求建议 300 秒以上。
有限重试：仅对 429 和临时性 5xx 使用指数退避；避免无限重试和并发重试风暴。
记录请求 ID：保存响应头中的 X-Request-Id，排查问题时一并提供。
用量监控：在控制台查看用量与错误记录，为余额、速率和并发设置告警。
服务端调用：不要让浏览器、桌面安装包或公开仓库直接持有长期 Key。

TROUBLESHOOTING

常见错误排查

状态码	常见原因	处理建议
`400`	请求体、参数或模型 ID 不正确	检查 JSON、接口协议和模型列表
`401`	未携带 Key、Key 错误或已失效	检查鉴权头，重新创建或启用 Key
`403`	分组权限、模型权限或访问限制	确认 Key 分组与目标协议匹配
`404`	当前分组不支持该端点或能力	切换兼容分组，或改用已支持端点
`429`	速率、并发或上游配额受限	降低并发并使用指数退避重试
`5xx`	临时上游或网关异常	有限重试并保留请求 ID 联系客服

仍未解决？

请提供发生时间、接口路径、模型 ID、状态码和 X-Request-Id。不要发送完整 API Key。

查看控制台记录

参考资料

SDK 与 Codex 配置字段参考官方文档；网关路由与鉴权能力依据 Sub2API 上游源码及本站线上响应核对。

OpenAI API Quickstart Codex Config Reference Sub2API

最后更新：2026-07-28

6B AI 接入文档

快速开始

登录并准备额度

创建 API Key

查询模型并发起请求

鉴权方式

查询可用模型

API 调用示例

Chat Completions

Responses API

OpenAI SDK 示例

Python

Node.js

流式输出

协议与端点

Codex 接入

Claude Code 接入

Gemini 原生协议

生产环境建议

常见错误排查

参考资料