clip/effects

AI Video Effects — Gemini-generated FFmpeg filters for professional effects.

Category: clip
Source: workflows/clip/effects.py

Input Schema

Field	Type	Default	Description
`color_grade_hint`	`string`	`""`
`content_type`	`string`	`"general"`
`effects_style`	`string`	`"modern social media"`
`hooked_path`	`object`	—
`media_path`	`string`	`""`
`mood`	`string`	`"energetic"`
`regenerate`	`object`	—	When set, this run is a regeneration. Workflows may read `direction` / `keep` / `extra_instructions` to modulate prompts; the engine persists `parent_run_id` and `parent_variant_index` as run lineage columns.
`subtitled_path`	`object`	—
`variants`	`integer`	`1`	Number of independent variant executions (1–10). When > 1, the engine runs the workflow N times with different sampling, producing N outputs.
`vertical_path`	`object`	—

Output Schema

No schema defined.

Task Pipeline

generate_effect_filters → apply_effects → add_outro_fade

Task	Description
`generate_effect_filters`	Use Gemini to suggest FFmpeg filters based on content type.
`apply_effects`	Apply AI-generated FFmpeg filters to the video.
`add_outro_fade`	Add a fade-to-black outro at the end of the video.

Run-spec example

Save the YAML below as my-run.yaml, edit the values, and run with the CLI or POST it to the API. Required fields are uncommented; optional knobs are documented above the input: block — copy any line under input: and uncomment to set.

workflow: clip/effects

# Optional fields — copy any line(s) under `input:` and uncomment to set:
#   color_grade_hint: ""
#
#   content_type: general
#
#   effects_style: modern social media
#
#   hooked_path: null
#
#   media_path: ""
#
#   mood: energetic
#
#   subtitled_path: null
#
#   vertical_path: null
#

input: {}

Run it locally:

fab-workflow --from-file my-run.yaml

Or submit over the wire — the same file is the request body:

curl -X POST 'https://gofabric.dev/v1/workflows/runs?name=clip/effects' \
  -H 'Authorization: Bearer fab_xxx' \
  -H 'content-type: application/yaml' \
  --data-binary @my-run.yaml

Every workflow also accepts the universal WorkflowInput fields — variants (1–10 fan-out) and regenerate (creative-direction hints with run lineage). See Run-specs (YAML / TOML / JSON) for the full top-level shape (metadata, priority, bundle, parent, etc.).

Warnings

Last user task add_outro_fade has no Pydantic return type — workflow output schema is null. Declare a WorkflowOutput subclass and pass it to Flow(output=…) for a strict contract.