You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

复制全文
下载 pdf
管理定制模型
获取定制模型列表
复制全文
下载 pdf
获取定制模型列表
POST https://ark.cn-beijing.volcengineapi.com/?Action=ListCustomModels&Version=2024-01-01​
查询当前账号下的定制模型列表,支持按模型 ID、名称、标签和项目等条件筛选,并可分页与排序返回结果。​
注意​
本接口仅返回当前账号下可见的定制模型,跨项目查询需指定正确的 ProjectName。​
鉴权​
本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。​
  • Access Key 鉴权,请在 Access Key 管理 页面,获取 Access Key。本接口仅支持 Access Key 鉴权。​
​​
请求参数​
Body 参数​
Filter object | 定制模型筛选条件​
​
PageNumber integer 默认值 1 | 起始页码​
​
PageSize integer 默认值 10 | 每页记录数​
​
ProjectName string 默认值 default | 项目名称​
​
SortBy string 默认值 CreateTime | 排序指标​
​
SortOrder string 默认值 Desc | 排序顺序​
​
TagFilters object[] | 标签筛选条件​
​
​
响应参数​
Items object[] | 定制模型列表​
​
PageNumber integer | 起始页码​
​
PageSize integer | 每页记录数​
​
TotalCount integer | 定制模型总数​
​
​

Request

curl 'https://ark.cn-beijing.volcengineapi.com/?Action=ListCustomModels&Version=2024-01-01' \
  -H 'Content-Type: application/json' \
  -H 'X-Date: <X-Date>' \
  -H 'X-Content-Sha256: <X-Content-Sha256>' \
  -H 'Authorization: HMAC-SHA256 Credential=<AK>/<X-Date>/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=<Signature>' \
  -d '{
  "PageNumber": 1,
  "PageSize": 1,
  "Filter": {
    "Ids": [
      "vrYVig"
    ],
    "Name": "aThQ2SZH"
  },
  "TagFilters": [
    {
      "Key": "8mYbP7pN",
      "Values": [
        "8bS"
      ]
    }
  ],
  "ProjectName": "default",
  "SortBy": "CreateTime",
  "SortOrder": "Desc"
}
'

Response

{
  "ResponseMetadata": {
    "RequestId": "20240514210517123075045154E335F9",
    "Action": "ListCustomModels",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 10,
    "Items": [
      {
        "Id": "cm-20240514210342-9k4hn",
        "Name": "自定义模型-电商图像生成",
        "Description": "基于 doubao-seed-2-0-pro 的 LoRA 精调模型 · 用于电商场景图像生成",
        "SourceType": "Customization",
        "ModelCustomizationJobId": "mcj-20240401114541-5gzd8",
        "CustomizationType": "FinetuneLoRA",
        "Status": "Ready",
        "HyperParameters": [
          {
            "Name": "learning_rate",
            "Value": "0.0001"
          }
        ],
        "FoundationModel": {
          "Name": "doubao-seed-2-0-pro",
          "ModelVersion": "260215"
        },
        "Tags": [
          {
            "Key": "env",
            "Value": "stg"
          }
        ],
        "ProjectName": "default",
        "CreateTime": "2024-04-01T11:54:41Z",
        "UpdateTime": "2024-05-14T20:59:45Z"
      }
    ]
  }
}
最近更新时间:2026.09.04 20:24:12
这个页面对您有帮助吗?
有用
有用
无用
无用