主体（新版本）

{
  "header": [
    {
      "required": false,
      "description": "",
      "type": "string",
      "id": "9sSJDAeZbC",
      "enable": true,
      "name": "Content-Type",
      "sampleValue": "application/json"
    },
    {
      "required": false,
      "description": "",
      "type": "string",
      "id": "TDPS7PI4EF",
      "enable": true,
      "name": "Authorization",
      "sampleValue": "Bearer {{YOUR_API_KEY}}"
    }
  ]
}

{
  "type": "application/json",
  "parameters": [],
  "jsonSchema": {
    "type": "object",
    "properties": {
      "element_name": {
        "type": "string",
        "description": "不能超过20个字符",
        "title": "主体名称"
      },
      "element_description": {
        "type": "string",
        "title": "主体描述",
        "description": "不能超过100个字符"
      },
      "reference_type": {
        "type": "string",
        "title": "主体参考方式",
        "description": "枚举值：video_refer、  image_refer\nvideo_refer: 视频角色主体，此时将参考element_video_list定义主体外表\nimage_refer: 多图主体，此时将参考element_image_list定义主体外表\n通过视频定制的主体和通过图片定制的主体的可用范围不同，详见能力地图和参数说明。"
      },
      "element_image_list": {
        "type": "object",
        "properties": {
          "frontal_image": {
            "type": "string"
          },
          "refer_images": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "image_url": {
                  "type": "string"
                }
              },
              "required": [
                "image_url"
              ],
              "x-apifox-orders": [
                "image_url"
              ]
            }
          }
        },
        "x-apifox-orders": [
          "frontal_image",
          "refer_images"
        ],
        "title": "主体参考图",
        "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 时，当前参数必填"
      },
      "element_video_list": {
        "type": "object",
        "properties": {
          "refer_videos": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "video_url": {
                  "type": "string"
                }
              },
              "x-apifox-orders": [
                "video_url"
              ]
            }
          }
        },
        "x-apifox-orders": [
          "refer_videos"
        ],
        "title": "主体参考视频",
        "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 及之后的模型"
      },
      "element_voice_id": {
        "type": "string",
        "title": "主体音色",
        "description": "可绑定音色库中已有音色\n\n当前参数为空时，当前主体不绑定音色\n\n可通过音色相关API获取ID，点此查看\n\n仅视频定制的主体支持绑定音色"
      },
      "tag_list": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "tag_id": {
              "type": "string"
            }
          },
          "x-apifox-orders": [
            "tag_id"
          ]
        },
        "title": "主体配置标签",
        "description": "一个主体可以配置多个标签\n\n用key:value承载。tag的ID与名称：o_101 热梗, o_102 人物, o_103 动物, o_104 道具, o_105 服饰, o_106 场景, o_107 特效, o_108 其他"
      },
      "callback_url": {
        "type": "string",
        "description": "本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知"
      },
      "external_task_id": {
        "type": "string",
        "description": "自定义任务ID。用户自定义任务ID，传入不会覆盖系统生成的任务ID，但支持通过该ID进行任务查询。请注意，单用户下需要保证唯一性"
      }
    },
    "required": [
      "element_name",
      "element_description",
      "reference_type"
    ],
    "x-apifox-orders": [
      "element_name",
      "element_description",
      "reference_type",
      "element_image_list",
      "element_video_list",
      "element_voice_id",
      "tag_list",
      "callback_url",
      "external_task_id"
    ]
  },
  "required": true,
  "mediaType": "",
  "examples": [
    {
      "mediaType": "application/json",
      "value": "{\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}"
    }
  ],
  "oasExtensions": ""
}

[
  {
    "id": 153160057,
    "name": "成功",
    "code": 200,
    "contentType": "json",
    "jsonSchema": {
      "type": "object",
      "properties": {}
    },
    "itemSchema": {},
    "description": "",
    "mediaType": "",
    "headers": []
  }
]