# 地址与认证

接入由 **Base URL、API Key、Model ID** 三项组成。三者对应正确后，再确认密钥权限与账户额度。

## 配置项

网页地址随业务域切换；下载 .md 使用 123ali.com 示例，请以[工作台](../dashboard.html#keys)的 Base URL 为准。未知或预览域不提供接入地址。

<!-- model-base-url:start -->

| 配置 | 作用 | 示例 |
| --- | --- | --- |
| Base URL | 当前业务域对应的 `api` 子域，含 `/v1` | `https://api.123ali.com/v1` |
| API Key | 用于请求认证的密钥 | `YOUR_API_KEY` |
| Model ID | 要调用的具体模型 | 从本站服务端目录复制完整 ID，不按示例名称猜测 |

<!-- model-base-url:end -->

OpenAI 兼容接口通过请求头发送密钥：

```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## 选择正确的接口

| 接口 | 请求路径 | 用途 |
| --- | --- | --- |
| 文本对话 | `POST /v1/chat/completions` | 常规文本、流式对话和兼容的多模态输入 |
| Responses | `POST /v1/responses` | 采用 Responses 格式的模型调用 |
| 图片生成 | `POST /v1/images/generations` | 支持此协议的图片模型 |
| 图片编辑 | `POST /v1/images/edits` | 按模型说明提供图片与编辑指令 |
| 视频任务 | `POST /v1/videos` | 支持 OpenAI 兼容视频协议的通道 |

原生 Claude、Gemini 和部分视频通道可能需要不同路径或参数。模型能否通过某个接口调用，取决于部署版本、通道配置和模型支持；不要仅凭模型名称判断。

## 密钥与权限

- 把密钥放在服务端环境变量中，前端应用通过自己的服务端转发请求。
- 登录工作台通过真实密钥服务创建应用 Key；是否可创建及可选分组以服务端配置与账户权限为准。不生成演示密钥，创建后按一次性展示提示妥善保管。
- 排查错误时记录请求 ID 与错误信息，分享日志前移除密钥。