OVOAI 控制台

Base URL

模型 API 的 Base URL 是 https://api.ovoai.loux.cc/v1。请直接使用本页示例中的地址；如果地址未来发生变化，我们会提前在服务状态页公告。

认证

在控制台创建命名 API Key。完整明文只在创建后展示一次；请把它保存在本地密钥管理器中，并通过 Authorization: Bearer 发送。不要把 Key 写入源码、截图、日志或聊天记录。

查询模型

curl https://api.ovoai.loux.cc/v1/models \
  -H "Authorization: Bearer $OVOAI_API_KEY"

第一次请求

curl https://api.ovoai.loux.cc/v1/chat/completions \
  -H "Authorization: Bearer $OVOAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<MODEL_ID>","messages":[{"role":"user","content":"Hello"}],"stream":false}'

请求体使用 OpenAI Chat Completions 结构。可用模型与最新价格请以模型页为准，本页不重复维护一份价格清单。

JSON 响应

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "choices": [{ "message": { "role": "assistant", "content": "<TEXT>" } }]
}

SSE 流式响应

将 stream 设为 true，并逐行读取 text/event-stream：

curl https://api.ovoai.loux.cc/v1/chat/completions \
  -H "Authorization: Bearer $OVOAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<MODEL_ID>","messages":[{"role":"user","content":"Hello"}],"stream":true}'

data: {"choices":[{"delta":{"content":"Hello"}}]}
data: [DONE]

错误处理

错误响应保持 JSON，并通过 HTTP 状态码区分认证、请求和服务问题：

{
  "error": {
    "code": "invalid_request",
    "message": "Request could not be accepted"
  }
}

不要重试 401 或 403；对 429 和暂时性的 5xx 使用有上限的指数退避，并避免记录 Authorization 头。