获取用户模型列表
更新时间:2024-11-04
注意: 为提升开发者使用体验,本文内容已合并至至对应API文档,请查看API鉴权及调用-模型管理-模型管理V1-获取用户模型列表;本文档已于2024年6月28日在平台文档中心下线,内容不再更新。
功能介绍
用于查看用户训练产生和bos导入的模型列表。
注意事项
调用本文API,需使用安全认证AK/SK鉴权,调用流程及鉴权介绍详见SDK安装及使用流程。
调用示例
import os
from qianfan.resources import Model
# 使用安全认证AK/SK鉴权,通过环境变量方式初始化;替换下列示例中参数,安全认证Access Key替换your_iam_ak,Secret Key替换your_iam_sk
os.environ["QIANFAN_ACCESS_KEY"] = "your_iam_ak"
os.environ["QIANFAN_SECRET_KEY"] = "your_iam_sk"
# 获取model_type为1或4的用户模型
user_list = Model.user_list(model_type=[1, 4])
print(user_list)
#print(user_list['body'])
返回示例
QfResponse(
code = 200,
headers = {...},
body = {
'log_id': '3109887584',
'result': {
'total': 4,
'items': [{
'modelName': 'testxyWST',
'modelId': 12648,
'modelIdStr': 'am-gmptxxxfci',
'modelType': 1,
'tags': None,
'createTime': '2024-01-26T11:31:38+08:00',
'versionCount': 1,
'trainType': 'WENXIN-YIGE',
'latestVersionInfo': {
'state': 'Ready',
'version': '1',
'sourceType': 'Train',
'sourceExtra': {
'trainSourceExtra': {
'taskId': 18252,
'taskName': 'testxy011105',
'iterationVersion': 1,
'runId': 100,
'devType': 1,
'modelType': 7xx,
'templateType': 70xx
},
'sourceType': 'Train'
},
'versionId': 15xx,
'versionIdStr': 'amv-prjg6zqe1bhb'
}
}, {
'modelName': 'pokemon_lora_model',
'modelId': 12xx,
'modelIdStr': 'am-xwn7yfaw919h',
'modelType': 1,
'tags': None,
'createTime': '2024-01-17T11:31:26+08:00',
'versionCount': 1,
'trainType': 'stablediffusion_VXL',
'latestVersionInfo': {
'state': 'Ready',
'version': '1',
'sourceType': 'Train',
'sourceExtra': {
'trainSourceExtra': {
'taskId': 18xx,
'taskName': 'pokemon_lora',
'iterationVersion': 1,
'runId': 10xx,
'devType': 1,
'modelType': 70xx,
'templateType': 70xx
},
'sourceType': 'Train'
},
'versionId': 15xx,
'versionIdStr': 'amv-xy8bxxxxw7'
}
}, {
'modelName': 'testxy0111yige',
'modelId': 11xx,
'modelIdStr': 'am-knbxxx5f',
'modelType': 1,
'tags': None,
'createTime': '2024-01-12T10:38:32+08:00',
'versionCount': 1,
'trainType': 'WENXIN-YIGE',
'latestVersionInfo': {
'state': 'Ready',
'version': '1',
'sourceType': 'Train',
'sourceExtra': {
'trainSourceExtra': {
'taskId': 18xx,
'taskName': 'testxy011105',
'iterationVersion': 1,
'runId': 10xx,
'devType': 1,
'modelType': 705,
'templateType': 70xx
},
'sourceType': 'Train'
},
'versionId': 14xx,
'versionIdStr': 'amv-xd05xxxb3zb'
}
}, {
'modelName': 'yige_test',
'modelId': 11xx,
'modelIdStr': 'am-58d6xxxmw3',
'modelType': 1,
'tags': None,
'createTime': '2024-01-12T10:38:07+08:00',
'versionCount': 1,
'trainType': 'WENXIN-YIGE',
'latestVersionInfo': {
'state': 'Ready',
'version': '1',
'sourceType': 'Train',
'sourceExtra': {
'trainSourceExtra': {
'taskId': 18xx,
'taskName': 'testxy011105',
'iterationVersion': 1,
'runId': 10xx,
'devType': 1,
'modelType': 705,
'templateType': 70xx
},
'sourceType': 'Train'
},
'versionId': 14xx,
'versionIdStr': 'amv-m2uxxx8ahd'
}
}]
}
})
参数说明
请求参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
name_filter | string | 否 | 名称过滤器 |
model_type | int[] | 否 | 模型类型,可选值如下: · 0:大语言模型 · 1:文生图大模型 · 2:产业级搜索模型 · 3:文本表示模型 · 4:向量表示模型 · 5:图像理解模型 |
order_by | string | 否 | 排序字段,目前仅支持create_time |
order | string | 否 | 次序,可选值如下: · asc:升序,从小到大 · desc:降序,从大到小 |
page_no | int | 是 | 页码,最小值为1 |
page_size | int | 是 | 每页大小,必须大于0 |
返回参数
名称 | 类型 | 描述 |
---|---|---|
log_id | int | 请求ID |
result | dict | 请求结果 |
result说明
名称 | 类型 | 描述 |
---|---|---|
modelId | int | 模型数字ID |
modelIdStr | string | 模型字符串ID |
modelName | string | 模型名称 |
modelType | integer | 模型类型 |
tags | string[] | 业务标签 |
createUsername | string | 创建人 |
createUser | integer | 创建人id |
createTime | string | 创建时间 |
versionCount | int | 修改时间 |
trainType | string | 基础模型,说明: (1)该字段值说明: · 当基础模型是ernieBotLite各版本模型,该字段返回ernieBotLite;例如基础模型是ernieBotLite-v201-8k,返回trainType值为ernieBotLite · 当基础模型是chatglm2-6b、chatglm2-6b-32k,该字段返回chatglm2-6b其他,该字段值是对应基础模型 (2)在将训练任务发布为模型场景,使用该字段时,需注意以下,更多详情请参考训练任务发布为模型: · 该字段值需和模型调优-获取任务运行详情接口返回的trainType字段配合使用 |
latestVersionInfo | dict[] | 模型版本列表 |
latestVersionInfo说明
名称 | 类型 | 描述 |
---|---|---|
versionId | int | 版本ID,int类型 |
versionIdStr | string | 版本ID,string类型 |
state | string | 状态,说明: · Ready:已就绪 · Creating:创建中 · Fail:创建失败 |
version | string | 版本号 |
sourceType | string | 模型版本来源类型,说明: · Train:大模型训练产生 · Acceleration:模型加速产生 · PlatformPreset:平台预置模型版本 · Import:外部导入模型 |
sourceExtra | string | 模型版本来源详细信息 |