广告物料上传

上传一张图片或一个视频。上传成功后，物料自动绑定到指定广告账户。

请求地址 ： https://catyph.ximalaya.com/ads-catyph/v1/segment/upload

请求方式 ： POST

Content-Type ： multipart/form-data

请求头参数 ：

请求参数 ：

传参形式 ： Form Data

支持的文件：

• 图片：JPG、JPEG、PNG、GIF
• 视频：MP4
• 每次请求仅允许上传一个文件，图片和视频不能同时上传
• 文件格式必须与文件真实内容一致，仅修改文件扩展名不能通过校验
• JPG 和 JPEG 按同一种图片格式处理
• 文件大小、图片或视频分辨率、宽高比以及 GIF/视频时长，必须同时匹配同一条当前可用广告样式规则
• GIF 和视频时长按实际秒数校验；无法解析时长且样式配置了时长限制时，上传失败

请求示例：

curl -X POST \
  'https://catyph.ximalaya.com/ads-catyph/v1/segment/upload' \
  -H 'access-token: ACCESS_TOKEN' \
  -F 'ad_account_id=AD_ACCOUNT_ID' \
  -F 'files=@/absolute/path/banner.jpg;type=image/jpeg'

图片和视频必须分开请求，不能在一次请求中同时上传。

返回字段释义：

接口不返回素材 ID、URL、MD5、尺寸等其他业务数据。

成功示例：

{
  "status": 0,
  "type": "SUCCESS",
  "msg": "success",
  "trace_id": "045394684339f2d5561448a920bcff8c"
}

失败示例：

{
  "status": 10010022,
  "type": "ERROR",
  "msg": "视频分辨率不符合要求：实际720×1280，支持的最小分辨率为1280×720",
  "trace_id": "045394684339f2d5561448a920bcff8c"
}

失败原因：