About model-routing
A genmedia skill that routes image and video tasks to specified model endpoints and requires checking their availability, schema, and pricing before use. It is for agents choosing models for creative work.
Key features
- 01Endpoint defaults by image and video task
- 02Fallback rules for unavailable endpoints
- 03Schema and pricing checks before use
Use cases
- 01Selecting a model for text-heavy images
- 02Routing video generation by quality or cost
- 03Choosing endpoints for campaign and UGC assets
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/model-routingin Claude Code to confirm it loaded.
Details
From the project READMEGenmedia model routing
Use these endpoint defaults when a domain skill needs a model. These choices
come from project-specific guidance. Still run genmedia schema <endpoint_id> --json before execution and genmedia pricing <endpoint_id> --json when cost
matters.
Endpoint-first rule:
- Pick the endpoint ID from this skill.
- Verify it with
genmedia models --endpoint_id <endpoint_id> --json. - Inspect it with
genmedia schema <endpoint_id> --json. - Check
genmedia pricing <endpoint_id> --jsonwhen cost matters. - Use text search only if the routed endpoint is missing, deprecated, rejected, or the task needs a model role not covered here.
Do not invent endpoint IDs.
Image generation
Text-heavy image work
Use for infographics, UI mockups, posters, product labels, packaging text, readable signs, book covers, educational diagrams, and any output where text inside the image must be accurate.
openai/gpt-image-2- Use
quality=high. - Prefer 2K or 4K custom
image_sizewhen the final must be detailed. - Treat as expensive. Do not use it for cheap drafts.
- Use
fal-ai/nano-banana-pro- Use as the second choice when text is important but GPT Image 2 is not available or the user accepts a lower ceiling.
Cheap and simple models are not acceptable for text-heavy production.
Premium still images
Use for commercial stills, realistic product scenes, editorial photography, cinematic keyframes, and high-quality visual concepts.
- More realistic output:
openai/gpt-image-2. - High-quality styled output:
openai/gpt-image-2. - One step down:
fal-ai/nano-banana-pro. - Strong cheaper alternative:
fal-ai/nano-banana-2.
Fast draft images
Use for quick concepts, mood options, rough composition, and cheap iteration.
fal-ai/flux-2/klein/9b
Do not use fast draft output as final commercial delivery unless the user asks.
Image editing
Use for background replacement, relighting, cleanup, object changes, product placement, outfit changes, character edits, and multi-image composition.
fal-ai/nano-banana-pro/editopenai/gpt-image-2/editfal-ai/bytedance/seedream/v5/lite/edit
For product fidelity, also consider:
fal-ai/nano-banana-profal-ai/nano-banana-2fal-ai/bytedance/seedream/v5/lite/text-to-imagefal-ai/nano-banana-2/edit
For consistent characters, use openai/gpt-image-2 first. If editing an
existing character image, inspect openai/gpt-image-2/edit.
Video generation
Highest quality video
Use Seedance 2.0 first for final, high-quality video.
- Text to video:
bytedance/seedance-2.0/text-to-video - Image to video:
bytedance/seedance-2.0/image-to-video - Reference to video:
bytedance/seedance-2.0/reference-to-video
Fast variants exist for lower latency:
bytedance/seedance-2.0/fast/text-to-videobytedance/seedance-2.0/fast/image-to-videobytedance/seedance-2.0/fast/reference-to-video
Fast or lower-cost video
Use Grok Imagine Video for fast, lower-cost motion previews and economical video generation.
- Text to video:
xai/grok-imagine-video/text-to-video - Image to video:
xai/grok-imagine-video/image-to-video - Video edit:
xai/grok-imagine-video/edit-video
Multi-shot storytelling
Use in this order:
bytedance/seedance-2.0/text-to-videobytedance/seedance-2.0/image-to-videobytedance/seedance-2.0/reference-to-videofal-ai/kling-video/v3/pro/text-to-videofal-ai/kling-video/v3/pro/image-to-videoalibaba/happy-horse/text-to-videoalibaba/happy-horse/image-to-video
Use Kling v3 when its multi-prompt, element, or custom element controls match the requested shot plan. Use Happy Horse after Seedance and Kling unless the user specifically asks for it.
Native audio and lip-sync
Use for talking avatars, speech-driven face motion, product spokespersons, UGC-style presenters, and lip-sync from an image plus audio or text.
veed/fabric-1.0- Image plus uploaded audio.
veed/fabric-1.0/text- Image plus text speech.
fal-ai/creatify/aurora- Avatar video from image plus audio, with optional visual direction.
Campaign and UGC routing
Use these when the user asks for campaign-level marketing or creator-style social content.
Marketing campaign assets
- Campaign key art, landing heroes, posters, text-heavy ads, app visuals, and
exact-copy layouts:
openai/gpt-image-2atquality=high. - Premium still variants:
openai/gpt-image-2, thenfal-ai/nano-banana-pro, thenfal-ai/nano-banana-2. - Edits from product, logo, UI, or lifestyle references:
fal-ai/nano-banana-pro/edit, thenopenai/gpt-image-2/edit. - Fast variant exploration:
fal-ai/flux-2/klein/9b. - Product reveal or social campaign video:
bytedance/seedance-2.0/image-to-video. - Text-to-video campaign concept:
bytedance/seedance-2.0/text-to-video.
UGC and creator ads
- Portrait plus audio talking head:
veed/fabric-1.0. - Portrait plus text talking head:
veed/fabric-1.0/text. - Avatar with visual direction:
fal-ai/creatify/aurora. - Existing footage with new speech:
fal-ai/sync-lipsync/v2. - Product b-roll:
bytedance/seedance-2.0/image-to-video. - Fast b-roll draft:
xai/grok-imagine-video/image-to-video.
Utility endpoints
Workflow utility endpoint IDs live in the workflow skill reference:
workflow/references/utility-endpoints.md.
Utility endpoints are allowed to be explicit because they are deterministic tools, not creative model choices. Always inspect schema before use.