#API 端点

绝大多数客户端在配置时需要填写 API 地址（Base URL）。ByteSeek 按协议格式提供不同入口，格式由你的客户端决定，分组必须支持同一格式。

#协议入口

各格式支持的模型以模型广场实时展示为准。

#请求格式速查

每种协议的最小可用请求示例，把 sk-你的密钥 换成自己的 Key 即可直接复制运行：

curl https://tokens.byteseek.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "模型ID",
    "messages": [{ "role": "user", "content": "你好" }]
  }'

curl https://tokens.byteseek.ai/v1/responses \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "模型ID",
    "input": "你好"
  }'

curl https://tokens.byteseek.ai/v1/images/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "生图模型ID",
    "prompt": "日出时的海边灯塔，水彩风格",
    "size": "1024x1024",
    "n": 1
  }'

curl https://tokens.byteseek.ai/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "模型ID",
    "max_tokens": 1024,
    "messages": [{ "role": "user", "content": "你好" }]
  }'

示例中的 模型ID 到模型广场对应分组里复制；使用复合 Key时记得加前缀。

#分流接入地址

除默认地址外，平台提供 CN2-GIA 优质线路的分流地址，网络不佳时换线路即可，三个地址完全等价，路径规则相同：

全部端点可以在API 密钥页面顶部一键复制。

实拍截图

#该选哪个格式

一句话判断：客户端配置项叫什么，就用什么格式。

按客户端归类：

• Anthropic 格式：Claude Code，以及所有原生走 Anthropic 协议的工具
• OpenAI 格式：Codex、Cherry Studio，以及一切标注「OpenAI 兼容」的客户端

部分模型提供两个格式分组（见核心概念）。创建 Key 时按客户端选对应格式的分组，选错会直接返回 403，对应处理见错误码清单。

#认证方式

API Key 通过请求头传递，多数客户端自动处理。各格式的认证头不同：

不要通过 URL 查询参数传 Key——既不安全，也不被接受。

#填写注意

• 注意 /v1 的有无：Anthropic 格式不带，OpenAI 格式带。部分客户端会自动拼接路径，填完后拉一次模型列表验证最稳妥。
• 一律使用 https://，不要用 http://。
• 使用复合 Key时模型 ID 必须带前缀。

#相关入口

• 创建 API Key — 先拿到密钥
• 快速开始 — 按客户端选择接入方式
• 故障排查 — 连不上时的排查顺序
• 错误码清单 — 认证与请求错误的完整清单