ZipFlow Docs接口参考
模型列表（Model）
通过 OpenAI 兼容的 GET /v1/models 接口列出您的 API 密钥可用的模型。
功能说明
以标准 OpenAI GET /v1/models 格式列出您的 API 密钥可访问的模型。返回的 id 可作为推理请求中的 model 参数值。
📮 端点
GET /v1/models- 需要在请求头中携带鉴权信息
- 返回当前请求所使用的 Token 可访问的模型列表
🔐 鉴权
在请求头中包含以下内容进行 API 密钥认证：
Authorization: Bearer $ZIPFLOW_API_KEY- 支持携带或不携带
sk-前缀，服务端会自动兼容 - 缺少或无效的 Authorization 头将返回 401
💡 请求示例
curl https://api.zipflow.xyz/v1/models \
-H "Authorization: Bearer $ZIPFLOW_API_KEY"✅ 成功响应示例
{
"object": "list",
"data": [
{
"id": "gpt-4.1",
"object": "model",
"created": 1686935002,
"owned_by": "openai"
},
{
"id": "claude-sonnet-4",
"object": "model",
"created": 1686935002,
"owned_by": "anthropic"
}
]
}❗ 错误响应示例
- 缺少鉴权头：
{
"error": {
"message": "You did not provide an API key. Provide your API key in an Authorization header using Bearer auth.",
"type": "invalid_request_error",
"param": null,
"code": null
}
}- API 密钥无效：
{
"error": {
"message": "Incorrect API key provided.",
"type": "invalid_request_error",
"param": null,
"code": "invalid_api_key"
}
}🧾 字段说明
object: 固定为listdata: 可用模型条目数组id: 模型标识符 - 推理请求中将其作为model传入object: 固定为modelcreated: 创建时间的 Unix 时间戳（秒）owned_by: 模型所属的供应商或组织