# 地址与 SDK

> 厂商原生接口的 Base URL、请求路径和 SDK 配置，按所用厂商选择接入方式。

本页用于配置厂商原生客户端。原生接口保留已支持的官方请求与响应格式，平台 Base URL 包含厂商前缀。将下表的 Base URL 与相对路径拼接一次，并使用平台虚拟密钥；只能填写域名、内部写死路径的 SDK 不保证兼容。示例使用当前网关地址，受控错误提示与任务标识沿用平台规则。

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

## 接口地址

| 能力 | 平台 Base URL | 方法与相对路径 | 结果与完整说明 |
| --- | --- | --- | --- |
| 火山方舟文本 | `https://platform.sgt.site/volcengine` | `POST /api/v3/chat/completions` | 返回文本响应或流式增量；见[方舟文本](native-ark-text.md) |
| Seedream 图片 | `https://platform.sgt.site/volcengine` | `POST /api/v3/images/generations` | 直接返回图片或 SSE 事件；见[Seedream 图片](native-seedream.md) |
| Seedance 视频 | `https://platform.sgt.site/volcengine` | `POST /api/v3/contents/generations/tasks`；查询、删除为 `GET` / `DELETE /api/v3/contents/generations/tasks/{id}` | 返回任务 ID，查询视频与生成状态；见[Seedance 视频](native-seedance.md) |
| Gemini 图片 | `https://platform.sgt.site/gemini` | `POST /v1beta/models/{model}:generateContent` | 读取候选中的图片数据；见[Gemini 图片](native-gemini.md) |
| MiniMax H3 视频 | `https://platform.sgt.site/minimax` | `POST /v2/video_generation`；`GET /v2/query/video_generation/{task_id}` | 返回任务 ID，查询视频结果；见[MiniMax H3](native-h3.md) |
| 可灵视频 | `https://platform.sgt.site/kling` | `POST /{operation}/{model}`；`GET /tasks?task_ids={id}` | 按任务 ID 查询输出；见[可灵视频](native-kling.md) |
| 腾讯混元与 Tripo 3D | `https://platform.sgt.site/tencent` | `POST /v1/api/3d/submit` | 保存平台任务 ID，按型号查询与下载；见[腾讯 3D](native-tencent-3d.md) |

目录中是否出现某个模型，取决于当前虚拟密钥的授权、有效价格及渠道可用性；先按[模型列表：通用模型目录](models.md#models-text)（`GET /v1/models`）确认型号，再使用对应页面列出的参数。

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

## SDK 配置

HTTP 接口表将版本保留在相对路径中；SDK 的拼接规则不同。例如 Ark SDK 的 Base URL 要包含 `/api/v3`，Google SDK 则通过 `api_version` 追加版本。以下配置直接供对应客户端使用，不要重复添加厂商或版本前缀。

| SDK / 客户端 | Base URL | 密钥 |
| --- | --- | --- |
| 火山方舟 Ark SDK（文本、Seedream、Seedance） | `https://platform.sgt.site/volcengine/api/v3` | 平台虚拟密钥，替换 `ARK_API_KEY`；[文本接入示例](native-ark-text.md) |
| Google Gen AI SDK（图片） | `https://platform.sgt.site/gemini`，`api_version="v1beta"` | 平台虚拟密钥；SDK 使用 `x-goog-api-key` |
| MiniMax HTTP 客户端 | `https://platform.sgt.site/minimax` | `Authorization: Bearer <平台虚拟密钥>` |
| 可灵 HTTP 客户端 | `https://platform.sgt.site/kling` | `Authorization: Bearer <平台虚拟密钥>` |

现有接入验证使用 `volcengine-python-sdk 5.0.52` 完成方舟文本生成，使用 `google-genai 2.30.0` 完成 Gemini 图片生成。建议分别设置 `max_retries=0` 和 `HttpRetryOptions(attempts=1)`，避免自动重复提交生成请求。当前可用模型和入口以模型目录及接口响应为准。

<a id="official-section-3"></a>

## 调用约定

- 任务 ID 是平台任务 ID，只能用平台的查询、删除接口读取，不能拿到官方控制台或官方接口查询。
- 生成结果链接由模型服务返回，有效期与官方一致：方舟（Seedream、Seedance）24 小时，可灵 30 天后清理；拿到后请及时下载或转存。
- 平台开放的字段以各模型页为准。例如 Seedance 的 `callback_url`、`draft`、`service_tier=flex`，以及可灵的 `external_task_id` 有各自限制，不能把某个厂商或型号的可选字段套到其他接口。Gemini 搜索的支持型号和计量要求见[Gemini 图片](native-gemini.md)。
- 输入素材（图片、视频、音频）的格式、尺寸、大小、时长要求沿用官方规定，各模型章节的“官方输入限制”列出了具体数值；不满足时由模型服务返回错误，平台不会自动裁剪或转码。