智能剪辑 - 新闻体视频

智能剪辑 · 新闻体视频

提交新闻体视频任务。如未传 processRules.videoDuration,平台会探测素材媒体时长用于计费;无法获取有效输入媒体时长时会拒绝提交。

基本信息

字段内容
应用编码smart_clip
API 编码news_mixcut
请求方式POST
请求路径/api/v1/apps/smart_clip/news_mixcut
调用模式异步

请求参数

参数类型必填默认值可选值 / 范围说明
styleIdstring是--视频模板ID
titlestring是-3-1800字符标题
materialsarray是-image / video素材,每项包含 type、fileUrl、soundSwitch;平台会探测素材媒体时长用于计费
introduceCardobject否--身份栏信息,包含 name、description
packRulesobject否--包装规则:仅用于控制标题、素材、字幕、关键词、背景音乐等是否参与模板效果包装
processRules.watermarkShowboolean否falsetrue / false是否添加“AI生成”字样水印
processRules.videoDurationinteger否-5-300视频时长,单位秒,默认跟随素材资源时长
processRules.metadataobject否--元水印数据,仅支持写入一组数据,且value值需为字符串
processRules.materialCompositionstring否randomrandom / order素材组合方式
processRules.firstFrameCoverobject否--首帧封面配置
structLayersarray否--需要修改的图层数据
callbackUrlstring否-HTTPS URL结果通知回调地址,由平台在任务完成或失败后通知

processRules

字段类型必填默认值可选值 / 范围说明
watermarkShowboolean否falsetrue / false是否添加“AI生成”字样水印
videoDurationinteger否跟随素材资源时长5-300视频时长,单位:秒
metadataobject否--元水印数据,仅支持写入一组数据,且 value 值需为字符串
materialCompositionstring否randomrandom / order素材组合方式,random 随机,order 顺序
firstFrameCoverobject否--首帧封面配置

重要规则

  • 素材 materials[].fileUrl、背景音乐 packRules.backgroundMusic.audioUrl、AI 封面的 resultImageUrl 地址不能重名,重名会导致渲染异常。
  • packRules 仅用于控制标题、字幕、素材、背景音乐、关键词等图层是否参与效果包装,不能控制对应图层的显示/隐藏。
  • 如果期望生成的视频不显示标题,请不要设置标题值。
  • callbackUrl 作为平台任务通知地址保存,任务完成或失败后由平台发起通知。
  • 如无法解析有效输入媒体时长,本次请求会被拒绝,不使用默认时长。

通用对象字段

subtitle[]

字段类型必填说明
startMsinteger是时间戳开始,单位 ms
endMsinteger是时间戳结束,单位 ms,最大支持 310000ms
textstring是文本,只支持单字符级别

materials[]

字段类型必填可选值 / 默认值说明
typestring是image / video素材类型
fileUrlstring是-素材url
soundSwitchboolean否false当素材为视频时原声开关,素材混剪和新闻体视频支持

introduceCard

字段类型必填说明
namestring否名称
descriptionstring否描述

packRules

字段类型必填默认值说明
headerSwitchboolean否-标题包装开关
materialSwitchboolean否-素材包装开关
subtitleSwitchboolean否-字幕包装开关
keywordSwitchboolean否-关键词包装开关
backgroundMusicobject否-背景音乐设置
backgroundMusic.audioSwitchboolean否-音乐开关
backgroundMusic.audioUrlstring否-音频url,模板内置背景音乐和传递audioUrl,优先使用audioUrl
backgroundMusic.volumenumber否0.3音量,保留一位小数,范围 0-1

processRules.firstFrameCover

字段类型必填默认值说明
coverSwitchboolean否false封面开关
templateIdstring否-模版ID,如果未设置则系统匹配
imageUrlstring否-图片地址,用于生成AI封面图的底图,imageUrl 和 resultImageUrl 二选一必填
resultImageUrlstring否-图片生成接口的结果图片地址或其他封面图片地址;传了此值将直接运用作为视频首桢封面,优先级更高

structLayers[]

字段类型必填可选值说明
markCodestring是headerLayer / subtitleLayer / ipLayer / backgroundLayer / figureLayer图层,对应模板详情接口返回的图层数据
showboolean否-是否显示,不设置时默认跟随模板;backgroundLayer、figureLayer 不支持设置,默认显示
showModestring否always / customize显示模式,markCode=headerLayer 时生效,不设置时默认跟随模板
showTimenumber条件必填大于 0显示时长,markCode=headerLayer 且 showMode=customize 时生效且必填,保留 3 位小数
layer.transform.positioninteger[]否-锚点定位,对应模板详情 transform.position
layer.uristring否-背景图片资源链接,仅 backgroundLayer 生效

素材与媒体要求

  • 输入视频格式:mp4、mov;视频编码 h264、HEVC(h265);帧率 10-60fps,推荐 25;单边分辨率小于 2000px。
  • 真人口播 videoUrl 时长小于 5 分钟,文件大小小于 500MB,视频中的音频需要能够语音转文本。
  • 素材总量限制:单张图片计算为 2 秒,单个视频素材不能超过 60 秒,所有素材总时长不能超过 5 分钟。
  • 素材图片格式支持 jpg、png、webp 静态图,单边分辨率小于 2000px。
  • 素材视频格式支持 mp4、mov,单个视频小于 500MB,单边分辨率小于 2000px。
  • 背景音乐格式支持 mp3、wav、m4a,文件大小不超过 120MB,时长不超过 5 分钟。
  • 首帧封面 imageUrl、resultImageUrl 格式支持 jpg/jpeg、png,文件大小不超过 10MB,单边分辨率小于 2000px。

请求示例

{
  "styleId": "68aebb91b8619ed6f4168f40",
  "title": "聊AI行业",
  "materials": [
    {"type": "image", "fileUrl": "https://example.com/a.jpg", "soundSwitch": false},
    {"type": "video", "fileUrl": "https://example.com/b.mp4", "soundSwitch": false}
  ],
  "introduceCard": {
    "name": "廖志勇",
    "description": "AI行业领军人物"
  },
  "packRules": {
    "headerSwitch": true,
    "materialSwitch": true,
    "subtitleSwitch": true,
    "keywordSwitch": true,
    "backgroundMusic": {
      "audioSwitch": true,
      "audioUrl": "https://example.com/bg.mp3",
      "volume": 1
    }
  },
  "processRules": {
    "materialComposition": "random",
    "watermarkShow": true,
    "videoDuration": 30,
    "metadata": {
      "AIGC": "{"Label":"1","ContentProducer":"AI服务提供者的名称或统一社会信用代码等","ProduceID":"XXXXXXXXXXXXXXXXXXX"}"
    }
  },
  "structLayers": [
    {
      "markCode": "headerLayer",
      "show": true,
      "showMode": "customize",
      "showTime": 2,
      "layer": {"transform": {"position": [0, 0, 0]}}
    }
  ],
  "callbackUrl": "https://example.com/hook"
}

成功响应

{
  "code": 1,
  "msg": "success",
  "data": {
    "task_id": "task_xxxxxxxxxxxx",
    "status": "processing",
    "app": "smart_clip",
    "api": "news_mixcut"
  }
}

响应字段

字段类型必返说明
task_idstring是平台任务 ID
statusstring是平台任务状态,提交后通常为 processing 或 queued
appstring是应用编码,固定为 smart_clip
apistring是API 编码

任务结果

任务完成后,平台任务查询结果中的 result 通常包含:

字段类型说明
video_urlstring视频url地址,视频生成类任务返回
cover_urlstring视频封面url地址
durationnumber生成的视频或音频时长,单位:秒
dataobject完整结果数据

任务失败时返回错误码和错误描述。

同类文章