Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.roughy.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
What is a processor

Each processor takes one or more input assets, applies a single transformation, and produces one or more output assets. Processors are composed inside a pipeline by listing them as steps; a downstream step reads either the original pipeline input or a prior step’s output, depending on the processor.

​
Cut

Produces cut decisions for video material. The cut processor runs ElevenLabs speech-to-text on the input, groups the resulting segments, sends them to Claude for cut analysis, and emits an SRT file describing which spans to keep and which to drop.
PropertyValue
InputOriginal pipeline input (AUDIO or VIDEO).
OutputCUT_FILE asset (SRT).
PricingPer second of input audio.
QueueI/O.
Configuration: 
{
  "mode": "unscripted",
  "model": "claude-opus-4-7",
  "language_code": "en"
}

​
Render

Applies cut decisions to the original media and produces a flattened MP4. The render processor reads the original pipeline input and the SRT output from a prior cut step, then runs ffmpeg to trim, concat, and encode the result under a render preset.
PropertyValue
InputOriginal pipeline input + SRT from a prior step.
OutputRENDERED_VIDEO asset (MP4).
PricingPer second of output video.
QueueCPU.
Configuration: 
{
  "preset": "web_1080p",
  "cut_step_order": 0
}
Available presets: web_1080p, web_720p, social_vertical_1080p. cut_step_order is the zero-based index of the cut step whose SRT should drive the render — usually 0 if cut is the first step.

​
Composing them

The typical two-step pipeline is cut → render: 
{
  "input_asset_id": "<asset_id>",
  "steps": [
    { "processor_name": "cut",    "config": { "mode": "unscripted", "language_code": "en" } },
    { "processor_name": "render", "config": { "preset": "web_1080p", "cut_step_order": 0 } }
  ]
}
You can also run cut alone if you only want the SRT — useful when the downstream tool is an NLE rather than Roughy’s renderer.
  • Pipeline — how processors are sequenced.
  • Asset — what processors read and write.