Editing tools

Editing tools change a file you already have: an upload or an earlier result. You run them like a model: check the price first, then start the job.

Building with the API? List capabilities shows each tool's id next to its name.

All tools

• A file slot takes plain asset ids: "source_video": ["ast_..."].
• A longer file is refused before the tool runs. Trim it first. Upload sizes: Limits.
• Change Voice takes a voice id (voc_) as the top-level voice_id, the same as Text to Speech. To revoice a recording with no picture, use Speech to Speech.

Settings

Defaults are in bold. The live schema wins: Read one schema.

The other tools take only their files.

Chain tools

Put one job's output (its asset_id) in the next tool's file slot. Nothing is downloaded in between.

Each step is its own job, so wait for the result before you start the next. Split Into Scenes gives back several clips: chain each one on its own.

Example: trim a video to 15 seconds, make it vertical, then add captions.

{
  "capability_id": "trim_video",
  "config": {
    "source_video": ["ast_0193c8f0a1b24e7f9d3c5a6b7e8f0061"],
    "length": 15
  }
}

{
  "capability_id": "resize",
  "config": {
    "source_media": ["ast_0193c8f0a1b24e7f9d3c5a6b7e8f0062"],
    "aspect_ratio": "9:16",
    "mode": "crop"
  }
}

{
  "capability_id": "auto_caption",
  "config": {
    "source_video": ["ast_0193c8f0a1b24e7f9d3c5a6b7e8f0063"],
    "caption_style": "boxed"
  }
}

Exact words with Text Overlay

Image and video models still misspell words. For an exact headline, price or brand name, make the picture without the words. Then add them with Text Overlay.

• One text block per job, typed text only (not a logo).
• For a second line, run it again on the file the first job gave back.

{
  "capability_id": "text_overlay",
  "config": {
    "source_media": ["ast_0193c8f0a1b24e7f9d3c5a6b7e8f0064"],
    "text": "Free shipping this week",
    "position": "bottom",
    "background": "dark"
  }
}