⑦ 查询素材列表

POST /v1/private-avatar/assets/list

MethodPOST
Path/v1/private-avatar/assets/list
Typehttp
Status1
Module2102810
Folder87318196

概览

MethodPOST
Path/v1/private-avatar/assets/list
Typehttp
Status1
Module2102810
Folder87318196

参数

{
  "query": [],
  "path": [],
  "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": {
          "GroupIds": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "examples": [
              [
                "group-20260601191715-9q47m"
              ]
            ]
          },
          "GroupType": {
            "type": "string",
            "enum": [
              "AIGC",
              "LivenessFace"
            ],
            "examples": [
              "AIGC"
            ]
          },
          "Statuses": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "Processing",
                "Active",
                "Failed"
              ]
            },
            "examples": [
              [
                "Active",
                "Processing"
              ]
            ]
          },
          "Name": {
            "type": "string"
          }
        },
        "x-apifox-orders": [
          "GroupIds",
          "GroupType",
          "Statuses",
          "Name"
        ]
      },
      "PageNumber": {
        "type": "integer",
        "default": 1,
        "examples": [
          1
        ]
      },
      "PageSize": {
        "type": "integer",
        "default": 10,
        "examples": [
          10
        ]
      },
      "SortBy": {
        "type": "string",
        "examples": [
          "GroupId"
        ]
      },
      "SortOrder": {
        "type": "string",
        "enum": [
          "Asc",
          "Desc"
        ],
        "examples": [
          "Asc"
        ]
      }
    },
    "x-apifox-orders": [
      "model",
      "Filter",
      "PageNumber",
      "PageSize",
      "SortBy",
      "SortOrder"
    ]
  },
  "required": true,
  "mediaType": "application/json",
  "examples": [
    {
      "mediaType": "application/json",
      "value": "{\n    \"model\": \"doubao-seedance-2-0-260128\",\n    \"Filter\": {\n        \"GroupIds\": [\n            \"group-20260601191715-9q47m\"\n        ],\n        \"GroupType\": \"AIGC\",\n        \"Statuses\": [\n            \"Active\",\n            \"Processing\"\n        ],\n        \"Name\": \"雀国华\"\n    },\n    \"PageNumber\": 1,\n    \"PageSize\": 10,\n    \"SortBy\": \"GroupId\",\n    \"SortOrder\": \"Asc\"\n}"
    }
  ],
  "oasExtensions": ""
}

响应

[
  {
    "id": 157073787,
    "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"
            },
            "PageNumber": {
              "type": "integer"
            },
            "PageSize": {
              "type": "integer"
            },
            "Items": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "Id": {
                    "type": "string",
                    "examples": [
                      "asset-20260318071009-xxxxx"
                    ]
                  },
                  "GroupId": {
                    "type": "string",
                    "examples": [
                      "group-20260601191715-9q47m"
                    ]
                  },
                  "Status": {
                    "type": "string",
                    "enum": [
                      "Processing",
                      "Active",
                      "Failed"
                    ],
                    "examples": [
                      "Active"
                    ]
                  },
                  "AssetType": {
                    "type": "string",
                    "enum": [
                      "Image",
                      "Video",
                      "Audio"
                    ]
                  },
                  "Name": {
                    "type": "string"
                  },
                  "URL": {
                    "type": "string",
                    "description": "素材 CDN 地址,有效期 12 小时"
                  },
                  "CreateTime": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "UpdateTime": {
                    "type": "string",
                    "format": "date-time"
                  }
                },
                "x-apifox-orders": [
                  "Id",
                  "GroupId",
                  "Status",
                  "AssetType",
                  "Name",
                  "URL",
                  "CreateTime",
                  "UpdateTime"
                ]
              }
            }
          },
          "x-apifox-orders": [
            "Total",
            "PageNumber",
            "PageSize",
            "Items"
          ]
        }
      },
      "x-apifox-orders": [
        "ResponseMetadata",
        "Result"
      ]
    },
    "itemSchema": {},
    "description": "查询成功",
    "mediaType": "application/json",
    "headers": [],
    "oasExtensions": ""
  }
]