主体（新版本）

{
  "contentType": "application/json",
  "properties": {
    "callback_url": {
      "description": "本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "Task result callback URL; if set, server notifies on status changes"
        }
      }
    },
    "element_description": {
      "description": "不能超过100个字符",
      "title": "主体描述",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "max 100 characters"
        }
      }
    },
    "element_image_list": {
      "description": "可通过多张图片设定主体及其细节\n\n包括正面参考图和其他角度或特写参考图，其中：至少包括1张正面参考图，由frontal_image参数定义；需包括1～3张其他参考图，需与正面参考图有差异，由image_url参数定义\n\n用key:value承载，如下：\n\n\"element_image_list\": {\n\"frontal_image\": \"image_url_0\", \n\"refer_images\": [{ \"image_url\": \"image_url_1\" }, ...] \n}\n支持传入图片Base64编码或图片URL（确保可访问）\n\n图片格式支持.jpg / .jpeg / .png。图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比要在1:2.5 ~ 2.5:1之间\n\nreference_type参数值为 image_refer 时，当前参数必填",
      "properties": {
        "frontal_image": {
          "type": "string"
        },
        "refer_images": {
          "items": {
            "properties": {
              "image_url": {
                "type": "string"
              }
            },
            "required": [
              "image_url"
            ],
            "type": "object"
          },
          "type": "array"
        }
      },
      "title": "主体参考图",
      "type": "object",
      "x-i18n": {
        "en-US": {
          "description": "Define subject via multiple images: at least one frontal_image plus 1–3 differing refer_images (image_url). As key:value element_image_list. Base64 or URL; .jpg/.jpeg/.png; max 10MB; min 300px; aspect 1:2.5–2.5:1. Required when reference_type=image_refer"
        }
      }
    },
    "element_name": {
      "description": "不能超过20个字符",
      "title": "主体名称",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "max 20 characters"
        }
      }
    },
    "element_video_list": {
      "description": "可通过视频设定主体及其细节\n\n可上传有声视频，有声视频包含人声则触发音色定制（定制+入音色库+与主体绑定）\n\n暂时仅支持通过视频定制写实风格的人形形象\n\n参考视频时当前参数必填，参考图片时当前参数无效\n\n用key:value承载。视频格式仅支持MP4/MOV。仅支持时长介于3s～8s之间、宽高比例需为16:9或9:16的1080P视频。至多仅支持上传1段视频，视频大小不超过200MB。video_url参数值不得为空\n\n\"element_video_list\": {\n\"refer_videos\": [{ \"video_url\": \"video_url_1\" }, ...] \n}\n视频定制的主体仅支持用于 kling-video-o3 及之后的模型",
      "properties": {
        "refer_videos": {
          "items": {
            "properties": {
              "video_url": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "type": "array"
        }
      },
      "title": "主体参考视频",
      "type": "object",
      "x-i18n": {
        "en-US": {
          "description": "Define subject via video. Video with speech triggers voice customization. Realistic humans only for now. Required for video reference; ignored for image reference. MP4/MOV; 3–8s; 16:9 or 9:16 1080P; one clip ≤200MB; video_url required. Video-customized subjects only on kling-video-o3+"
        }
      }
    },
    "element_voice_id": {
      "description": "可绑定音色库中已有音色\n\n当前参数为空时，当前主体不绑定音色\n\n可通过音色相关API获取ID，点此查看\n\n仅视频定制的主体支持绑定音色",
      "title": "主体音色",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "can bind an existing voice from the library when this parameter is empty, this subject is not bound to a voice get IDs via voice APIs only video-customized subjects support voice binding"
        }
      }
    },
    "external_task_id": {
      "description": "自定义任务ID。用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询。请注意，单用户下需要保证唯一性",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "Custom task ID. Does not override the system task ID, but can be used for queries. Must be unique per user"
        }
      }
    },
    "reference_type": {
      "description": "枚举值：video_refer、  image_refer\nvideo_refer: 视频角色主体，此时将参考element_video_list定义主体外表\nimage_refer: 多图主体，此时将参考element_image_list定义主体外表\n通过视频定制的主体和通过图片定制的主体的可用范围不同，详见能力地图和参数说明。",
      "title": "主体参考方式",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "enum: video_refer、 image_refer\nvideo_refer: video subject; appearance from element_video_list\nimage_refer: multi-image subject; appearance from element_image_list\nVideo- vs image-customized subjects differ in availability; see capability map / params."
        }
      }
    },
    "tag_list": {
      "description": "一个主体可以配置多个标签\n\n用key:value承载。tag的ID与名称：o_101 热梗, o_102 人物, o_103 动物, o_104 道具, o_105 服饰, o_106 场景, o_107 特效, o_108 其他",
      "items": {
        "properties": {
          "tag_id": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "title": "主体配置标签",
      "type": "array",
      "x-i18n": {
        "en-US": {
          "description": "A subject can have multiple tags as key:value. Tag IDs/names: o_101 meme, o_102 person, o_103 animal, o_104 prop, o_105 clothing, o_106 scene, o_107 VFX, o_108 other"
        }
      }
    }
  },
  "required": [
    "element_name",
    "element_description",
    "reference_type"
  ]
}

"{\r\n    \"element_name\": \"主体ysh11112311213\",\r\n    \"element_description\": \"测试\",\r\n    \"reference_type\": \"image_refer\",\r\n    \"element_image_list\": {\r\n        \"frontal_image\": \"https://imageproxy.zhongzhuan.chat/api/proxy/image/bb9bd34363da4fa486c9e645a6b1349e.png\",\r\n        \"refer_images\": [\r\n            {\r\n                \"image_url\": \"https://imageproxy.zhongzhuan.chat/api/proxy/image/bb9bd34363da4fa486c9e645a6b1349e.png\"\r\n            }\r\n        ]\r\n    },\r\n    // \"element_video_list\": {\r\n    //     \"refer_videos\": [\r\n    //         {\r\n    //             \"video_url\": \"xxx\"\r\n    //         }\r\n    //     ]\r\n    // },\r\n    // \"element_voice_id\": string,\r\n    // \"tag_list\": [\r\n    //     {\r\n    //         \"tag_id\": \"xxx\"\r\n    //     }\r\n    // ],\r\n    // \"callback_url\": \"xxx\",\r\n    // \"external_task_id\": \"\"\r\n}"