List avatars

List public and user Podcast avatars by type.

GET /open/podcast/v1/avatars

list avatars

cURL

curl --request GET \
  --url https://api-services.podcastor.ai/open/podcast/v1/avatars \
  --header 'X-Api-Key: <api-key>'

200

{
  "cause": "<string>",
  "code": 123,
  "data": {
    "list": [
      {
        "aspect_ratio": 123,
        "avatar_type": "<string>",
        "background_id": 123,
        "background_url": "<string>",
        "id": 123,
        "is_demo": true,
        "motion_preview_url": "<string>",
        "podcast_avatar_id": 123,
        "prjUserDigitalPerson1": {
          "activity_unique_id": "<string>",
          "aigc_photo_from": 123,
          "aigc_photo_target": "<string>",
          "app_id": "<string>",
          "aspect_ratio": 123,
          "auth_id": 123,
          "auth_status": 123,
          "authorization_status": 123,
          "avatar_type": "<string>",
          "avatar_url": "<string>",
          "avatar_x_belong": 123,
          "avatar_x_name": "<string>",
          "avatar_x_num": 123,
          "cover_url": "<string>",
          "created_at": 123,
          "deleted_at": 123,
          "description": "<string>",
          "face_center_x": 123,
          "face_center_y": 123,
          "face_url": "<string>",
          "fail_msg": "<string>",
          "first_click": 123,
          "from_api": true,
          "gender": 123,
          "h": 123,
          "id": 123,
          "is_mine": true,
          "keying_status": 123,
          "keying_video_url": "<string>",
          "lang_voice_map": {},
          "length": 123,
          "make_status": 123,
          "mask_url": "<string>",
          "motion_unique_id": "<string>",
          "name": "<string>",
          "operate_feedback": "<string>",
          "origin_be_optimize": 123,
          "origin_check_face_status": 123,
          "origin_type": 123,
          "origin_url": "<string>",
          "owner_avatar": "<string>",
          "owner_nick_name": "<string>",
          "person_source": 123,
          "photo_library_unique_id": "<string>",
          "podcast_typ": 123,
          "prefer_model": "<string>",
          "preview_mask_url": "<string>",
          "preview_url": "<string>",
          "product_status": 123,
          "progress": 123,
          "publish": 123,
          "remix_avatar_unique_id": "<string>",
          "review_status": 123,
          "show_type": "<string>",
          "show_type_preset": {
            "all": {
              "shape": {
                "color": "<string>",
                "h": 123,
                "r": 123,
                "type": "<string>",
                "w": 123,
                "x": 123,
                "y": 123
              },
              "size": {
                "h": 123,
                "w": 123
              }
            },
            "circle": {
              "shape": {
                "color": "<string>",
                "h": 123,
                "r": 123,
                "type": "<string>",
                "w": 123,
                "x": 123,
                "y": 123
              },
              "size": {
                "h": 123,
                "w": 123
              }
            }
          },
          "space_owner_plan_id": 123,
          "status": 123,
          "third_party_lip": 123,
          "timbre_id": 123,
          "timbre_name": "<string>",
          "typ": 123,
          "updated_at": 123,
          "voice_clone_status": 123,
          "voice_id": "<string>",
          "voice_info": {
            "age": "<string>",
            "gender": "<string>",
            "id": 123,
            "lang": "<string>",
            "name": "<string>",
            "preview_url": "<string>",
            "type": "<string>",
            "unique_id": "<string>"
          },
          "w": 123,
          "webm_url": "<string>",
          "welcome_text": "<string>",
          "welcome_url": "<string>"
        },
        "prjUserDigitalPerson2": {
          "activity_unique_id": "<string>",
          "aigc_photo_from": 123,
          "aigc_photo_target": "<string>",
          "app_id": "<string>",
          "aspect_ratio": 123,
          "auth_id": 123,
          "auth_status": 123,
          "authorization_status": 123,
          "avatar_type": "<string>",
          "avatar_url": "<string>",
          "avatar_x_belong": 123,
          "avatar_x_name": "<string>",
          "avatar_x_num": 123,
          "cover_url": "<string>",
          "created_at": 123,
          "deleted_at": 123,
          "description": "<string>",
          "face_center_x": 123,
          "face_center_y": 123,
          "face_url": "<string>",
          "fail_msg": "<string>",
          "first_click": 123,
          "from_api": true,
          "gender": 123,
          "h": 123,
          "id": 123,
          "is_mine": true,
          "keying_status": 123,
          "keying_video_url": "<string>",
          "lang_voice_map": {},
          "length": 123,
          "make_status": 123,
          "mask_url": "<string>",
          "motion_unique_id": "<string>",
          "name": "<string>",
          "operate_feedback": "<string>",
          "origin_be_optimize": 123,
          "origin_check_face_status": 123,
          "origin_type": 123,
          "origin_url": "<string>",
          "owner_avatar": "<string>",
          "owner_nick_name": "<string>",
          "person_source": 123,
          "photo_library_unique_id": "<string>",
          "podcast_typ": 123,
          "prefer_model": "<string>",
          "preview_mask_url": "<string>",
          "preview_url": "<string>",
          "product_status": 123,
          "progress": 123,
          "publish": 123,
          "remix_avatar_unique_id": "<string>",
          "review_status": 123,
          "show_type": "<string>",
          "show_type_preset": {
            "all": {
              "shape": {
                "color": "<string>",
                "h": 123,
                "r": 123,
                "type": "<string>",
                "w": 123,
                "x": 123,
                "y": 123
              },
              "size": {
                "h": 123,
                "w": 123
              }
            },
            "circle": {
              "shape": {
                "color": "<string>",
                "h": 123,
                "r": 123,
                "type": "<string>",
                "w": 123,
                "x": 123,
                "y": 123
              },
              "size": {
                "h": 123,
                "w": 123
              }
            }
          },
          "space_owner_plan_id": 123,
          "status": 123,
          "third_party_lip": 123,
          "timbre_id": 123,
          "timbre_name": "<string>",
          "typ": 123,
          "updated_at": 123,
          "voice_clone_status": 123,
          "voice_id": "<string>",
          "voice_info": {
            "age": "<string>",
            "gender": "<string>",
            "id": 123,
            "lang": "<string>",
            "name": "<string>",
            "preview_url": "<string>",
            "type": "<string>",
            "unique_id": "<string>"
          },
          "w": 123,
          "webm_url": "<string>",
          "welcome_text": "<string>",
          "welcome_url": "<string>"
        },
        "sort": 123,
        "status": 123,
        "tag": "<string>",
        "typ": 123
      }
    ]
  },
  "details": "<unknown>",
  "msg": "<string>",
  "rid": "<string>"
}

MCP tool: podcast_list_avatars. OAuth scope: asset.read.

Authorizations

X-Api-Key · string · header · required

Query Parameters

avatar_type · string · required

数字人类型：pet/cartoon/baby/all

aspect_ratio · integer

宽高比 0:9比16/1:16比9

Response

200 - application/json

OK

cause · string

code · integer

data · object

Show child attributes

details · any

msg · string

rid · string