Base URL
Authorization 头中使用你的 API token。
端点
对话与补全
OpenAI 兼容的对话和文本补全,通过
POST /v1/chat/completions 和 POST /v1/completions。OpenAI Responses
OpenAI Responses 格式,通过
POST /v1/responses。Claude Messages
Anthropic Claude Messages 格式,通过
POST /v1/messages。Gemini 对话
Google Gemini generateContent 格式,通过
POST /v1beta/models/{model}:generateContent。图片
图片生成和编辑,通过
POST /v1/images/generations 和 POST /v1/images/edits。音频
语音转文字、翻译和文字转语音,通过
/v1/audio/* 端点。视频
视频生成任务,通过 Sora 兼容、Kling、即梦、豆包和 Vidu 服务商。
向量嵌入
文本向量嵌入,通过
POST /v1/embeddings。重排序
文档重排序(Cohere/Jina 格式),通过
POST /v1/rerank。实时对话
基于 WebSocket 的实时对话,通过
GET /v1/realtime。模型列表
列出可用模型,通过
GET /v1/models。通用请求头
| 头字段 | 是否必需 | 说明 |
|---|---|---|
Authorization | 是(大多数端点) | Bearer token:Authorization: Bearer YOUR_TOKEN |
Content-Type | 是 | 所有 JSON 请求体设为 application/json |
x-api-key | 是(Claude 端点) | 调用 /v1/messages 时使用你的 OpenOpen8 token |
anthropic-version | 是(Claude 端点) | 使用 Claude Messages 格式时必须为 2023-06-01 |
x-goog-api-key | 是(Gemini 端点) | 调用 /v1beta/models/* 时使用你的 OpenOpen8 token |
HTTP 状态码
| 状态码 | 含义 |
|---|---|
200 | 请求成功。响应体包含模型输出。 |
400 | 请求错误。请求体格式错误或缺少必填字段。 |
401 | 未授权。Token 缺失或无效。 |
403 | 禁止访问。Token 无权使用请求的模型。 |
429 | 请求过多。你已超过该 token 或模型的限速。 |
500 | 服务器内部错误。OpenOpen8 服务器发生意外错误。 |
503 | 服务不可用。没有上游渠道可用于请求的模型。 |