每个发送到 OpenOpen8 的请求都必须包含 token 来识别你的账户并授权访问。你在控制台创建 token,同一个 token 适用于所有端点格式——OpenAI、Anthropic Claude 和 Google Gemini。唯一的区别是使用哪个头来传递。
获取你的 Token
打开控制台
在浏览器中打开 OpenOpen8,例如 https://openopen8.ai。
进入 Token 管理
点击侧边栏的 Token 管理。
创建 Token
点击 添加 Token,起个名字,配置模型限制或配额,然后点击 提交。
复制 Token
复制显示的 token 值。OpenOpen8 只显示一次完整 token,请妥善保存。
认证方式
OpenOpen8 支持三种认证方式,对应每个 API 系列的原生格式。三种方式使用同一个 token 值——只是头名称不同。
OpenAI 兼容(大多数端点)
在 Authorization 头中以 Bearer token 传递。所有标准端点使用此方式。
适用于: POST /v1/chat/completions、POST /v1/completions、POST /v1/responses、POST /v1/embeddings、POST /v1/audio/*、POST /v1/images/*、POST /v1/rerank、GET /v1/realtime、GET /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 Unauthorized | Token 缺失、格式错误或已被删除。 | 检查你发送的头是否正确,token 值是否完整。 |
403 Forbidden | Token 存在但无权访问请求的模型。 | 在控制台编辑 token,检查其允许的模型列表。 |
安全建议
永远不要将 token 放在客户端代码、浏览器 JavaScript 或公开仓库中。如果 token 泄露,立即在控制台删除并创建新的。
将 token 存储在环境变量或密钥管理器中,在运行时传递给应用。在服务器端,像对待任何其他 API 凭据一样对待你的 OpenOpen8 token。