curl https://api.pipellm.ai/v1/models \
-H "Authorization: Bearer $PIPELLM_API_KEY"
import os
import requests
response = requests.get(
"https://api.pipellm.ai/v1/models",
headers={"Authorization": f"Bearer {os.getenv('PIPELLM_API_KEY')}"},
)
payload = response.json()
for model in payload["data"]:
print(model["id"], model["type_target"])
const response = await fetch("https://api.pipellm.ai/v1/models", {
headers: { Authorization: `Bearer ${process.env.PIPELLM_API_KEY}` },
});
const payload = await response.json();
for (const model of payload.data) {
console.log(model.id, model.type_target);
}
列出模型
获取 PipeLLM 统一模型目录，不包含定价。
GET
/
v1
/
models
curl https://api.pipellm.ai/v1/models \
-H "Authorization: Bearer $PIPELLM_API_KEY"
import os
import requests
response = requests.get(
"https://api.pipellm.ai/v1/models",
headers={"Authorization": f"Bearer {os.getenv('PIPELLM_API_KEY')}"},
)
payload = response.json()
for model in payload["data"]:
print(model["id"], model["type_target"])
const response = await fetch("https://api.pipellm.ai/v1/models", {
headers: { Authorization: `Bearer ${process.env.PIPELLM_API_KEY}` },
});
const payload = await response.json();
for (const model of payload.data) {
console.log(model.id, model.type_target);
}
用这条路由获取当前账号可见的模型 ID。
/v1/models 现在是纯目录接口，
只返回模型身份和协议元数据，不再返回价格。
如果你需要价格，请改用 /v1/models/pricing。
端点
GET https://api.pipellm.ai/v1/models
认证
使用标准的 PipeLLM API Key 请求头：| Header | 示例 |
|---|---|
Authorization | Bearer $PIPELLM_API_KEY |
x-api-key | $PIPELLM_API_KEY |
说明
- 这条路由只支持
GET - 返回的是 PipeLLM 统一目录 schema
hidden和unlisted的模型会在返回前被过滤掉- 结果会按模型 ID 排序
- 价格字段被刻意移出目录接口，避免同一个模型映射到多个平台时误导调用方以为存在单一权威价格
curl https://api.pipellm.ai/v1/models \
-H "Authorization: Bearer $PIPELLM_API_KEY"
import os
import requests
response = requests.get(
"https://api.pipellm.ai/v1/models",
headers={"Authorization": f"Bearer {os.getenv('PIPELLM_API_KEY')}"},
)
payload = response.json()
for model in payload["data"]:
print(model["id"], model["type_target"])
const response = await fetch("https://api.pipellm.ai/v1/models", {
headers: { Authorization: `Bearer ${process.env.PIPELLM_API_KEY}` },
});
const payload = await response.json();
for (const model of payload.data) {
console.log(model.id, model.type_target);
}
响应格式
{
"object": "list",
"data": [
{
"id": "gpt-5",
"display_name": "Gpt 5",
"type_target": "openai",
"created_at": "2025-05-14T00:00:00Z"
},
{
"id": "claude-sonnet-4-6",
"display_name": "Claude Sonnet 4.6",
"type_target": "anthropic",
"created_at": "2025-03-01T00:00:00Z"
}
],
"total": 2
}
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
object | string | 固定值 "list" |
data | array | 模型目录对象数组 |
data[].id | string | API 请求里使用的模型 ID |
data[].display_name | string | 基于模型 ID 自动生成的人类可读名称 |
data[].type_target | string | 这条模型对外暴露的协议族，例如 openai、anthropic、gemini |
data[].created_at | string | 从模型元数据选出的 RFC3339 时间戳 |
total | integer | 返回的模型总数 |
这条路由适合做什么
用/v1/models 可以：
- 给你的 UI 生成模型选择器
- 判断某个模型当前账号是否可见
- 确认模型对外暴露在哪个协议族下
/v1/models/pricing。
相关文档
模型定价
按模型、provider 或平台映射查询权威价格
路由与协议
了解模型协议族如何影响请求格式
开发工具
在 Claude Code、OpenCode、OpenClaw 和 LangChain 中使用这些模型 ID
此页面对您有帮助吗？