---
title: 模型与接口
---

先调用 `GET /v1/models` 获取当前 API Key 可用的模型 ID，再根据模型能力选择接口。模型列表会随站点配置变化，调用方不应把可用模型永久写死。

| 能力 | 推荐接口 | 调用方式 |
| --- | --- | --- |
| 多轮对话、工具调用 | `POST /v1/chat/completions` | 同步或 SSE 流式 |
| 推理、内置工具、连续响应 | `POST /v1/responses` | 同步或 SSE 流式 |
| Claude Messages 协议 | `POST /v1/messages` | 同步或流式 |
| Gemini GenerateContent 协议 | `POST /v1beta/models/{model}:generateContent` | 同步 |
| 图像生成与编辑 | `POST /v1/images/generations`、`POST /v1/images/edits` | 同步或按模型返回任务 |
| 视频生成 | `POST /v1/video/generations`、`POST /v1/videos` | 创建任务后轮询 |
| 语音识别与翻译 | `POST /v1/audio/transcriptions`、`POST /v1/audio/translations` | multipart 上传 |
| 文本转语音 | `POST /v1/audio/speech` | 返回音频二进制 |
| 文本向量 | `POST /v1/embeddings` | 同步 |
| 文档重排序 | `POST /v1/rerank` | 同步 |

## 获取可用模型

```bash
curl "$NEW_API_BASE_URL/models" \
  -H "Authorization: Bearer $NEW_API_KEY"
```

响应中每个对象的 `id` 就是请求体中的 `model`。同一个模型是否支持图像输入、工具调用、结构化输出等能力，以站点提供的模型说明和实际接口响应为准。

## 基础约定

- Base URL 示例：`https://api.example.com/v1`
- 认证方式：`Authorization: Bearer sk-...`
- JSON 请求：`Content-Type: application/json`
- 流式文本：`text/event-stream`
- 异步任务：保存创建接口返回的任务 ID，并轮询状态接口

所有参数和响应 Schema 可在 [完整接口参考](/reference/relay) 中查询并在线调试。