character-pipeline

Character Pipeline

This skill is stills-only. It builds reusable identity assets so the same person holds across plates and composites. If the user wants motion after that, hand off the approved scene still + sheets to video-prompting / cinematic-motion — do not own generate_video here.

Pipeline (hard order)

1. Hero still          generate_image (or import_media / user photo)
2. Multi-angle sheet   generate_image with referenceMediaRefs = [hero]
                       bust sheet default; optional full-body turnaround
3. Environment plate   generate_image — empty set, locked camera/light
4. Scene placement     generate_image: env plate + sheet (+ optional wardrobe)
5. Fidelity close-up   optional generate_image or capture_frame from the scene still

Do not skip to scene placement without an approved sheet. Reroll stills until lighting and identity pass.

Session gates

• get_timeline → canGenerate
• list_models({ type: "image" })
• Propose each paid generation; wait for confirmation
• Folders e.g. Character/Hero, Character/Sheets, Character/Scenes

Model picks

Confirm via list_models:

Step	Prefer
Hero / sheet / env / scene	grok-imagine, gpt-image-2, or seedream-v5-pro (photoreal trio)

Prefer gpt-image-2 / seedream-v5-pro for any step that needs referenceMediaRefs if the current Grok build rejects refs. Trust each model's aspect/resolution enums from list_models.

Step 1 — Hero still

Clear identity plate. Prefer candid editorial over beauty-retouch.

Include: age/skin/hair/eyes/expression; simple stable wardrobe; repeatable light; skin texture preserved (pores — no smoothing).

Avoid: unrepeatable glam grade; extreme pose that fights the sheet; busy BG that leaks into identity.

If the user supplies a photo, import_media and skip generation.

Step 2 — Character sheet

generate_image with referenceMediaRefs: [heroMediaRef].

Head / bust sheet (default — identity lock)