如果您需要維護的模型數量不多，推薦直接在智作工坊控制臺模型管理中上傳維護模型。如果您已經在自有系統中維護過模型信息，可以參考本文檔，以接口形式大規模同步模型信息。

模型核心領域模型

模型同步鏈路

模型同步包括同步和異步兩個部分。

同步鏈路用于模型元信息同步，當客戶側模型元信息需要變更時，由客戶按照上述模型結構組裝完整模型、版本、文件元信息結構，將模型元信息同步到智作工坊。

智作工坊接收到模型元信息后：

• 如果模型文件已經上傳到智作工坊，直接返回模型同步結果。

• 如果模型文件未上傳到智作工坊，返回模型同步結果，并觸發異步鏈路。異步鏈路用于模型文件上傳上架，上架后會觸發模型上架結果事件。

模型同步

請求語法

POST /scc/spSdModelSync

請求參數

入參信息

{
  "modelId": "xxxxx", // 模型 ID (客戶系統的模型業務 ID)，用于唯一標識一個模型，同步場景必填
  "name": "Demo", // 模型名稱，必填
  "modelType": "checkpoint", // 模型類型: checkpoint/lora/textualinversion/vae，必填
  "modelDesc": "xxxx", // 模型描述，html 格式，可選
  "source": "https://xxxx", // 模型來源地址，可選
  "sourceType": "internal", // 模型來源類型: liblib/civitia/hugging_face/internal，其中 internal 為租戶自有模型，必填
  "isOriginal": false, // 是否為原創模型
  "originalCreator": "ccc", // 原創作者
  "originalCreatorHomepage": "https://xxxx", // 原創作者鏈接
  "versions": [
    {
      "modelVersionId": "xxxx", // 模型版本 ID (客戶系統的模型版本業務 ID)，用于唯一標識一個模型版本，同步場景必填
      "name": "v1.2.2-EOL", // 模型版本名稱，必填
      "baseModel": "v1.5", // 基礎模型類型: v1.4/v1.5/v2.0/v2.1/vxl_0.9/vxl_1.0/vxl_distilled/v1.5_lcm/vxl_1.0_lcm/vxl_turbo，必填
      "versionDesc": "xxxx", // 模型版本描述，html 格式，可選
      "triggerWords": ["rev", "animated", "v1.2.2", "eol"], // 觸發詞，用于觸發模型版本，可選
      "isAutoCollection": true, // 是否自動收藏，可選，開啟后新建 token 會自動收藏該模型版本
      "covers": [
        {
          "cover": "https://xxx.jpeg", // 模型版本封面圖，必填
          "coverFile": {
            // 封面圖文件信息，必填
            "width": 1920, // 封面圖寬度，必填
            "height": 1080, // 封面圖高度，必填
            "format": "jpeg" // 封面圖格式，可選
          }
        }
      ],

      "files": [
        {
          "name": "revAnimated_v122EOL.safetensors", // 模型文件名稱，必填
          "aliasName": "revAnimated_v122EOL", // 模型文件別名，用于 Lora 模型的別名，必填
          "downloadUrl": "https://xxx", // 模型文件下載地址，必填
          "hash": "xxx", // 模型文件 hash，必填
          "sizeKb": 5376404.0390625, // 模型文件大小，單位 KB，必填
          "isPrimary": true, // 是否主要模型文件，一個版本下只能有一個主要模型文件
        }
      ]
    }
  ]
}

返回參數

data參數