Open Eight 开发文档
Open Eight API

一次接入，
连接多种模型。

使用 OpenAI 兼容接口接入 Open Eight。一个 API Key，即可在常用 SDK、 OpenCode 和自有应用中调用控制台已开放的模型。

API BASE https://api.0008.pro/v1

快速开始

三步完成第一次调用。模型 ID 以价格页和控制台当前展示为准。使用 Codex 或 Claude 桌面版可先前往客户端下载。

1

创建账户

前往 注册页面，完成邮箱验证并登录。

2

创建 API Key

在控制台的 API Keys 页面创建密钥；完整密钥请立即妥善保存。

3

选择模型并调用

在 模型与价格 中复制模型 ID，替换下方示例中的 YOUR_MODEL_ID。

接口地址

业务请求请使用独立 API 域名；账户、价格和文档继续使用官网域名。

OpenAI 兼容 https://api.0008.pro/v1
Anthropic 消息接口 https://api.0008.pro/v1/messages
Gemini 兼容 https://api.0008.pro/v1beta
鉴权使用 HTTP 请求头 Authorization: Bearer YOUR_API_KEY。不要把官网地址 https://0008.pro 当作 API Base URL。

cURL 示例

先把密钥存入环境变量，避免写进命令历史、代码仓库或截图。

Shell · 设置环境变量
export OPEN_EIGHT_API_KEY="YOUR_API_KEY"

列出可用模型

Shell
curl https://api.0008.pro/v1/models \
  -H "Authorization: Bearer $OPEN_EIGHT_API_KEY"

对话补全

Shell
curl https://api.0008.pro/v1/chat/completions \
  -H "Authorization: Bearer $OPEN_EIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {"role": "user", "content": "请用一句话介绍 Open Eight"}
    ],
    "stream": false
  }'

OpenAI Python SDK

安装官方 SDK，然后将 base_url 指向 Open Eight。

Shell
python -m pip install --upgrade openai
Python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OPEN_EIGHT_API_KEY"],
    base_url="https://api.0008.pro/v1",
)

response = client.chat.completions.create(
    model="YOUR_MODEL_ID",
    messages=[
        {"role": "user", "content": "Hello from Open Eight"},
    ],
)

print(response.choices[0].message.content)

在 OpenCode 中使用

OpenCode 的稳定版与 v2 配置字段不同。请按你安装的版本选择一段，并把模型 ID 换成价格页中的真实值。

OpenCode 稳定版

将以下内容写入项目根目录的 opencode.json，或合并进全局配置。

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "open-eight": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Open Eight",
      "options": {
        "baseURL": "https://api.0008.pro/v1",
        "apiKey": "{env:OPEN_EIGHT_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "Open Eight · YOUR_MODEL_ID"
        }
      }
    }
  },
  "model": "open-eight/YOUR_MODEL_ID"
}

OpenCode v2

v2 使用复数 providers、package 和 settings。

opencode.jsonc · v2
{
  "$schema": "https://opencode.ai/config.json",
  "model": "open-eight/YOUR_MODEL_ID",
  "providers": {
    "open-eight": {
      "name": "Open Eight",
      "env": ["OPEN_EIGHT_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://api.0008.pro/v1"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "Open Eight · YOUR_MODEL_ID"
        }
      }
    }
  }
}

配置后启动 OpenCode，并使用 /models 检查模型是否出现。稳定版的官方自定义 Provider 说明见 OpenCode Providers； v2 说明见 OpenCode v2 Providers。

错误排查

状态常见原因处理方式
401未携带密钥、密钥错误或已失效检查 Bearer 头；必要时在控制台重新创建密钥
403账户、分组、模型或请求权限受限核对账户状态与密钥权限
429余额不足、频率过高或通道限流检查余额并使用指数退避重试
5xx上游模型或网关暂时异常记录响应中的请求标识，稍后重试

报障时可提供时间、模型 ID、HTTP 状态码和请求标识，但请隐藏完整 API Key 与敏感提示词。

密钥安全

  • 只在服务端或受控的本地环境使用 API Key，不要写入网页前端和移动端安装包。
  • 使用环境变量或密钥管理服务，不要提交到 Git 仓库。
  • 为不同项目创建不同密钥；项目结束或怀疑泄露时立即撤销。
  • 不要向任何人发送密码、完整 API Key、支付卡号或私钥。

数据处理方式与上游模型说明请阅读 Open Eight 隐私政策。