# 接口与状态总览

> 平台 API 的文本、媒体生成、任务、文件与素材接口及结果位置速查。

本页用于已确定协议后的接口速查。首次接入请从[快速开始](overview.md)开始；完整请求体和响应示例见各接口页。

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

## 提交、查询与输出

将每行的 Base URL 与提交或查询的相对路径拼接一次；表中地址随当前网关展示。

| 能力/协议 | Base URL | 提交（相对路径） | 查询（相对路径） | 成功输出 |
| --- | --- | --- | --- | --- |
| 通用模型目录（含文本模型） | `https://platform.sgt.site` | — | `GET /v1/models`、`GET /v1/models/{model}` | `data[].id`；返回全部类型的模型，文本模型按 `native_endpoint_types` 筛选，见[模型列表：只列出文本模型](models.md#models-text-filter) |
| 媒体模型列表 | `https://platform.sgt.site/media/v1` | — | `GET /models`、`GET /models/{model}` | `data[]` 能力对象；见[模型列表：媒体模型](models.md#models-media) |
| 文本模型，OpenAI Chat Completions | `https://platform.sgt.site` | `POST /v1/chat/completions` | 同步返回或 SSE 流式 | `choices[].message` |
| 文本模型，OpenAI Responses | `https://platform.sgt.site` | `POST /v1/responses` | 同上 | `output[]` |
| 文本模型，Anthropic Messages | `https://platform.sgt.site` | `POST /v1/messages` | 同上 | `content[]` |
| 文本模型，Gemini | `https://platform.sgt.site` | `POST /v1beta/models/{model}:generateContent`（或 `/v1/models/{model}:…`） | 同步；流式用 `:streamGenerateContent?alt=sse` | `candidates[].content.parts[]` |
| 媒体平台图片（含 Nano Banana 四款、GPT Image 三款） | `https://platform.sgt.site/media/v1` | `POST /images/generations`；GPT 参考图编辑也用此地址 | `wait=0..50` 或 `GET /tasks/{id}` | `media.task` 中的 `artifacts[]`；另读 `billing` |
| GPT Image 直接生成/编辑 | `https://platform.sgt.site/v1` | `POST /images/generations`、`POST /images/edits` | 当前已核对同步 JSON；没有媒体任务查询 | `data[].b64_json`；当前型号与能力边界见[GPT Image 生成与编辑](gpt-images.md) |
| 媒体平台视频 | `https://platform.sgt.site/media/v1` | `POST /videos/generations` | `GET /tasks/{id}` | `artifacts[]`；另读 `billing` |
| 媒体平台 3D | `https://platform.sgt.site/media/v1` | `POST /3d/generations` | `GET /tasks/{id}` | 限时签名 `artifacts[]`；另读 `billing` |
| 媒体平台文件与素材 | `https://platform.sgt.site/media/v1` | `POST /files` | `GET /files/{id}` | `media.file`；参考文件 `id` 与厂商 `asset_id` 区分使用 |
| 上传素材 | `https://platform.sgt.site` | `POST /api/volcengine/assets/create` | `POST /api/volcengine/assets/check` | `data.id`，`data.status` |
| 上传文件 | `https://platform.sgt.site` | `POST /api/files/upload` | 同步返回 | `data.file_url`（7 天有效） |

上述能力同属平台 API。使用厂商原生客户端时，可另读补充的[厂商原生兼容](official.md)说明。

文件链接按对应接口的有效期与鉴权说明下载，不向第三方产物地址附带平台密钥。

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

## 任务 ID 和状态不能混用

媒体平台生成返回的 `id` 是任务标识，使用 `GET /media/v1/tasks/{id}` 读取同一任务的 `status`。`queued`、`running` 表示尚未完成，`reconciling` 表示结果仍待核对；`succeeded` 表示生成成功，`failed`、`cancelled`、`expired` 表示相应终态。

始终使用提交任务的协议查询，不要从其他字段猜测 ID。媒体任务还需独立读取产物可读状态和账务状态，详见[任务查询与结算](media-tasks.md)。