本页目录
Base URL
text
OpenAI 兼容 https://api.apione.ai/v1
Anthropic 兼容 https://api.apione.ai
Gemini 兼容 https://api.apione.ai/v1beta只提供 HTTPS。所有协议都在同一域名下，同一把 Key 通用，无需按厂商切换地址。
端点一览
| 方法 | 路径 | 用途 |
|---|---|---|
| POST | /v1/chat/completions | 对话补全（OpenAI 协议） |
| POST | /v1/responses | 对话补全（OpenAI Responses 协议） |
| POST | /v1/messages | 对话补全（Anthropic 协议） |
| POST | /v1beta/models/{model}:generateContent | 对话补全（Gemini 协议），流式用 :streamGenerateContent |
| GET | /v1/models | 当前 Key 可调用的模型列表 |
| GET | /v1/models/{model}/params | 单个模型支持的参数与计费方式 |
| POST | /v1/images/generations | 图像生成 |
| POST | /v1/images/edits | 图像编辑 |
| POST | /v1/videos | 提交视频生成任务 |
| GET | /v1/videos/{id} | 查询视频任务进度与结果 |
公共请求头
Authorizationstring三选一Bearer YOUR_APIONE_KEY。Anthropic 协议也可用 x-api-key，Gemini 协议也可用 x-goog-api-key；一次请求只能带其中一个，同时带多个会被拒绝。
Content-Typestring必填POST 请求固定为 application/json。
X-Maxx-Request-IDstring可选。你自己的追踪 id（不超过 128 个可打印 ASCII 字符），会作为本次请求的 ID 记录，排查时可直接检索。
公共响应头
| 响应头 | 含义 |
|---|---|
X-Maxx-Request-ID | 本次请求的 ID。在控制台 › 用量 › 请求明细里可按它检索，联系支持时也请附上 |
Retry-After | 被限流时建议的等待秒数 |
版本策略
路径里的 /v1 是接口大版本。向后兼容的变更（新增字段、新增可选参数、新增模型）会直接生效，不改版本号；破坏性变更会启用新的版本前缀，并在旧版本停用前至少提前 6 个月公告。
注意
请把响应体当作可能新增字段的结构解析。使用严格模式的解析器（如未开启 ignoreUnknown 的强类型反序列化）会在我们新增字段时报错。
联系我们
文档没写清楚，或者需要人工协助？按问题类型选一个渠道即可。