训练任务发布为模型
POST
https://qianfan.baidubce.com/wenxinworkshop/modelrepo/publishTrainModel功能介绍
本接口用于将训练任务的产出发布为模型管理中具体某个模型的版本,支持发布为新建模型的新版本或已有模型新版本。
注意事项
- 调用本文API,使用“安全认证/Access Key ”中的Access Key ID 和 Secret Access Key等进行鉴权,无法使用获取Access Token的方式鉴权,具体鉴权认证机制参考鉴权认证机制。
错误码
若请求错误,服务器将返回的JSON文本包含以下参数:
名称 | 描述 |
---|---|
error_code | 错误码 |
error_msg | 错误描述信息,帮助理解和解决发生的错误 |
例如参数错误返回:
{
"error_code": 500001,
"error_msg": "param invalid"
}
错误码 | 错误信息 | 描述 |
---|---|---|
1000 | 非常抱歉,系统出现错误,请稍后重试 | 系统错误 |
10001 | 模型不存在 | 选择的已存在模型不存在 |
21002 | 模型版本状态异常 | 发布的训练任务状态异常 |
70002 | 查询错误[获取模型完整信息失败] | 选择的已存在模型信息获取失败 |
70101 | AI模型名称已存在 | 模型名称全局应唯一 |
70114 | 训练模型信息获取失败 | 发布的训练任务信息获取失败 |
70115 | 训练模型文件信息获取失败 | 发布的训练模型存储异常 |
70118 | 当前模型已存在该运行发布的版本 | 同一个运行任务只允许在同个模型底下发布一次 |
70128 | 导入模型禁止发布非导入模型版本 | 不允许将训练任务发布成导入模型的新版本 |
70130 | 模型类型匹配失败 | 模型任务类型不支持 |
70131 | AI模型名称不能为空 | 创建新模型时模型名称不能为空 |
500000 | internal server error | 服务器内部错误 |
500001 | param invalid | 参数错误 |
500002 | auth failed, no access | 无权访问 |
请求参数
Header 参数
Content-Type
string
必需
固定值:application/json
x-bce-date
string
必需
当前时间,遵循ISO8601规范,格式如2016-04-06T08:23:49Z
Authorization
string
必需
用于验证请求合法性的认证信息,更多内容请参考鉴权认证机制,签名工具可参考IAM签名工具
Body 参数application/json
isNewModel
boolean
必需
是否创建新模型,默认false,可选值如下: true:是 false:否
modelName
string
必需
模型名称。说明: (1)如果字段isNewModel为true,即发布为新建模型的版本时,该字段必填 (2)模型名称需符合以下:中文或大小写字母数字组成,以中文或大小写字母数字作为字符串开头,字符串长度最大为20个字符
modelId
integer
可选
已存在模型的ID。说明: (1)如果字段isNewModel为false,即发布为已有模型新版本时,该字段必填 (2)该字段值通过千帆控制台-模型管理-模型列表页获取
tags
array[string]
可选
模型业务标签列表,说明: (1)如果isNewModel为false,即发布为已有模型新版本,使用该字段会更新模型业务标签列表;如果isNewModel为true,即发布为新建模型的版本,使用该字段会新建模型业务标签 (2)业务标签数量限制最大不超过5个 (3)业务标签格式需符合以下:中文或大小写字母数字组成,每个标签不超过10个字符
versionMeta
object
必需
待发布的新模型版本元数据信息
description
string
必需
模型版本描述,字符串长度最大为300个字符
iterationId
integer
必需
训练任务运行ID,该字段可以通过控制台-SFT-点击某任务详情-训练运行列表页获取,详情可参考查看与管理SFT运行
taskId
integer
必需
训练任务ID,该字段可以通过控制台-SFT页面获取
示例
{
"isNewModel": true,
"modelName": "test_全站api",
"tags": [
"11",
"22",
"33",
"44",
"55"
],
"versionMeta": {
"description": "api测试",
"iterationId": 973,
"taskId": 294
}
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
log_id
integer
请求ID
result
object
请求结果
modelId
integer
模型ID
versionId
integer
模型版本ID
version
string
模型版本号
示例
{
"log_id": 1212121,
"result": {
"modelId": 1,
"versionId": 2,
"version": "1"
}
}
最后修改时间: 1 年前