> ## 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.

# API 地址与鉴权

> 按协议选择 SDK 基础地址、完整端点和鉴权头。

API 请求发往 `api.apione.ai`。控制台网页地址 `apione.ai/zh/app` 用于管理账户和密钥，不作为 API Base URL。

![APIONE API 地址、协议与密钥管理入口](https://mintcdn.com/apione/pAFvFGkbmcRZirTZ/images/ui/api-keys-overview.png?fit=max\&auto=format\&n=pAFvFGkbmcRZirTZ\&q=85\&s=286a882ab53c81ad3bd16d56c6487dc9)

API Key 页面集中展示 APIONE Base URL、支持协议、折扣分组和模型价格。

## 地址速查

| 协议或用途 | SDK Base URL | HTTP 完整端点 |
| - | - | - |
| [Chat Completions](https://apione.ai/docs/models/chat.md) | `https://api.apione.ai/v1` | `POST https://api.apione.ai/v1/chat/completions` |
| [OpenAI Responses](https://apione.ai/docs/api/responses.md) | `https://api.apione.ai/v1` | `POST https://api.apione.ai/v1/responses` |
| [Anthropic Messages](https://apione.ai/docs/api/anthropic.md) | `https://api.apione.ai` | `POST https://api.apione.ai/v1/messages` |
| [Gemini](https://apione.ai/docs/api/gemini.md) | `https://api.apione.ai/v1beta` | `POST https://api.apione.ai/v1beta/models/{model}:generateContent` |
| [模型列表](https://apione.ai/docs/models/catalog.md) | `https://api.apione.ai/v1` | `GET https://api.apione.ai/v1/models` |
| [模型参数](https://apione.ai/docs/models/parameters.md) | `https://api.apione.ai/v1` | `GET https://api.apione.ai/v1/models/{model}/params` |

SDK 通常自动拼接端点；HTTP 请求需要完整地址。部分客户端会自己追加版本路径，例如 Gemini CLI 使用根地址，按[对应教程](https://apione.ai/docs/guides/gemini-cli.md)配置。最终请求路径中只应出现一次 `/v1` 或 `/v1beta`。

## 请求头

| 接口 | 鉴权头 |
| - | - |
| OpenAI 兼容接口 | `Authorization: Bearer YOUR_APIONE_KEY` |
| Anthropic Messages | `x-api-key: YOUR_APIONE_KEY` |
| Gemini | `x-goog-api-key: YOUR_APIONE_KEY` |

一次请求只使用一种鉴权凭证。JSON 请求还需发送 `Content-Type: application/json`。Anthropic Messages 示例同时发送 `anthropic-version: 2023-06-01`，见[接入示例](https://apione.ai/docs/api/anthropic.md)。

## 请求跟踪

保存实际响应中的请求标识及字段名（`X-Request-ID`、`X-Maxx-Trace-Id` 或 `X-Maxx-Request-ID`）、HTTP 状态码和请求时间，方便在控制台查找请求或联系支持。日志与反馈中移除 API Key 和敏感业务内容。

## 模型与协议的关系

同一个 API Key 可以用于平台提供的各协议。先在模型详情中确认目标协议，再通过[参数接口](https://apione.ai/docs/models/catalog.md)查看该模型声明的额外参数与取值范围。接口存在，不代表每个模型都能接受它的全部参数。

图片生成、图片编辑与视频端点见[接口端点总览](https://apione.ai/docs/api/endpoints.md)。按对应模型的说明准备请求；Chat 的图片输入与图片生成是两种能力。


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