桥智 API 文档

为什么选择桥智

一站式 AI 模型接入，统一接口、统一计费

统一接口

兼容 OpenAI API 格式，一套代码调用所有模型

一个 Token

一个 API Token 访问全部 14 个模型，按量计费

透明计费

价格透明，无任何隐藏费用，控制台实时对账

广泛兼容

支持 Chatbox、字字、Cherry Studio、Claude Code、Codex

流式响应

透传官方协议，流式、工具调用、缓存全支持

安全可靠

Token 独立管理，支持单独吊销和分组权限

快速开始

三步接入，即刻使用

获取 API Token

登录管理后台，进入「令牌管理」，新建一个 API Token。Token 等同于余额密码，请妥善保管。

选择接入方式

工具	Base URL	认证方式
Claude Code CLI / IDE	`http://43.156.5.126`	ANTHROPIC_AUTH_TOKEN
Codex / OpenAI 兼容	`http://43.156.5.126/v1`	OPENAI_API_KEY
Chatbox / 字字 / Cherry	`http://43.156.5.126/v1`	Bearer Token

Claude Code 不带 /v1，Codex 带 /v1

发起请求

按下方接口文档发起第一个请求，确认返回正常即接入完成。

可用模型

共 14 个模型，覆盖 GPT / Claude / Codex 系列

GPT GPT 系列

模型名称	输入 (¥/1M)	补全 (¥/1M)	缓存读 (¥/1M)	说明
gpt-5.4	0.675	4.050	0.068	由 vivgrid 提供
gpt-5.4-mini	0.203	1.215	0.020	由 vivgrid 提供
gpt-5.5	1.350	8.100	0.135	由 vivgrid 提供
gpt-5.3-codex-spark	0.918	7.350	0.092	由 opencode 提供
gpt-5.4-openai-compact	0.675	4.050	0.068	Codex 上下文压缩专用
gpt-5.5-openai-compact	1.350	8.100	0.135	由 IKunCode 提供
codex-auto-review	0.675	4.050	0.068	由 IKunCode 提供

Claude Claude 系列

模型名称	输入 (¥/1M)	补全 (¥/1M)	缓存读 (¥/1M)	说明
claude-haiku-4-5-20251001	0.750	3.750	0.075	Claude Haiku 4.5
claude-sonnet-5	1.500	7.500	0.150	Claude Sonnet 5
claude-sonnet-4-6	2.250	11.250	0.225	Claude Sonnet 4.6
claude-opus-4-6	3.750	18.750	0.375	Claude Opus 4.6
claude-opus-4-7	3.750	18.750	0.375	Claude Opus 4.7
claude-opus-4-8	3.750	18.750	0.375	Claude Opus 4.8
claude-fable-5	22.500	112.500	2.250	Claude Fable 5

工具配置

选择你的工具查看配置方法

Claude Code

编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://43.156.5.126",
    "ANTHROPIC_AUTH_TOKEN": "你的桥智API Token"
  }
}

Base URL 不带 /v1

Codex / OpenAI 兼容

~/.codex/auth.json：

{
  "OPENAI_API_KEY": "你的桥智API Token"
}

~/.codex/config.toml：

model_provider = "桥智"
model = "gpt-5.5"
[model_providers.桥智]
base_url = "http://43.156.5.126/v1"

Chatbox / 字字 / Cherry Studio

API Base URL: http://43.156.5.126/v1
API Key:     你的桥智API Token
模型:        从模型列表中选择

CC-Switch（推荐）

1. 下载并打开 CC-Switch
2. 添加供应商
3. 填入：
  名称：桥智
  Base URL：http://43.156.5.126/v1
  Key：你的桥智 Token
4. 保存并切换

API 接口

兼容 OpenAI API 格式

POST /v1/chat/completions

POST http://43.156.5.126/v1/chat/completions
Authorization: Bearer 你的桥智API Token
Content-Type: application/json

{
  "model": "gpt-5.4",
  "messages": [{"role": "user", "content": "你好"}],
  "max_tokens": 2000,
  "temperature": 0.7,
  "stream": false
}

请求参数

参数	类型	说明
model	string	模型名称（必填）
messages	array	消息列表（必填）
max_tokens	int	最大生成 token 数
temperature	float	温度 0-2，默认 0.7
stream	bool	是否流式，默认 false
tools	array	工具调用定义

响应示例

{
  "id": "resp_xxxxx",
  "object": "chat.completion",
  "model": "gpt-5.4",
  "choices": [{
    "message": {"role": "assistant", "content": "你好！"},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 10, "completion_tokens": 20}
}

GET /v1/models

获取可用模型列表

GET http://43.156.5.126/v1/models
Authorization: Bearer 你的桥智API Token

SDK 调用示例

使用你熟悉的语言快速接入

Python

from openai import OpenAI
client = OpenAI(
    api_key="你的桥智API Token",
    base_url="http://43.156.5.126/v1"
)
response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)

cURL

curl http://43.156.5.126/v1/chat/completions \
  -H "Authorization: Bearer 你的Token" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.4","messages":[{"role":"user","content":"你好"}]}'

JavaScript

const r = await fetch('http://43.156.5.126/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer 你的Token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gpt-5.4',
    messages: [{ role: 'user', content: '你好' }]
  })
});
const data = await r.json();
console.log(data.choices[0].message.content);

流式响应

设置 "stream": true

// SSE 流响应：
data: {"choices":[{"delta":{"content":"你好"}}]}
data: {"choices":[{"delta":{"content":"！"}}]}
data: [DONE]

常见问题

接入过程中的高频问题

Base URL 到底带不带 /v1？▼

Claude Code：http://43.156.5.126（不带 /v1）
Codex/OpenAI：http://43.156.5.126/v1（带 /v1）

报 401 / 鉴权失败？▼

检查：Token 是否完整复制、Base URL 是否正确、Token 位置是否放对、改完是否重启终端

提示模型不存在？▼

1. 换成模型列表里的实际 ID
2. 检查 Token 分组是否覆盖该模型

支持流式、工具调用、缓存吗？▼

支持。桥智透传官方协议，所有特性和直连官方一致。

支持哪些客户端？▼

Chatbox、字字、Cherry Studio、Claude Code、Codex、Cursor、VS Code 插件等所有 OpenAI 兼容客户端。