地址与认证#
接入由 Base URL、API Key、Model ID 三项组成。三者对应正确后，再确认密钥权限与账户额度。
配置项#
网页地址随业务域切换；下载 .md 使用 123ali.com 示例，请以工作台的 Base URL 为准。未知或预览域不提供接入地址。
| 配置 | 作用 | 示例 |
|---|---|---|
| Base URL | 当前业务域对应的 api 子域，含 /v1 |
https://api.123ali.com/v1 |
| API Key | 用于请求认证的密钥 | YOUR_API_KEY |
| Model ID | 要调用的具体模型 | 从本站服务端目录复制完整 ID，不按示例名称猜测 |
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 与错误信息，分享日志前移除密钥。