🛠️ Workflow — steps 1 to 4

THE WORKFLOW — run all of this from a single prompt

1. Define the brief (works for any site — no extra questions unless the subject is clear)

Based on the user's prompt, select: type of site, hero subject, vibe/palette, brand/name (make one up if none is provided) and 2 hero movements. The hero subject is what the site is about — a product, a person/founder, a building/space, a dish, a vehicle, or an abstract visual. Default movements by site type:

• Product (bottle, gadget, sneaker, cosmetic) → 360° rotation + explosion/spill/reveal.
• Portfolio / personal brand → cinematic portrait or abstract liquid/geometry movement + slow parallax/orbit.
• Agency / app / SaaS → abstract 3D shape/logo morph or UI in space + light sweep.
• Contractors / home services / real estate → slow orbit or pass through a building/house/construction project + reveal of details.
• Restaurant / food → 360° dish + movement of ingredients/steam or a pass through the interior.
• Fitness / events / travel → subject movement (athlete, crowd, landscape) + sweeping camera movement.

If you're unsure, use a hero orbit/pass + one clip of reveal/parallax.

2. Generate the hero keyframe (Higgsfield generate_image)

• Model: nano_banana_pro (higher quality / sharper). Prompt the hero subject for the site

(product, person, place, abstract), strong lighting, intentional background, "ultra sharp, photorealistic, 8k, editorial/advertising." 16:9. (For portfolios, you can also use an abstract 3D render in the brand color to avoid likeness/IP issues.)

• Verify job_display up to status:"completed"; keep the id from the job (used as the video's opening frame).

3. Generate 1–2 cinematic clips (Higgsfield generate_video)

• Model: seedance_2_0, resolution:"1080p", aspect_ratio:"16:9", duration:6,

medias:[{role:"start_image", value:<id do keyframe>}]. Always pass declined_preset_id:"24bae836-2c4a-48e0-89b6-49fcc0b21612" if it suggests a preset; if it suggests a different preset, try again with that preset's ID in declined_preset_id.

• Motion prompt patterns (choose what fits the subject):
• turntable — “smooth, continuous 360-degree rotation, one full revolution, stays centered”.
• fly-through — “slow, continuous camera flight forward through/around the [building/space/scene], smooth dolly, deep parallax”.
• reveal/explosion — “the [contents/components/elements] burst or assemble outward and float in slow motion” (keep the object/scene context—moderation-friendly).
• abstract — “elegant shape of liquid metal / glass / particles slowly morphing, floating and rotating”.
• Generate both clips in parallel (two tool calls in one message), then verify job_display.

1080p renders take ~3–8 min; sleep in the background between checks.

• Cost: run a pre-check with get_cost:true once; ~54 credits per clip at 1080p. Confirm if the user is running low on credits.

4. Handle the render results

• completed → download results.rawUrl with curl.
• nsfw or failed → refunded, try again. Moderation incorrectly flags abstract "floating pills / dissolving figures"; rewrite it in a product context, or switch that clip to grok_video_v15

(resolution:"720p", more forgiving). Product turntables/explosions work at 1080p.

• Tell the user about any retry; never claim a clip was rendered if it wasn't.