跳转到主要内容
每个发送到 OpenOpen8 的请求都必须包含 token 来识别你的账户并授权访问。你在控制台创建 token,同一个 token 适用于所有端点格式——OpenAI、Anthropic Claude 和 Google Gemini。唯一的区别是使用哪个头来传递。

获取你的 Token

1

打开控制台

在浏览器中打开 OpenOpen8,例如 https://openopen8.ai
2

进入 Token 管理

点击侧边栏的 Token 管理
3

创建 Token

点击 添加 Token,起个名字,配置模型限制或配额,然后点击 提交
4

复制 Token

复制显示的 token 值。OpenOpen8 只显示一次完整 token,请妥善保存。

认证方式

OpenOpen8 支持三种认证方式,对应每个 API 系列的原生格式。三种方式使用同一个 token 值——只是头名称不同。

OpenAI 兼容(大多数端点)

Authorization 头中以 Bearer token 传递。所有标准端点使用此方式。 适用于: POST /v1/chat/completionsPOST /v1/completionsPOST /v1/responsesPOST /v1/embeddingsPOST /v1/audio/*POST /v1/images/*POST /v1/rerankGET /v1/realtimeGET /v1/models
curl https://openopen8.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Anthropic Claude

x-api-key 头中传递 token,并包含 anthropic-version 头。OpenOpen8 用这些头来识别应以 Claude Messages 格式处理的请求。 适用于: POST /v1/messages
curl https://openopen8.ai/v1/messages \
  -H "x-api-key: YOUR_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Google Gemini

x-goog-api-key 头中传递 token,或作为 key 查询参数。两者等效。 适用于: POST /v1beta/models/{model}:generateContent
curl "https://openopen8.ai/v1beta/models/gemini-2.0-flash:generateContent" \
  -H "x-goog-api-key: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello"}]}]
  }'

认证错误

状态码原因修复方法
401 UnauthorizedToken 缺失、格式错误或已被删除。检查你发送的头是否正确,token 值是否完整。
403 ForbiddenToken 存在但无权访问请求的模型。在控制台编辑 token,检查其允许的模型列表。

安全建议

永远不要将 token 放在客户端代码、浏览器 JavaScript 或公开仓库中。如果 token 泄露,立即在控制台删除并创建新的。
将 token 存储在环境变量或密钥管理器中,在运行时传递给应用。在服务器端,像对待任何其他 API 凭据一样对待你的 OpenOpen8 token。