> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 接口端点总览

> 查看 APIONE 支持的协议地址、模型查询、图像和视频端点。

所有接口使用 HTTPS，并通过同一个 APIONE API Key 鉴权。

| 方法 | 完整路径 | 用途 |
| - | - | - |
| POST | `https://api.apione.ai/v1/chat/completions` | OpenAI Chat Completions |
| POST | `https://api.apione.ai/v1/responses` | OpenAI Responses |
| POST | `https://api.apione.ai/v1/messages` | Anthropic Messages |
| POST | `https://api.apione.ai/v1beta/models/{model}:generateContent` | Gemini 非流式生成 |
| POST | `https://api.apione.ai/v1beta/models/{model}:streamGenerateContent` | Gemini 流式生成 |
| GET | `https://api.apione.ai/v1/models` | 查询当前 Key 可用模型 |
| GET | `https://api.apione.ai/v1/models/{model}/params` | 查询模型参数和计费模式 |
| POST | `https://api.apione.ai/v1/images/generations` | 图像生成 |
| POST | `https://api.apione.ai/v1/images/edits` | 图像编辑 |
| POST | `https://api.apione.ai/v1/videos` | 创建视频任务 |
| GET | `https://api.apione.ai/v1/videos/{id}` | 查询视频任务 |

## 公共请求头

```http theme={null}
Authorization: Bearer YOUR_APIONE_API_KEY
Content-Type: application/json
```

Anthropic 和 Gemini 原生协议还支持各自的 Key 请求头。一次请求只发送一种鉴权凭证。

保存实际响应中的请求标识及字段名：`X-Request-ID`、`X-Maxx-Trace-Id` 或 `X-Maxx-Request-ID`。不同接口不保证同时返回全部字段；本地业务 ID 另行记录，不要假设自定义请求头会被原样回传。

## 版本路径

`/v1` 和 `/v1beta` 是接口版本的一部分。配置 SDK 时不要把完整端点误填为 Base URL，也不要形成 `/v1/v1/...`。

## 按任务查端点

### 文本对话

普通多轮对话使用 Chat Completions；已有 Responses 工作流或 Codex 类工具使用 Responses。两者不能只替换路径而沿用完全相同的请求体。

### 原生协议

Anthropic Messages 和 Gemini generateContent 使用各自的消息结构与鉴权习惯。选择原生协议时，按对应页面构造请求，不要把 OpenAI 的 `messages` 结构直接发送到 Gemini 端点。

### 图像和视频

图像生成、图像编辑和视频生成属于媒体接口。提交前先查询模型参数。视频为异步任务：`POST /v1/videos` 创建，`GET /v1/videos/{id}` 查询；不要让单个创建请求一直等待生成结束。

## 响应处理通则

* 成功响应：按具体接口读取正文、结果对象或任务 ID。
* 错误响应：同时记录 HTTP 状态和脱敏后的响应正文。
* 请求跟踪：保存实际返回的请求标识及字段名，便于在控制台或支持工单中定位。
* 动态能力：模型、参数、价格和输出格式以当前 Key 的查询结果为准。

## 上线前端点检查

```text theme={null}
[ ] 域名是 api.apione.ai，不是控制台地址
[ ] SDK Base URL 与手写 HTTP 完整端点没有混用
[ ] /v1 或 /v1beta 只出现一次
[ ] Key 与模型属于同一 APIONE 账户和可用分组
[ ] 超时、重试和日志策略已设置
[ ] 日志不会输出完整 API Key 或敏感输入
```

下一步：[选择接入协议](https://apione.ai/docs/getting-started/protocol-selection.md)、[请求跟踪与重试](https://apione.ai/docs/api/request-reliability.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.