Skip to main content
POST
add background
MCP tool: podcast_add_background. OAuth scope: asset.write.

Authorizations

X-Api-Key
string
header
required

Headers

Idempotency-Key
string

Replay a completed identical request without repeating side effects.

Maximum string length: 128

Body

application/json

Request body.

aspect_ratio
enum<integer>
required

Aspect ratio. An explicit value of 0 is valid and differs from an omitted value.

Available options:
0,
1
avatar_type
enum<string>
required

Avatar type: default, cartoon, or pet.

Available options:
default,
cartoon,
pet
origin_url
string
required

Original image URL. User identity, Space, dimensions, and timestamps are assigned by the server.

Maximum string length: 512
typ
enum<integer>
required

Background type: 0 = Speaker Focus; 2 = Alternating shots.

Available options:
0,
2
preview_url
string

Optional preview image URL. Defaults to the original image.

Maximum string length: 512

Response

OK

cause
string
code
integer
data
object
details
any
msg
string
rid
string