模型列表
OpenAI 兼容的 GET /v1/models。返回当前 API Key 可访问的全部模型。
GET
/v1/models此接口无请求体。返回结构与 OpenAI 原生 GET /v1/models 保持兼容， OpenAI SDK 的 client.models.list() 可以直接使用。
请求里的
model 使用 data[].id。平台会在转发前把公开模型 ID 映射为实际调用的模型名。模型的公开 ID 推荐使用 provider/模型名 形式， 例如 aliyun/qwen-max。当前模型列表按平台已加载的公开模型目录返回，不做模型能力矩阵判断。视觉、工具调用、 JSON 输出、上下文限制等细节以模型提供方的能力为准。
请求头
| Header | 必填 | 示例 | 说明 |
|---|---|---|---|
Authorization | 建议 | Bearer sk-swx-xxx | 生产接入建议携带 Swarmix API Key；当前模型目录接口主要用于 SDK 兼容和模型发现。 |
字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
data[].id | string | 客户侧公开模型 ID。在 chat.completions 或 messages 的 model 字段里使用这个值。 |
data[].object | string | 固定为 model。 |
data[].owned_by | string | 兼容 OpenAI 字段，当前固定为 swarmix。 |
data[].created | integer | 兼容 OpenAI 字段。部分模型提供方不提供真实创建时间，平台会使用固定兼容值。 |
data[] | object | 客户侧只返回模型发现所需字段；平台内部路由细节不会在此接口下发。 |
实时定价
/v1/models 只用于模型发现。如果需要价格、上下文窗口和免费额度等字段，使用 GET /v1/models/pricing。 当前公开 pricing 接口不把 group_name 作为稳定返回字段。
生产代码建议缓存模型列表 5-30 分钟。模型列表变化频率较低，高频调用容易浪费请求配额。