API 总览

基本信息

项目	值
API 地址	https://api.monoai.today
OpenAI 兼容 base URL	https://api.monoai.today/v1
鉴权	Authorization: Bearer <API Key> 或 x-api-key: <API Key>
请求体	application/json
响应体	application/json
流式响应	text/event-stream（SSE）

端点列表

方法	路径	说明
GET	/v1/models	获取可用模型列表
POST	/v1/chat/completions	OpenAI Chat Completions
POST	/v1/responses	OpenAI Responses
POST	/v1/messages	Anthropic Messages
POST	/v1/embeddings	文本向量
POST	/v1/images/generations	图像生成
POST	/v1/images/edits	图像编辑

请求路径区分大小写。所有路径以 /v1/ 开头。

流式响应

Chat Completions、Responses 与 Messages 支持流式响应。在请求体中设置：

{ "stream": true }

响应为 SSE 事件流：

data: {"id":"...","choices":[{"delta":{"content":"你"}}]}

data: {"id":"...","choices":[{"delta":{"content":"好"}}]}

data: [DONE]

不同协议的事件格式不同。使用官方 SDK 时，SDK 会处理事件流。

模型参数

model 必须是模型列表中返回的准确 ID。模型 ID 可能包含提供方前缀或版本号，例如：

<提供方>/<模型名>

请求前请先调用 GET /v1/models 获取当前值。

请求示例

curl https://api.monoai.today/v1/chat/completions \
  -H "Authorization: Bearer $MONOIZE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型 ID>",
    "messages": [{ "role": "user", "content": "你好" }]
  }'

错误处理

请求失败时返回非 2xx 状态码和 JSON 错误信息。常见状态码见错误与状态码。