接口端点总览

所有接口使用 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}`	查询视频任务

公共请求头

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 的查询结果为准。

上线前端点检查

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

下一步：选择接入协议、请求跟踪与重试。

地址与鉴权

模型接口

输出与进阶用法

图像 API

视频 API