GPU 池
模型中心 API（GPU 池）
模型中心请用 Base https://api.suanliyunxiang.com/v1；要调托管商城模型请改用 /platform/v1
最后更新：2026 年 9 月 10 日
1. 先选对路径（不要混用）
- 租 GPU / 管实例：走 REST https://api.suanliyunxiang.com/api/v1（创建、停止、钱包）。这不是 OpenAI 兼容推理，不能拿来当 Chat Completions Base。文档见 /docs/api。
- 调托管模型（API 商城 / 平台 API）：OpenAI 兼容 Base 只能是 https://api.suanliyunxiang.com/platform/v1 。文档见 /docs/platform-api。
- 调 GPU 池公开模型（模型中心）：OpenAI 兼容 Base 是 https://api.suanliyunxiang.com/v1 ，随出租主机在线变化。文档见 /docs/model-hub。
- 禁止把 /v1 当成平台 API，也禁止把 /platform/v1 当成租 GPU。SDK 的 base_url 必须与控制台当前产品页展示的 Base 完全一致。
- 新建密钥必须选定「平台 API」或「模型中心」。绑定后只能打对应 Base；旧密钥未绑目录时两套都能打。
- 调用 /platform/v1 与 /v1 推理接口时，请在请求头携带 X-Request-Id（也可用 X-Idempotency-Key）。同一笔调用超时重试必须用同一个号。未带头时网关仅对约 3 分钟内完全相同的请求体做短窗去重。详见 /docs/platform-api#request-id。
- 旧路径 /api/platform-services/{slug}/v1/... 与控制台同源 /api/api-products/{slug}/v1/... 只给网页试玩用，脚本与 SDK 不要当作对外 Base。
2. 认证与 Base URL
- 在控制台「开发者」创建密钥时必须选定「模型中心」。请求头 Authorization: Bearer <api_key>。新建默认含 services:invoke，只能打本页 /v1，不能打 /platform/v1；不含实例管理。
- 模型中心 Base URL 固定为 https://api.suanliyunxiang.com/v1（注意：没有 /platform 前缀）。
- 选模型、复制 curl / Python / Node 示例请到控制台「模型中心」（/dashboard/models-hub），不要复制「平台 API」页的 Base。
- 试玩台（对话 / 语音 / 图像）若带 catalog=model，调用的是 GPU 池，不是 API 商城上游。
- 推理请求请携带 X-Request-Id，超时重试用同一号；未带头时网关仅短窗对相同请求体去重。规则与平台 API 相同。详见 /docs/platform-api#request-id。
3. 对话 POST /v1/chat/completions
- POST https://api.suanliyunxiang.com/v1/chat/completions
- model 以模型中心当前 SKU 为准（例如公开·Qwen 对话池的 qwen2.5-7b）。主机从 /host/pools 加入对应池后，该 SKU 才会显示可用。
- 请求体兼容 OpenAI Chat Completions：model、messages、stream 等。
- 这是共享 GPU 池，不是租一台独占实例。要独占 GPU 请走市场下单（REST /api/v1/instances）。
4. 语音合成 POST /v1/audio/speech
- POST https://api.suanliyunxiang.com/v1/audio/speech
- 模型以模型中心为准（如 voxcpm2）。请求体：input、voice / voice_description、response_format。
- 控制台试听：/dashboard/tts（默认 GPU 池）。计费按该 SKU 公示价格。
- 不要把本路径写成 /platform/v1/audio/speech，除非 API 商城已上架同名托管 SKU。
5. 语音识别 POST /v1/audio/transcriptions
- POST https://api.suanliyunxiang.com/v1/audio/transcriptions
- multipart/form-data，字段 file 必填（最大 25MB）；model 以模型中心为准（如 sensevoice-small）。
- 控制台试听：/dashboard/asr。旧 SKU whisper-large-v3 已停用。
6. 图片生成 POST /v1/images/generations
- POST https://api.suanliyunxiang.com/v1/images/generations ；图生图 POST https://api.suanliyunxiang.com/v1/images/edits。
- model 以模型中心为准（如 kolors）。出图走 GPU 图像池；主机需加入对应池。
- 控制台预览：/dashboard/image?catalog=model。托管商城生图请改用 /platform/v1，见 /docs/platform-api#images-generations。