# 地址与鉴权

> 平台 API 共用的当前地址与虚拟密钥，适用于文本调用、媒体生成以及文件和素材操作。

平台 API 的文本调用、媒体生成、文件与素材操作都使用本页的地址和虚拟密钥。其他页面只补充各自特有的请求头，鉴权规则以本页为准。

<a id="access-section-1"></a>

## 地址

当前网关根地址为 `https://platform.sgt.site`。发送 HTTP 请求时，直接在根地址后加完整接口路径，例如 `/v1/models`、`/media/v1/images/generations` 或 `/api/files/upload`。网页示例、复制内容和导出文档均使用此地址。

本文档中的 `GATEWAY_ORIGIN` 始终表示根地址，不包含末尾 `/` 或接口路径；不要把完整请求地址当成 Base URL，也不要重复追加 `/v1`。用 OpenAI、Anthropic 或 Gemini SDK 调用文本模型时，各 SDK 的 Base URL 写法不同，见[文本模型调用：鉴权与 SDK 配置](llm-api.md#llm-api-section-2)。

<a id="access-h-c3ce00f5"></a>

### 旧接口兼容截止时间

兼容版本上线后，以下旧入口临时恢复，到 **2026-11-09 00:00（北京时间，UTC+08:00）** 统一停止接收请求并返回 HTTP 410。截止时间固定，不随部署或重启顺延。请提前迁移提交和查询地址；历史任务继续使用原任务 ID 查询，不要重新生成。

| 旧入口 | 替代入口 |
| --- | --- |
| `/api/v3/...` | `/volcengine/api/v3/...` |
| `/v2/video_generation`、`/v2/query/video_generation/{task_id}` | 在原路径前加 `/minimax` |
| `/v1/midjourney/...` | `/midjourney/v1/...` |
| `/v1beta/models/{Gemini图片模型}:generateContent`、`:streamGenerateContent`，以及 `/v1/models/` 下的同类图片调用 | `/gemini/v1beta/models/{模型}:generateContent`、`:streamGenerateContent` |
| `/?Action=...`、`/api/ark/assets` | [平台文件与素材接口](media-files.md)，需按新协议调整参数 |

旧入口继续校验原有凭证、权限和预算，响应携带 `Sunset: Sun, 08 Nov 2026 16:00:00 GMT` 和指向替代地址的 `Link`，不重定向请求。到期前已受理的请求继续处理；到期后的查询需使用替代地址。若环境已显式停用旧素材入口，以环境停用设置为准。

上述期限不影响文本协议、厂商前缀入口、`/media/v1`、APIMart 和 `/mj`。此前未发布的旧 3D 路径，以及已退役的 Google Files、Batch、Interactions 接口不恢复。

<a id="access-h-dcafcaeb"></a>

## 准备虚拟密钥

使用平台签发给使用人或应用的**虚拟密钥**（控制台中显示为“API 密钥”），在请求头中携带完整值：

```http
Authorization: Bearer YOUR_VIRTUAL_KEY
```

将 `YOUR_VIRTUAL_KEY` 替换为完整密钥，保留密钥本身的前缀。它不是厂商 API Key，也不是网页登录凭证。密钥确定本次调用的主体及其模型权限、额度和 IP 限制。

各页的 curl 示例都使用下面两个变量。先在终端设置好，之后可以直接复制执行：

```bash
export GATEWAY_ORIGIN="https://platform.sgt.site"
export KEY="替换为你的完整虚拟密钥"
```

| 请求头 | 是否必填 | 说明 |
| --- | --- | --- |
| `Authorization` | 是，使用 Bearer 时 | `Bearer` 后加一个空格，再填写完整虚拟密钥 |
| `Accept` | 否 | 普通 JSON 请求可设为 `application/json` |
| `Content-Type` | JSON 提交时必填 | 设置 `application/json`；GET 查询无请求体，不需要此头 |

Bearer 适用于全部平台 API。部分接口另外接受其他写法：文本协议可用 `x-api-key` 或 `x-goog-api-key`，见[文本模型调用](llm-api.md#llm-api-section-2)；文件与素材接口可用 `X-API-Key`，见[文件与素材约定](business-auth.md)。不要同时添加多种鉴权头，以免切换响应格式。不要把密钥放进请求 URL，或发送给生成结果中的第三方媒体地址。

<a id="access-h-20e71408"></a>

## 调用前提

密钥必须有效，平台按所属使用人或应用及其组织状态确认访问资格。发起模型生成还需要消费身份、目标模型授权和可用预算；虚拟密钥设置的模型、额度和 IP 限制也会生效。文件和素材操作的企业绑定、存储要求及额度规则见[文件与素材约定](business-auth.md)。

未归属企业的平台管理账号不具有模型消费资格，其密钥可能返回 HTTP 403、`platform_management_not_consumer`。调用模型应使用企业成员或应用的密钥。

<a id="access-section-2"></a>

## 下一步

| 要做的事 | 先看 |
| --- | --- |
| 调用文本模型 | [模型列表：只列出文本模型](models.md#models-text-filter)，再看[文本模型调用](llm-api.md) |
| 生成图片、视频或 3D | [模型列表：媒体模型](models.md#models-media)，再看对应生成页；完整流程见[快速开始](overview.md) |
| 上传参考图、首帧或素材 | [参考文件与素材](media-files.md) |

查询模型列表只读取目录，不会生成内容或产生模型调用费用。