List backgrounds

List shared public and current-user Podcast backgrounds.

GET /open/podcast/v1/backgrounds

list backgrounds

cURL

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

200

{
  "cause": "<string>",
  "code": 123,
  "data": {
    "list": [
      {
        "aspect_ratio": 123,
        "avatar_type": "<string>",
        "err_msg": "<string>",
        "for_stage": 123,
        "height": 123,
        "id": 123,
        "is_show": 123,
        "label": "<string>",
        "left_url": "<string>",
        "origin_url": "<string>",
        "photo_unique_id": "<string>",
        "preview_url": "<string>",
        "progress": 123,
        "progress_desc": "<string>",
        "prompt": "<string>",
        "reference_images": [
          {
            "key": "<string>",
            "url": "<string>"
          }
        ],
        "right_url": "<string>",
        "source": "<string>",
        "style": "<string>",
        "typ": 123,
        "user_background_id": 123,
        "width": 123
      }
    ]
  },
  "details": "<unknown>",
  "msg": "<string>",
  "rid": "<string>"
}

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

Authorizations

X-Api-Key · string · header · required

Query Parameters

aspect_ratio · enum<integer> · required

宽高比：0=9:16，1=16:9

Available options: 0, 1

avatar_type · enum<string> · required

AspectRatio 和 Typ 使用指针，是为了区分“明确传入 0”和“完全没有传入”。 两个字段的 0 都是合法枚举值，不能使用普通 int 配合 required 校验。

Available options: default, cartoon, pet

typ · enum<integer> · required

背景类型：0=Speaker Focus，2=Alternating shots

Available options: 0, 2

Response

200 - application/json

OK

cause · string

code · integer

data · object

Show child attributes

details · any

msg · string

rid · string