media/high-engagement-posts-from-hooks

High-Engagement Image Posts — AI-generated social media images with text overlays.

Category: media
Source: workflows/media/high_engagement_posts.py

Input Schema

Field	Type	Default	Description
`hook_ideas`	`object[]`	—	Pre-existing hook ideas
`platform`	`string`	`"instagram"`	Target platform
`quality`	`string`	`"premium"`	Quality preset
`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.
`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.

Output Schema

Field	Type	Default	Description
`best_per_platform`	`object`	—	Best post index per platform
`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.
`posts`	`object[]`	—	Generated post images with scores
`total_generated`	`integer`	`0`	Total number of posts generated
`workflow`	`string`	`"high-engagement-posts"`

Task Pipeline

craft_image_prompts → generate_post_images → score_post_images → prepare_post_output

Task	Description
`craft_image_prompts`	Craft image prompts — delegates to SDK stage.
`generate_post_images`	Generate post images — delegates to SDK stage.
`score_post_images`	Score post images — delegates to SDK stage.
`prepare_post_output`	Prepare post output — delegates to SDK stage.

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: media/high-engagement-posts-from-hooks

# Optional fields — copy any line(s) under `input:` and uncomment to set:
# Pre-existing hook ideas
#   hook_ideas: []
#
# Target platform
#   platform: instagram
#
# Quality preset
#   quality: premium
#

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=media/high-engagement-posts-from-hooks' \
  -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

Task craft_image_prompts has no Pydantic types — contract is opaque to consumers.
Task generate_post_images has no Pydantic types — contract is opaque to consumers.
Task score_post_images has no Pydantic types — contract is opaque to consumers.
Task prepare_post_output has no Pydantic types — contract is opaque to consumers.