360 Secure SkillHub
360 安全技能中心

Script + Custom Media

该 Skill 说明如何调用 Revid 的 script-to-video 渲染接口，将用户提供的脚本与自有视频/图片素材合成为品牌视频，并用 useOnlyProvided 等标志禁止混入库存画面，同时给出请求模板、字段说明、执行步骤与常见失败排查。

api00
api00
热度 31.21
最近更新 2026-05-11 17:46:01
分类：创作依赖：第三方 API / 代码执行应用场景：视频编辑 / 品牌素材 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add revid-script-with-custom-media
Metadata
name
revid-script-with-custom-media
description
Render a video from a script using only the media assets the caller provides (no stock visuals). Use for branded content where every frame must be on-brand — product clips, brand b-roll, hand-shot footage.
metadata
{"openclaw":{"requires":{"config":["REVID_API_KEY"]}}}

Script + your own media → branded video

For when the user has the script and the visuals. Revid only handles voice + captions + assembly. No stock content is mixed in.

When to use this skill

  • The user has both a script and a set of clips/images they want used.
  • Brand fidelity matters more than visual variety.
  • For mixed (your media + stock to fill gaps), drop media.useOnlyProvided and use revid-script-to-video with media.provided.

Inputs

Field Required Notes
text yes The script
media.provided[] yes At least 3 items recommended; URLs must be public
aspectRatio no Default 9:16
voiceId no Default voice if omitted

MediaItem shape:

{ "url": "https://…", "type": "image" | "video" | "audio", "title": "optional", "noReencode": false }

Use type: "image" for stills (Revid will optionally pan/zoom them via media.turnImagesIntoVideos). Use type: "video" for clips. Keep clip duration roughly comparable to the script length.

Step-by-step

  1. Validate every media.provided[].url returns 200 and a video/image content-type.
  2. Confirm enough assets for the script: rough rule = 1 asset per 8–10 s of script, minimum 3.
  3. POST /render with media.useOnlyProvided: true.
  4. Poll /status.

API call template

POST /api/public/v3/render
Host: www.revid.ai
Content-Type: application/json
key: $REVID_API_KEY

{
  "workflow": "script-to-video",
  "source": {
    "text": "{SCRIPT}"
  },
  "aspectRatio": "9:16",
  "voice":    { "enabled": true, "voiceId": "aria-en-us", "stability": 0.6, "speed": 1.0 },
  "captions": { "enabled": true, "position": "middle", "autoCrop": true },
  "music":    { "enabled": true, "syncWith": "beats" },
  "media": {
    "type": "custom",
    "useOnlyProvided": true,
    "turnImagesIntoVideos": true,
    "mergeVideos": false,
    "animation": "soft",
    "provided": [
      { "url": "https://cdn.example.com/clip-1.mp4", "type": "video" },
      { "url": "https://cdn.example.com/clip-2.mp4", "type": "video" },
      { "url": "https://cdn.example.com/hero.jpg",   "type": "image" }
    ]
  },
  "options": {
    "summarizationPreference": "no-summarization",
    "useOnlyProvidedMedia": true,
    "soundEffects": false,
    "hasToGenerateCover": true
  },
  "render": { "resolution": "1080p", "frameRate": 30 }
}

Both media.useOnlyProvided and options.useOnlyProvidedMedia should be true — they belong to slightly different paths in the legacy code and setting both is the safest way to forbid stock fill.

Examples

Failure modes

Symptom Fix
Final video pads with stock anyway One of the two flags wasn't honored. Make sure both media.useOnlyProvided: true AND options.useOnlyProvidedMedia: true are set.
Video too short / dead air Not enough assets. Add more provided items or set mergeVideos: true to loop the existing clips.
Wrong asset on a particular line Pre-order assets in the array roughly in narrative order — Revid uses array order as a hint.
Asset URL 403 / 404 Make sure assets are public (signed URLs work as long as they don't expire mid-render).

See also