众扬汇 AI 开放平台 API 文档

主体(查询自定义主体)

OpenAPI Specification

分页查询账号下的自定义主体列表,返回主体标识、名称与素材信息。

请求方式:GET

接口地址

text
https://api.allyang.cn/kling/v1/general/custom-elements

请求头

  • Authorization(可选):鉴权头,使用控制台创建的令牌,格式为 Bearer + 令牌。(示例:Bearer {{YOUR_API_KEY}})

查询参数

  • pageNum(string,可选)
  • pageSize(string,可选)

返回字段

  • code(integer,必填)
  • message(string,必填)
  • request_id(string,必填)
  • data(array,必填)

    返回示例

    json
    {
      "code": 0,
      "message": "SUCCEED",
      "request_id": "2cc4e73a-76a8-48ca-b510-eee57982f6b0",
      "data": [
        {
          "element_id": 171,
          "element_name": "天台",
          "element_description": "天台",
          "element_frontal_image": "https://example.com/…",
          "element_refer_list": [
            {
              "image_url": "https://example.com/…"
            }
          ],
          "owned_by": "kling",
          "tag_list": [
            {
              "id": "o_106",
              "name": "场景",
              "description": "None"
            }
          ]
        },
        {
          "element_id": 170,
          "element_name": "雪地",
          "element_description": "雪地",
          "element_frontal_image": "https://example.com/…",
          "element_refer_list": [
            {
              "image_url": "https://example.com/…"
            }
          ],
          "owned_by": "kling",
          "tag_list": [
            {
              "id": "o_106",
              "name": "场景",
              "description": "None"
            }
          ]
        },
        {
          "element_id": 169,
          "element_name": "宋代园林",
          "element_description": "宋代园林",
          "element_frontal_image": "https://example.com/…",
          "element_refer_list": [
            {
              "image_url": "https://example.com/…"
            }
          ],
          "owned_by": "kling",
          "tag_list": [
            {
              "id": "o_106",
              "name": "场景",
              "description": "None"
            }
          ]
        },
        {
          "element_id": 168,
          "element_name": "咖啡店",
          "element_description": "咖啡店",
          "element_frontal_image": "https://example.com/…",
          "element_refer_list": [
            {
              "image_url": "https://example.com/…"
            }
          ],
          "owned_by": "kling",
          "tag_list": [
            {
              "id": "o_106",
              "name": "场景",
              "description": "None"
            }
          ]
        },
        {
          "element_id": 167,
          "element_name": "雪山",
          "element_description": "雪山",
          "element_frontal_image": "https://example.com/…",
          "element_refer_list": [
            {
              "image_url": "https://example.com/…"
            }
          ],
          "owned_by": "kling",
          "tag_list": [
            {
              "id": "o_106",
              "name": "场景",
              "description": "None"
            }
          ]
        },
        {
          "element_id": 166,
          "element_name": "东方明珠",
          "element_description": "东方明珠",
          "element_frontal_image": "https://example.com/…",
          "element_refer_list": [
            {
              "image_url": "https://example.com/…"
            }
          ],
          "owned_by": "kling",
          "tag_list": [
            {
              "id": "o_106",
              "name": "场景",
              "description": "None"
            }
          ]
        },
        {
          "element_id": 165,
          "element_name": "旧游戏厅",
          "element_description": "旧游戏厅",
          "element_frontal_image": "https://example.com/…",
          "element_refer_list": [
            {
              "image_url": "https://example.com/…"
            }
          ],
          "owned_by": "kling",
          "tag_list": [
            {
              "id": "o_106",
              "name": "场景",
              "description": "None"
            }
          ]
        },
        {
          "element_id": 164,
          "element_name": "外星地表",
          "element_description": "外星地表",
          "element_frontal_image": "https://example.com/…",
          "element_refer_list": [
            {
              "image_url": "https://example.com/…"
            }
          ],
          "owned_by": "kling",
          "tag_list": [
            {
              "id": "o_106",
              "name": "场景",
              "description": "None"
            }
          ]
        },
        {
          "element_id": 163,
          "element_name": "城市雨夜街道",
          "element_description": "城市雨夜街道",
          "element_frontal_image": "https://example.com/…",
          "element_refer_list": [
            {
              "image_url": "https://example.com/…"
            }
          ],
          "owned_by": "kling",
          "tag_list": [
            {
              "id": "o_106",
              "name": "场景",
              "description": "None"
            }
          ]
        },
        {
          "element_id": 162,
          "element_name": "童年卧室",
          "element_description": "童年卧室",
          "element_frontal_image": "https://example.com/…",
          "element_refer_list": [
            {
              "image_url": "https://example.com/…"
            }
          ],
          "owned_by": "kling",
          "tag_list": [
            {
              "id": "o_106",
              "name": "场景",
              "description": "None"
            }
          ]
        }
      ]
    }
    

    使用提示:分页参数与返回字段以参数说明为准。