模型

通过模型目录或 API 查找模型

接入前可在 /pricing 比较模型能力和实时价格；在程序中使用 API Key 请求 GET /v1/models，可以获取该 Key 当前可调用的模型 ID。

调用权限以请求当时的 API 返回结果为准。模型可能出现在公开目录中，但受限的 API Key 或分组仍可能无权调用。

获取当前可用模型

GET /v1/models

cURL

curl 'https://hippoapi.net/v1/models' \
+  -H "Authorization: Bearer $HIPPOAPI_API_KEY"

Python

models = client.models.list()
for model in models.data:
    print(model.id)

JavaScript

const models = await client.models.list()
for (const model of models.data) {
  console.log(model.id)
}

使用准确的模型 ID

请原样复制 id，不要修改大小写、标点或版本后缀，并把它填入请求的 model 字段。展示名称、厂商名称或营销名称不一定是有效的模型 ID。

模型 ID 应放在应用配置中，不要散落在业务代码里。这样更容易审核模型变更，也便于出现问题时回滚。

const MODEL = process.env.HIPPOAPI_MODEL || 'glm-5.1'

不要假定所有模型支持相同参数

OpenAI 兼容指请求和响应协议兼容，不代表所有模型行为一致。上线前应针对具体模型测试流式响应、工具调用、结构化输出、图片输入、上下文长度和采样参数。

切换模型时，应使用有代表性的输入比较质量、延迟、错误率和实际费用。虽然代码上通常只需修改 model 字段，但它仍然属于应用行为变更。