video/recreate-from-format

Recreate From Format — generate original content following a format blueprint.

Category: video
Source: workflows/video/recreate_from_format.py

Input Schema

Field	Type	Default	Description
`artifact_dir`	`object`	—	Override output directory.
`asset_constraints`	`string`	`""`	Available asset constraints.
`audience`	`string`	`""`	Target audience.
`creator_persona`	`string`	required	Creator persona description.
`format_dna_json_path`	`string`	required	Path to format_dna.json from analysis workflow.
`include_cta`	`boolean`	`true`	Include CTA in output.
`include_edit_recipe`	`boolean`	`true`	Generate edit recipe.
`include_overlays`	`boolean`	`true`	Generate overlay captions.
`include_tts_audio`	`boolean`	`false`	Generate TTS audio.
`include_voiceover`	`boolean`	`true`	Generate voiceover text.
`platform`	`string`	required	Target platform.
`recreation_blueprint_json_path`	`string`	required	Path to recreation_blueprint.json from analysis workflow.
`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.
`script_variants`	`integer`	`1`	Number of script variants to generate inside this run. Orthogonal to the engine-level `variants` knob (which fans out N parallel runs). Set both to multiply: variants=3 + script_variants=2 = 6 total scripts across 3 runs.
`target_duration_sec`	`object`	—	Override duration (default: from blueprint).
`tone`	`string`	required	Tone: energetic, calm, sarcastic, etc.
`topic`	`string`	required	Content topic.
`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.
`visual_style_notes`	`string`	`""`	Visual style guidance.

Output Schema

Field	Type	Default	Description
`kind`	`object`	—	Variant card shape: video / carousel / image / text. Surfaced on the per-variant entry of the run-output API and used by gallery UIs to pick the right layout.
`manifest_json_path`	`string`	`""`	Path to recreation_manifest.json
`variants`	`object[]`	—	Per-variant artifact paths.

Task Pipeline

load_and_extract_constraints → generate_scripts → generate_shotlists_and_overlays → generate_edit_recipes → emit_recreation_artifacts

Task	Description
`load_and_extract_constraints`	Load format DNA and blueprint, extract recreation constraints.
`generate_scripts`	Generate original scripts for each variant.
`generate_shotlists_and_overlays`	Generate shotlists and overlay captions for each variant.
`generate_edit_recipes`	Generate edit recipes and optional TTS for each variant.
`emit_recreation_artifacts`	Write all per-variant artifacts to disk.

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: video/recreate-from-format

# Optional fields — copy any line(s) under `input:` and uncomment to set:
# Override output directory.
#   artifact_dir: null
#
# Available asset constraints.
#   asset_constraints: ""
#
# Target audience.
#   audience: ""
#
# Include CTA in output.
#   include_cta: true
#
# Generate edit recipe.
#   include_edit_recipe: true
#
# Generate overlay captions.
#   include_overlays: true
#
# Generate TTS audio.
#   include_tts_audio: false
#
# Generate voiceover text.
#   include_voiceover: true
#
# Number of script variants to generate inside this run. Orthogonal to the engine-level `variants` knob (which fans out N parallel runs). Set both to multiply: variants=3 + script_variants=2 = 6 total scripts across 3 runs.
#   script_variants: 1
#
# Override duration (default: from blueprint).
#   target_duration_sec: null
#
# Visual style guidance.
#   visual_style_notes: ""
#

input:
  # Creator persona description.
  creator_persona: ""

  # Path to format_dna.json from analysis workflow.
  format_dna_json_path: ""

  # Target platform.
  platform: ""

  # Path to recreation_blueprint.json from analysis workflow.
  recreation_blueprint_json_path: ""

  # Tone: energetic, calm, sarcastic, etc.
  tone: ""

  # Content topic.
  topic: ""

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=video/recreate-from-format' \
  -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.).