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

请求体

aspect_ratio
enum<integer>
required

指针字段确保 aspect_ratio=0、typ=0 不会被 binding 的 required 误判为空值。

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

数字人类型:default/cartoon/pet

Available options:
default,
cartoon,
pet
origin_url
string
required

user_id、space_id、真实宽高及时间字段均由服务端生成,禁止通过请求体透传。

Maximum string length: 512
typ
enum<integer>
required

背景类型:0=Speaker Focus,2=Alternating shots

Available options:
0,
2
preview_url
string

可选预览图 URL,为空时使用原图

Maximum string length: 512

Response

200 - application/json

OK

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