API 接口清单

# API 接口清单

## 对话

| 方法 | 请求路径 | 用途 |
|---|---|---|
| POST | `/v1/chat/completions` | openai Chat Completions 协议 |
| POST | `/v1/responses` | openai Responses 协议 |
| POST | `/v1/messages` | Anthropic 协议 |

## Gemini（Google 原生协议）

| 方法 | 请求路径 | 用途 |
|---|---|---|
| POST | `/v1beta/models/{model}:generateContent` | 原生内容生成， JSON 响应 |
| POST | `/v1beta/models/{model}:streamGenerateContent?alt=sse` | 原生内容生成，SSE 流式响应 |
| POST | `/v1/models/{model}:generateContent` | 同步内容生成的 v1 入口 |
| POST | `/v1/models/{model}:streamGenerateContent?alt=sse` | 流式内容生成的 v1 入口 |

## 向量与重排序

| 方法 | 请求路径 | 用途 |
|---|---|---|
| POST | `/v1/embeddings` | 文本向量化 |
| POST | `/v1/rerank`、`/v1/reranks` | 文档重排序 |

## 图片生成

| 方法 | 请求路径 | 用途 |
|---|---|---|
| POST | `/v1/images/generations` | 图片生成 |

## 视频生成

| 方法 | 请求路径 | 用途 |
|---|---|---|
| POST | `/v1/videos/generations` | 视频生成（异步） |

## 语音

| 方法 | 请求路径 | 用途 |
|---|---|---|
| POST | `/v1/audio/transcriptions` | 语音识别（异步） |
| POST | `/v1/audio/speech` | 语音合成 |

## 异步任务查询

| 方法 | 请求路径 | 用途 |
|---|---|---|
| GET | `/v1/tasks/{task_id}` | 查询异步任务状态和结果 |

## 模型查询

| 方法 | 请求路径 | 用途 |
|---|---|---|
| GET | `/v1/models` | 查询可用模型 |
| GET | `/v1/models/{model_id}` | 查询模型详情 |

## 用量与额度

| 方法 | 请求路径 | 用途 |
|---|---|---|
| GET | `/v1/usage` | 查询累计用量 |
| GET | `/v1/account` | 查询额度策略及限制 |

## 服务检查（对内）

| 方法 | 请求路径 | 用途 |
|---|---|---|
| GET | `/health` | 健康检查 |
| GET / HEAD | `/ready` | 就绪检查 |