HTTP API 与 SDK

ooioo 提供 OpenAI 兼容接口，任何支持自定义 Base URL 的 SDK / 工具都能直接接入。

Base URL

https://ooioo.work/v1

认证

所有请求带 Header：

Authorization: Bearer sk-你的Token

支持的端点

端点	协议	用途
POST /v1/chat/completions	OpenAI Chat	通用对话，兼容面最广
POST /v1/responses	OpenAI Responses	Codex 等新工具的原生协议
POST /v1/messages	Anthropic Messages	Claude Code 等 Anthropic 生态工具
POST /v1/embeddings	OpenAI Embeddings	向量化
GET /v1/models	OpenAI Models	列出当前 Token 可用模型

可用模型以 控制台 → 模型广场 为准。

请求示例

curl

curl https://ooioo.work/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "模型名",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": true
  }'

Python（openai SDK）

from openai import OpenAI

client = OpenAI(
    base_url="https://ooioo.work/v1",
    api_key="sk-你的Token",
)

resp = client.chat.completions.create(
    model="模型名",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js（openai SDK）

import OpenAI from 'openai'

const client = new OpenAI({
  baseURL: 'https://ooioo.work/v1',
  apiKey: 'sk-你的Token',
})

const resp = await client.chat.completions.create({
  model: '模型名',
  messages: [{ role: 'user', content: '你好' }],
})
console.log(resp.choices[0].message.content)

Anthropic SDK

import anthropic

client = anthropic.Anthropic(
    base_url="https://ooioo.work",   # 注意：不带 /v1
    api_key="sk-你的Token",
)

msg = client.messages.create(
    model="模型名",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(msg.content)

长流式请求

Code / Agent 场景单个请求可能流式输出数分钟：

• 客户端不要设置过短的读超时（建议 ≥ 600s）；
• 遇到流式中断先检查本地网络与代理软件是否截断长连接；持续出现请携带请求 ID 联系我们。

错误语义

客户端应先看 HTTP 状态码，再看 error.type 区分同一状态码下的不同原因。

状态码与错误类型	含义
401	Token 无效或无权限
402 price_limit_exceeded	当前倍率超过 API Key 的最高允许倍率；请求未发送、未扣费，不要自动重试
402	余额或订阅额度不足，前往控制台充值或购买套餐
429	限流或临时繁忙，指数退避重试
5xx	服务临时异常，携带请求 ID 反馈

价格保护错误还会在顶层 price_guard 中返回 current_group_ratio 和 max_group_ratio。配置与处理方式见 API Key 价格保护。