模型列表

列出模型（List models）

from openai import OpenAI
client = OpenAI(base_url="https://api.modelsite.ai/v1", api_key="sk-ms-xxxxxxxx")
for m in client.models.list().data:
print(m.id)

GET /v1/models 返回 {"object":"list","data":[...]}。每个模型对象含 id、object（固定 model）、created、owned_by（固定 modelsite），以及三个用来区分模型类型的字段：category（数组：chat、image_generation 或 video_generation）、input_modalities（数组：text、image）、capabilities（数组，取值与公开目录的能力标签相同，见下文）。GET /v1/models/{id} 返回同样的结构。created 是固定值（2024-01-01 UTC），不是模型的发布时间，不要用它排序或判断新旧；owned_by 也不代表模型的原厂商。

列表只包含已启用、已发布且公开的模型（含对话、图像、视频等各类）。未公开的模型不会出现在列表中，但其中可调用的仍能按名称调用，见下一节。列表不分页，也不支持筛选参数。列表不按你的 Key 过滤：如果组织或团队设置了模型白名单，列表里的模型你仍可能无权调用，调用时返回 403 model_access_error。

下面的接口卡片由 OpenAPI 规范自动渲染（模型对象的 Response schema）。

curl -X GET "https://example.com/models"

{  "object": "string",  "data": [    {      "id": "string",      "object": "string",      "created": 0,      "owned_by": "string",      "category": [        "chat"      ],      "input_modalities": [        "text"      ],      "capabilities": [        "string"      ]    }  ]}

获取模型（Retrieve model）

curl https://api.modelsite.ai/v1/models/glm-5.3-flash \
  -H "Authorization: Bearer $MODELSITE_API_KEY"

返回与列表中单个条目相同的对象（id、object、created、owned_by、category、input_modalities、capabilities），不含上下文窗口或定价信息（这些请看公开模型目录）。判定依据是「能否被调用」，不是「是否出现在列表里」：模型已启用且已发布时返回 200；模型不存在、已停用或未发布时返回 404，错误体为 {"error":{"message":"The model '...' does not exist","type":"invalid_request_error","code":"model_not_found"}}。因此，少数已启用、已发布但不在公开列表中（visible 为否）的模型，仍可按名称调用，对它们获取单个模型同样返回 200。

模型 ID 与命名

ModelSite 尽量保留各厂商的原生模型 ID，便于从直连迁移——不需要额外学一套"ModelSite 命名"。模型的 id 就是你在 /v1/chat/completions 或 /v1/messages 里传的 model 值（图像、视频模型用各自端点，见对应页面）。

• 模型 ID 请按列表或公开目录里给出的写法原样填写。
• 一个 ID 对应一个确定的模型，不会因为你换了端点而指向别的模型。

能力、上下文与价格去哪看

GET /v1/models 会返回每个模型的 category、input_modalities 和 capabilities，但不返回上下文窗口和定价字段。这些信息在无需鉴权的公开模型目录里。能力标签（capabilities 字段与目录中）的取值来自：chat（对话）、streaming（流式）、vision（视觉）、tools（工具调用）、thinking（推理）、embedding（向量）、image_gen（图像生成）、video_gen（视频生成）、tts、stt、cache（缓存）。标签由平台人工维护。