② 查询素材组列表

POST /v1/private-avatar/groups/list

MethodPOST
Path/v1/private-avatar/groups/list
Typehttp
Status1
Module2102810
Folder87318195

概览

MethodPOST
Path/v1/private-avatar/groups/list
Typehttp
Status1
Module2102810
Folder87318195

参数

{
  "path": [],
  "query": [],
  "cookie": [],
  "header": []
}

请求体

{
  "type": "application/json",
  "parameters": [],
  "jsonSchema": {
    "type": "object",
    "required": [
      "model"
    ],
    "properties": {
      "model": {
        "type": "string",
        "description": "路由选择参数(固定传此值)",
        "enum": [
          "doubao-seedance-2-0-260128",
          "doubao-seedance-2-0-fast-260128"
        ],
        "examples": [
          "doubao-seedance-2-0-260128"
        ]
      },
      "Filter": {
        "type": "object",
        "properties": {
          "Name": {
            "type": "string",
            "description": "组名模糊匹配"
          },
          "GroupIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "examples": [
              [
                "group-20260601191715-9q47m"
              ]
            ]
          },
          "GroupType": {
            "type": "string",
            "enum": [
              "AIGC",
              "LivenessFace"
            ],
            "examples": [
              "AIGC"
            ]
          }
        },
        "x-apifox-orders": [
          "Name",
          "GroupIds",
          "GroupType"
        ]
      },
      "PageNumber": {
        "type": "integer",
        "default": 1,
        "examples": [
          1
        ]
      },
      "PageSize": {
        "type": "integer",
        "default": 10,
        "examples": [
          10
        ]
      }
    },
    "x-apifox-orders": [
      "model",
      "Filter",
      "PageNumber",
      "PageSize"
    ]
  },
  "mediaType": "application/json",
  "oasExtensions": "",
  "required": true,
  "additionalContentTypes": [],
  "examples": [
    {
      "mediaType": "application/json",
      "value": "{\n    \"model\": \"doubao-seedance-2-0-260128\",\n    \"Filter\": {\n        \"Name\": \"暴建军\",\n        \"GroupIds\": [\n            \"group-20260601191715-9q47m\"\n        ],\n        \"GroupType\": \"AIGC\"\n    },\n    \"PageNumber\": 1,\n    \"PageSize\": 10\n}"
    }
  ]
}

响应

[
  {
    "id": 195659335,
    "name": "",
    "code": 200,
    "contentType": "json",
    "jsonSchema": {
      "type": "object",
      "properties": {
        "ResponseMetadata": {
          "type": "object",
          "properties": {
            "RequestId": {
              "type": "string",
              "examples": [
                "20260601191715C9DAA092032F19CEC367"
              ]
            },
            "Action": {
              "type": "string",
              "examples": [
                "CreateAssetGroup"
              ]
            },
            "Version": {
              "type": "string",
              "examples": [
                "2024-01-01"
              ]
            },
            "Service": {
              "type": "string",
              "examples": [
                "ark"
              ]
            },
            "Region": {
              "type": "string",
              "examples": [
                "cn-beijing"
              ]
            },
            "Error": {
              "type": "object",
              "properties": {
                "Code": {
                  "type": "string",
                  "examples": [
                    "AccessDenied"
                  ]
                },
                "Message": {
                  "type": "string"
                }
              },
              "x-apifox-orders": [
                "Code",
                "Message"
              ]
            }
          },
          "x-apifox-orders": [
            "RequestId",
            "Action",
            "Version",
            "Service",
            "Region",
            "Error"
          ]
        },
        "Result": {
          "type": "object",
          "properties": {
            "Total": {
              "type": "integer",
              "examples": [
                1
              ]
            },
            "PageNumber": {
              "type": "integer",
              "examples": [
                1
              ]
            },
            "PageSize": {
              "type": "integer",
              "examples": [
                10
              ]
            },
            "Items": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "Id": {
                    "type": "string",
                    "examples": [
                      "group-20260601191715-9q47m"
                    ]
                  },
                  "Name": {
                    "type": "string",
                    "examples": [
                      "my_virtual_group"
                    ]
                  },
                  "Description": {
                    "type": "string"
                  },
                  "GroupType": {
                    "type": "string",
                    "enum": [
                      "AIGC",
                      "LivenessFace"
                    ],
                    "examples": [
                      "AIGC"
                    ]
                  },
                  "CreateTime": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "UpdateTime": {
                    "type": "string",
                    "format": "date-time"
                  }
                },
                "x-apifox-orders": [
                  "Id",
                  "Name",
                  "Description",
                  "GroupType",
                  "CreateTime",
                  "UpdateTime"
                ]
              }
            }
          },
          "x-apifox-orders": [
            "Total",
            "PageNumber",
            "PageSize",
            "Items"
          ]
        }
      },
      "x-apifox-orders": [
        "ResponseMetadata",
        "Result"
      ]
    },
    "itemSchema": {},
    "description": "查询成功",
    "mediaType": "application/json",
    "headers": [],
    "oasExtensions": ""
  }
]