接口参数与响应
下列示例来自本地模拟上游；实际响应字段、可选参数和取值取决于上游模型。所有接口都需要 Bearer 令牌；POST 请求使用 application/json。
GET /v1/models
无需请求体或查询参数。返回令牌、分组和渠道允许的模型；无可用模型时 data 为空。
{"object":"list","data":[{"id":"mock-gpt","object":"model","owned_by":"openai","created":0}]}令牌无效返回 401，IP 或分组无权限返回 403。
POST /v1/chat/completions
| 参数 / 状态 | 说明 |
|---|---|
model | 必填，模型 ID，最长 128 字节 |
messages | 必填，文本消息数组，格式由上游决定 |
stream | 可选，true 时通过 SSE 返回 |
max_completion_tokens / max_tokens | 可选，整数 1 至模型配置上限；默认取 4096 与上限的较小值 |
n | 可选，仅支持 1 |
tools / tool_choice / response_format | 可选，转发上游；tools 仅支持 function 类型 |
temperature / top_p 等 | 可选，转发上游；支持情况由上游决定 |
{"id":"chatcmpl_mock","object":"chat.completion","model":"mock-gpt","choices":[{"index":0,"message":{"role":"assistant","content":"你好"},"finish_reason":"stop"}],"usage":{"prompt_tokens":13,"completion_tokens":7,"total_tokens":20}}缺少 messages 或参数无效返回 400，额度不足返回 402。流式请求强制 stream_options.include_usage=true。
data: {"id":"chatcmpl_mock","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"你好"},"finish_reason":null}]}
data: [DONE]POST /v1/responses
| 参数 / 状态 | 说明 |
|---|---|
model | 必填，模型 ID |
input | 必填，文本输入；格式由上游决定 |
stream | 可选，true 时通过 SSE 返回 |
max_output_tokens | 可选，整数 1 至模型上限；默认取 4096 与上限的较小值 |
tools 及其他兼容字段 | 可选，转发上游；tools 仅支持 function 类型 |
store | 平台强制设为 false |
不支持 previous_response_id、conversation 和 background=true；缺少 input 或使用不支持功能返回 400。
curl https://api.oziv.cc/v1/responses -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model":"YOUR_MODEL","input":"你好"}'{"id":"resp_mock","object":"response","status":"completed","model":"mock-gpt","output":[{"type":"message","role":"assistant","content":[{"type":"output_text","text":"你好"}]}],"usage":{"input_tokens":13,"output_tokens":7,"total_tokens":20}}POST /v1/embeddings
| 参数 / 状态 | 说明 |
|---|---|
model | 必填，模型 ID |
input | 必填，文本输入；格式和大小限制由上游决定 |
encoding_format / dimensions / user | 可选，转发上游；支持情况由上游决定 |
stream | 不支持 true |
curl https://api.oziv.cc/v1/embeddings -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model":"YOUR_MODEL","input":"你好"}'{"object":"list","model":"mock-gpt","data":[{"object":"embedding","index":0,"embedding":[0.1,0.2,0.3]}],"usage":{"prompt_tokens":13,"total_tokens":13}}缺少 input 或请求流式输出返回 400；向量维度由上游决定。