0x0funky/agent-sprite-forge / skills/generate2dmedia
generate2dmedia
VerifiedThe art-route layer of the Forge skills. route_media.py is the one command that generates an image or an image-to-video clip - through the paid API of any provider whose key is configured (OpenAI, Google Gemini, xAI, BytePlus ModelArk, fal.ai; the configured key is the owner's consent), else through the user's own signed-in Codex or Grok CLI - and prints one JSON line with the route, artifact, sha256 and cost estimate; with no route it answers no-route (codeart2d is then the last resort). Also the capability check (forge_doctor), API key configuration, the spend ledger, resume and Codex image adoption. Use when a Forge skill sends a generation here, for the capability check, or when the user asks about keys, routes or spend. Not for planning, processing or QA of sprites, video frames or maps (generate2dsprite, video2dsprite, generate2dmap) or for code-drawn art (codeart2d).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.0 KB |
| agents/openai.yaml | config | 388 B |
| references/agent-profiles/README.md | markdown | 1.3 KB |
| references/agent-profiles/video-agent.md | markdown | 981 B |
| references/api-usage.md | markdown | 18.6 KB |
| references/capabilities.json | config | 32.9 KB |
| references/cli-routes.md | markdown | 15.3 KB |
| references/prices.json | config | 23.5 KB |
| references/provider-survey.md | markdown | 17.2 KB |
| references/route-media.md | markdown | 12.8 KB |
| references/schemas/common.schema.json | config | 12.9 KB |
| references/schemas/host.schema.json | config | 18.8 KB |
| references/schemas/media.schema.json | config | 22.5 KB |
| scripts/cli_media.py | script | 113.3 KB |
| scripts/forge_doctor.py | script | 74.5 KB |
| scripts/forge_index.py | script | 24.8 KB |
| scripts/generate_media.py | script | 72.1 KB |
| scripts/media_config.py | script | 9.1 KB |
| scripts/media_ledger.py | script | 29.8 KB |
| scripts/media_mp4.py | script | 9.4 KB |
| scripts/media_providers.py | script | 66.9 KB |
| scripts/route_media.py | script | 41.7 KB |
references/capabilities.json
View on GitHub{
"schema": "generate2dmedia.capabilities.v1",
"verifiedAt": "2026-10-06",
"notes": "One record per model id, checked against each vendor's official documentation on verifiedAt. No live call was made (the owner has no keys): request shapes follow the docs only, and the community reports real-world differences. Fields follow provider-survey.md: image {generate, edit (none|instruct|mask), refs_max, transparent_bg (none|native|i2i_only), sizes}; video {i2v, last_frame, durations {min, max, step} or {values}, resolutions, fps, aspect_1_1 (yes|follows_input|no), audio_off (true: a documented switch is sent; false or unverified: nothing is sent)}; async (sync|poll); cost_unit; optional url_ttl_s, loop, camera_static, watermark_default. generate_media.py refuses what a record does not allow; route_media.py skips (or, for a last frame, keyframes or a duration, adapts and notes) a route whose record cannot serve the request. Every clip is published without audio (media_mp4.py), whatever the provider sent.",
"retired": [
{"provider": "openai", "model": "gpt-image-1", "shutdown": "2026-10-23", "dropped": true, "use": "gpt-image-2.5-sunburst", "source": "https://developers.openai.com/api/docs/deprecations"},
{"provider": "openai", "model": "gpt-image-1.5", "shutdown": "2026-12-01", "use": "gpt-image-2.5-sunburst", "source": "https://developers.openai.com/api/docs/deprecations"},
{"provider": "openai", "model": "gpt-image-1-mini", "shutdown": "2026-12-01", "use": "gpt-image-2.5-sunburst", "source": "https://developers.openai.com/api/docs/deprecations"},
{"provider": "openai", "model": "chatgpt-image-latest", "shutdown": "2026-12-01", "use": "gpt-image-2.5-sunburst", "source": "https://developers.openai.com/api/docs/deprecations"},
{"provider": "openai", "model": "dall-e-3", "shutdown": "2026-05-12", "use": "gpt-image-2.5-sunburst", "source": "https://developers.openai.com/api/docs/deprecations"},
{"provider": "openai", "model": "dall-e-2", "shutdown": "2026-05-12", "use": "gpt-image-2.5-sunburst", "source": "https://developers.openai.com/api/docs/deprecations"},
{"provider": "openai", "model": "sora-2", "shutdown": "2026-09-24", "dropped": true, "use": "an image-to-video route of xai, byteplus or fal", "source": "https://developers.openai.com/api/docs/deprecations"},
{"provider": "gemini", "model": "gemini-2.5-flash-image", "shutdown": "2026-10-02", "use": "gemini-3.1-flash-image", "source": "https://ai.google.dev/gemini-api/docs/deprecations"},
{"provider": "gemini", "model": "gemini-3.1-flash-image-preview", "shutdown": "2026-06-25", "use": "gemini-3.1-flash-image", "source": "https://ai.google.dev/gemini-api/docs/deprecations"},
{"provider": "gemini", "model": "gemini-3-pro-image-preview", "shutdown": "2026-06-25", "use": "gemini-3-pro-image", "source": "https://ai.google.dev/gemini-api/docs/deprecations"},
{"provider": "gemini", "model": "imagen-4.0-generate-001", "shutdown": "2026-08-17", "use": "gemini-3.1-flash-image", "source": "https://ai.google.dev/gemini-api/docs/deprecations"},
{"provider": "gemini", "model": "imagen-4.0-ultra-generate-001", "shutdown": "2026-08-17", "use": "gemini-3-pro-image", "source": "https://ai.google.dev/gemini-api/docs/deprecations"},
{"provider": "gemini", "model": "imagen-4.0-fast-generate-001", "shutdown": "2026-08-17", "use": "gemini-3.1-flash-image", "source": "https://ai.google.dev/gemini-api/docs/deprecations"},
{"provider": "gemini", "model": "veo-3.1-generate-preview", "shutdown": "2026-10-22", "dropped": true, "use": "fal:fal-ai/veo3.1/first-last-frame-to-video", "source": "https://ai.google.dev/gemini-api/docs/deprecations"},
{"provider": "gemini", "model": "veo-3.1-fast-generate-preview", "shutdown": "2026-10-22", "dropped": true, "use": "fal:fal-ai/veo3.1/fast/first-last-frame-to-video", "source": "https://ai.google.dev/gemini-api/docs/deprecations"},
{"provider": "gemini", "model": "veo-3.1-lite-generate-preview", "shutdown": "2026-10-22", "dropped": true, "use": "an image-to-video route of xai, byteplus or fal", "source": "https://ai.google.dev/gemini-api/docs/deprecations"},
{"provider": "xai", "model": "grok-imagine-image-quality", "shutdown": "2026-11-02", "use": "grok-imagine-image-2.0 with --quality low", "source": "https://docs.x.ai/developers/migration/imagine-image-quality-nov-2"}
],
"providers": {
"openai": {
"label": "OpenAI API",
"keyEnv": ["OPENAI_API_KEY"],
"apiBase": "https://api.openai.com/v1",
"auth": "Authorization: Bearer <key>",
"kinds": ["image"],
"verifiedAt": "2026-10-06",
"docs": ["https://developers.openai.com/api/reference/resources/images", "https://developers.openai.com/api/docs/guides/image-generation", "https://developers.openai.com/api/docs/deprecations", "https://developers.openai.com/api/docs/pricing", "https://developers.openai.com/api/docs/guides/error-codes"],
"tiers": {"image": {"draft": {"model": "gpt-image-2.5-sunburst", "quality": "low"}, "standard": {"model": "gpt-image-2.5-sunburst"}, "hero": {"model": "gpt-image-2.5-sunburst", "quality": "high"}}},
"unknownModels": "image",
"models": {
"gpt-image-2.5-sunburst": {
"kind": "image", "verifiedAt": "2026-10-06", "docs": ["https://developers.openai.com/api/docs/models/gpt-image-2.5-sunburst"],
"image": {"generate": true, "edit": "mask", "refs_max": 16, "transparent_bg": "native", "sizes": ["auto", "WxH: both divisible by 16, aspect 1:3 to 3:1, 655,360 to 8,294,400 pixels, no edge above 3840"]},
"size_rule": {"multiple": 16, "max_edge": 3840, "min_pixels": 655360, "max_pixels": 8294400, "max_ratio": 3},
"qualities": ["auto", "low", "medium", "high", "xhigh", "max"],
"async": "sync", "cost_unit": "image"
},
"gpt-image-2.5-flare": {
"kind": "image", "verifiedAt": "2026-10-06", "docs": ["https://developers.openai.com/api/docs/models/gpt-image-2.5-flare"],
"image": {"generate": true, "edit": "mask", "refs_max": 16, "transparent_bg": "native", "sizes": ["auto", "WxH: both divisible by 16, aspect 1:3 to 3:1, 655,360 to 8,294,400 pixels, no edge above 3840"]},
"size_rule": {"multiple": 16, "max_edge": 3840, "min_pixels": 655360, "max_pixels": 8294400, "max_ratio": 3},
"qualities": ["auto", "low", "medium", "high", "xhigh", "max"],
"async": "sync", "cost_unit": "image"
},
"gpt-image-2": {
"kind": "image", "verifiedAt": "2026-10-06", "docs": ["https://developers.openai.com/api/docs/models/gpt-image-2"],
"image": {"generate": true, "edit": "mask", "refs_max": 16, "transparent_bg": "native", "sizes": ["auto", "WxH: both divisible by 16, aspect 1:3 to 3:1, 655,360 to 8,294,400 pixels, no edge above 3840"]},
"size_rule": {"multiple": 16, "max_edge": 3840, "min_pixels": 655360, "max_pixels": 8294400, "max_ratio": 3},
"qualities": ["auto", "low", "medium", "high"],
"note": "transparent backgrounds are in preview on gpt-image-2",
"async": "sync", "cost_unit": "image"
},
"gpt-image-1.5": {
"kind": "image", "verifiedAt": "2026-10-06", "docs": ["https://developers.openai.com/api/docs/models/gpt-image-1.5"],
"image": {"generate": true, "edit": "mask", "refs_max": 16, "transparent_bg": "native", "sizes": ["auto", "1024x1024", "1536x1024", "1024x1536"]},
"qualities": ["auto", "low", "medium", "high"],
"async": "sync", "cost_unit": "image"
},
"gpt-image-1-mini": {
"kind": "image", "verifiedAt": "2026-10-06", "docs": ["https://developers.openai.com/api/docs/models/gpt-image-1-mini"],
"image": {"generate": true, "edit": "mask", "refs_max": 16, "transparent_bg": "native", "sizes": ["auto", "1024x1024", "1536x1024", "1024x1536"]},
"qualities": ["auto", "low", "medium", "high"],
"async": "sync", "cost_unit": "image"
}
}
},
"gemini": {
"label": "Google Gemini API",
"keyEnv": ["GOOGLE_API_KEY", "GEMINI_API_KEY"],
"apiBase": "https://generativelanguage.googleapis.com/v1beta",
"auth": "x-goog-api-key: <key> (GOOGLE_API_KEY wins when both are set)",
"kinds": ["image"],
"verifiedAt": "2026-10-06",
"docs": ["https://ai.google.dev/gemini-api/docs/generate-content/image-generation", "https://ai.google.dev/api/generate-content", "https://ai.google.dev/gemini-api/docs/api-key", "https://ai.google.dev/gemini-api/docs/generate-content/api-errors", "https://ai.google.dev/gemini-api/docs/pricing", "https://ai.google.dev/gemini-api/docs/deprecations"],
"tiers": {"image": {"draft": {"model": "gemini-3.1-flash-lite-image"}, "standard": {"model": "gemini-3.1-flash-image"}, "hero": {"model": "gemini-3-pro-image"}}},
"unknownModels": "image",
"models": {
"gemini-3.1-flash-image": {
"kind": "image", "verifiedAt": "2026-10-06", "docs": ["https://ai.google.dev/gemini-api/docs/models/gemini-3.1-flash-image"],
"image": {"generate": true, "edit": "instruct", "refs_max": 14, "transparent_bg": "none", "sizes": ["512", "1K", "2K", "4K"]},
"refs_note": "up to 10 object images and 4 character images",
"image_sizes": ["512", "1K", "2K", "4K"],
"aspect_ratios": ["1:1", "1:4", "4:1", "1:8", "8:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9"],
"watermark_default": "SynthID",
"async": "sync", "cost_unit": "image"
},
"gemini-3-pro-image": {
"kind": "image", "verifiedAt": "2026-10-06", "docs": ["https://ai.google.dev/gemini-api/docs/models/gemini-3-pro-image"],
"image": {"generate": true, "edit": "instruct", "refs_max": 14, "transparent_bg": "none", "sizes": ["1K", "2K", "4K"]},
"refs_note": "up to 6 object, 5 character and 3 style images",
"image_sizes": ["1K", "2K", "4K"],
"aspect_ratios": ["1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9"],
"watermark_default": "SynthID",
"async": "sync", "cost_unit": "image"
},
"gemini-3.1-flash-lite-image": {
"kind": "image", "verifiedAt": "2026-10-06", "docs": ["https://ai.google.dev/gemini-api/docs/models/gemini-3.1-flash-lite-image"],
"image": {"generate": true, "edit": "instruct", "refs_max": 14, "transparent_bg": "none", "sizes": ["1K"]},
"refs_note": "not optimised for several references",
"image_sizes": ["1K"],
"aspect_ratios": ["1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9"],
"watermark_default": "SynthID and C2PA",
"async": "sync", "cost_unit": "image"
}
}
},
"xai": {
"label": "xAI API",
"keyEnv": ["XAI_API_KEY"],
"apiBase": "https://api.x.ai/v1",
"auth": "Authorization: Bearer <key>",
"kinds": ["image", "video"],
"verifiedAt": "2026-10-06",
"docs": ["https://docs.x.ai/developers/model-capabilities/video/generation", "https://docs.x.ai/developers/model-capabilities/video/reference-to-video", "https://docs.x.ai/developers/model-capabilities/images/generation", "https://docs.x.ai/developers/model-capabilities/images/multi-image-editing", "https://docs.x.ai/developers/rest-api-reference/inference/videos", "https://docs.x.ai/developers/pricing", "https://docs.x.ai/developers/debugging"],
"tiers": {"image": {"draft": {"model": "grok-imagine-image-2.0", "quality": "low"}, "standard": {"model": "grok-imagine-image-2.0"}, "hero": {"model": "grok-imagine-image-2.0", "quality": "medium"}},
"video": {"draft": {"model": "grok-imagine-video-1.5-lite"}, "standard": {"model": "grok-imagine-video-1.5"}, "hero": {"model": "grok-imagine-video-1.5"}}},
"unknownModels": "image",
"models": {
"grok-imagine-image-2.0": {
"kind": "image", "verifiedAt": "2026-10-06", "docs": ["https://docs.x.ai/developers/models/grok-imagine-image-2.0"],
"image": {"generate": true, "edit": "instruct", "refs_max": 5, "transparent_bg": "none", "sizes": ["1k", "1.5k", "2k"]},
"resolutions": ["1k", "1.5k", "2k"],
"aspect_ratios": ["1:1", "3:4", "4:3", "9:16", "16:9", "2:3", "3:2", "9:19.5", "19.5:9", "9:20", "20:9", "1:2", "2:1", "21:9", "5:2", "auto"],
"qualities": ["auto", "low", "medium"],
"url_ttl_s": null,
"async": "sync", "cost_unit": "image"
},
"grok-imagine-image": {
"kind": "image", "verifiedAt": "2026-10-06", "docs": ["https://docs.x.ai/developers/models/grok-imagine-image"],
"image": {"generate": true, "edit": "instruct", "refs_max": 1, "transparent_bg": "none", "sizes": ["1k", "2k"]},
"resolutions": ["1k", "2k"],
"aspect_ratios": ["1:1", "3:4", "4:3", "9:16", "16:9", "2:3", "3:2", "auto"],
"qualities": [],
"async": "sync", "cost_unit": "image"
},
"grok-imagine-video-1.5": {
"kind": "video", "verifiedAt": "2026-10-06", "docs": ["https://docs.x.ai/developers/models/grok-imagine-video-1.5", "https://docs.x.ai/developers/model-capabilities/video/reference-to-video"],
"video": {"i2v": true, "last_frame": true, "durations": {"min": 1, "max": 15, "step": 1}, "resolutions": ["480p", "720p", "1080p"], "fps": 24, "aspect_1_1": "follows_input", "audio_off": true},
"pin_resolutions": ["480p", "720p"],
"keyframes_max": 4,
"url_ttl_s": "temporary (minutes; download at once)",
"async": "poll", "cost_unit": "second"
},
"grok-imagine-video-1.5-lite": {
"kind": "video", "verifiedAt": "2026-10-06", "docs": ["https://docs.x.ai/developers/models/grok-imagine-video-1.5-lite"],
"video": {"i2v": true, "last_frame": false, "durations": {"min": 1, "max": 15, "step": 1}, "resolutions": ["480p", "720p", "1080p"], "fps": 24, "aspect_1_1": "follows_input", "audio_off": "unverified"},
"keyframes_max": 0,
"note": "the draft model: last_frame, keyframes and generate_audio are not documented for it, so none is sent",
"url_ttl_s": "temporary (minutes; download at once)",
"async": "poll", "cost_unit": "second"
},
"grok-imagine-video": {
"kind": "video", "verifiedAt": "2026-10-06", "docs": ["https://docs.x.ai/developers/models/grok-imagine-video"],
"video": {"i2v": true, "last_frame": false, "durations": {"min": 1, "max": 15, "step": 1}, "resolutions": ["480p", "720p"], "fps": 24, "aspect_1_1": "follows_input", "audio_off": "unverified"},
"keyframes_max": 0,
"note": "classic model: rejects last_frame and keyframes",
"async": "poll", "cost_unit": "second"
}
}
},
"byteplus": {
"label": "BytePlus ModelArk API",
"keyEnv": ["ARK_API_KEY"],
"apiBase": "https://ark.ap-southeast.bytepluses.com/api/v3",
"auth": "Authorization: Bearer <key>",
"kinds": ["image", "video"],
"verifiedAt": "2026-10-06",
"docs": ["https://docs.byteplus.com/en/docs/ModelArk/1541523", "https://docs.byteplus.com/en/docs/ModelArk/1520757", "https://docs.byteplus.com/en/docs/ModelArk/1521309", "https://docs.byteplus.com/en/docs/ModelArk/1330310", "https://docs.byteplus.com/en/docs/ModelArk/1544106", "https://docs.byteplus.com/en/docs/ModelArk/1299023"],
"tiers": {"image": {"draft": {"model": "dola-seedream-5-0-flash-260915"}, "standard": {"model": "dola-seedream-5-0-pro-260628"}, "hero": {"model": "dola-seedream-5-0-pro-260628"}},
"video": {"draft": {"model": "dreamina-seedance-2-0-mini-260615"}, "standard": {"model": "dreamina-seedance-2-0-260128"}, "hero": {"model": "dreamina-seedance-2-5-260628"}}},
"unknownModels": "none",
"models": {
"dola-seedream-5-0-pro-260628": {
"kind": "image", "verifiedAt": "2026-10-06", "docs": ["https://docs.byteplus.com/en/docs/modelark/seedream-5-0-pro"],
"image": {"generate": true, "edit": "instruct", "refs_max": 10, "transparent_bg": "i2i_only", "sizes": ["1K", "1.5K", "2K", "WxH: 921,600 to 4,624,220 pixels, aspect 1:16 to 16:1"]},
"pixel_range": [921600, 4624220],
"watermark_default": true,
"url_ttl_s": 86400,
"async": "sync", "cost_unit": "image"
},
"dola-seedream-5-0-flash-260915": {
"kind": "image", "verifiedAt": "2026-10-06", "docs": ["https://docs.byteplus.com/en/docs/ModelArk/1541523"],
"image": {"generate": true, "edit": "instruct", "refs_max": 10, "transparent_bg": "i2i_only", "sizes": ["1K", "1.5K", "2K", "WxH: 921,600 to 4,624,220 pixels, aspect 1:16 to 16:1"]},
"pixel_range": [921600, 4624220],
"watermark_default": true,
"url_ttl_s": 86400,
"async": "sync", "cost_unit": "image"
},
"dreamina-seedance-2-0-260128": {
"kind": "video", "verifiedAt": "2026-10-06", "docs": ["https://docs.byteplus.com/en/docs/modelark/seedance-2-0", "https://docs.byteplus.com/en/docs/ModelArk/1520757"],
"video": {"i2v": true, "last_frame": true, "durations": {"min": 4, "max": 15, "step": 1}, "resolutions": ["480p", "720p", "1080p"], "fps": 24, "aspect_1_1": "yes", "audio_off": true},
"ratios": ["16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "adaptive"],
"input_px": [300, 6000], "input_aspect": [0.4, 2.5],
"watermark_default": false,
"faces": "real human faces in inputs are refused",
"url_ttl_s": 86400,
"async": "poll", "cost_unit": "second"
},
"dreamina-seedance-2-0-mini-260615": {
"kind": "video", "verifiedAt": "2026-10-06", "docs": ["https://docs.byteplus.com/en/docs/modelark/seedance-2-0", "https://docs.byteplus.com/en/docs/ModelArk/1520757"],
"video": {"i2v": true, "last_frame": true, "durations": {"min": 4, "max": 15, "step": 1}, "resolutions": ["480p", "720p"], "fps": 24, "aspect_1_1": "yes", "audio_off": true},
"ratios": ["16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "adaptive"],
"input_px": [300, 6000], "input_aspect": [0.4, 2.5],
"watermark_default": false,
"faces": "real human faces in inputs are refused",
"url_ttl_s": 86400,
"async": "poll", "cost_unit": "second"
},
"dreamina-seedance-2-0-fast-260128": {
"kind": "video", "verifiedAt": "2026-10-06", "docs": ["https://docs.byteplus.com/en/docs/ModelArk/1520757"],
"video": {"i2v": true, "last_frame": true, "durations": {"min": 4, "max": 15, "step": 1}, "resolutions": ["480p", "720p"], "fps": 24, "aspect_1_1": "yes", "audio_off": true},
"ratios": ["16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "adaptive"],
"input_px": [300, 6000], "input_aspect": [0.4, 2.5],
"watermark_default": false,
"url_ttl_s": 86400,
"async": "poll", "cost_unit": "second"
},
"dreamina-seedance-2-5-260628": {
"kind": "video", "verifiedAt": "2026-10-06", "docs": ["https://docs.byteplus.com/en/docs/ModelArk/2607688", "https://docs.byteplus.com/en/docs/ModelArk/1520757"],
"video": {"i2v": true, "last_frame": true, "durations": {"min": 4, "max": 30, "step": 1}, "resolutions": ["480p", "720p", "1080p"], "fps": 24, "aspect_1_1": "follows_input", "audio_off": true},
"ratios": ["adaptive"],
"input_px": [300, 6000], "input_aspect": [0.4, 2.5],
"watermark_default": false,
"faces": "real human faces in inputs are refused",
"url_ttl_s": 86400,
"async": "poll", "cost_unit": "second"
}
}
},
"fal": {
"label": "fal.ai API",
"keyEnv": ["FAL_KEY"],
"apiBase": "https://queue.fal.run",
"auth": "Authorization: Key <key>",
"kinds": ["image", "video"],
"verifiedAt": "2026-10-06",
"docs": ["https://fal.ai/docs/model-apis/model-endpoints/queue", "https://fal.ai/docs/documentation/model-apis/errors.md", "https://fal.ai/docs/documentation/model-apis/media-expiration", "https://fal.ai/docs/documentation/setting-up/authentication.md", "https://github.com/fal-ai/fal/blob/main/projects/fal_client/src/fal_client/client.py"],
"uploads": "inputs go to the fal CDN first, as the official fal_client does (POST https://rest.fal.ai/storage/auth/token?storage_type=fal-cdn-v3, then POST https://v3.fal.media/files/upload): free requests made before the paid one; --provider-option fal_upload=data sends data URIs instead",
"tiers": {"image": {"draft": {"model": "fal-ai/nano-banana-2/edit"}, "standard": {"model": "fal-ai/nano-banana-2/edit"}, "hero": {"model": "fal-ai/nano-banana-pro/edit"}},
"video": {"draft": {"model": "alibaba/wan-3.0/image-to-video"}, "standard": {"model": "fal-ai/kling-video/v3/pro/image-to-video"}, "hero": {"model": "fal-ai/kling-video/v3/pro/image-to-video"}}},
"unknownModels": "none",
"models": {
"fal-ai/veo3.1/first-last-frame-to-video": {
"kind": "video", "verifiedAt": "2026-10-06", "docs": ["https://fal.ai/models/fal-ai/veo3.1/first-last-frame-to-video/api"],
"video": {"i2v": true, "last_frame": true, "durations": {"values": [4, 6, 8]}, "resolutions": ["720p", "1080p"], "fps": 24, "aspect_1_1": "no", "audio_off": true},
"fal": {"first": "first_frame_url", "last": "last_frame_url", "last_required": true, "duration": {"field": "duration", "format": "s"},
"resolution": {"field": "resolution", "map": {"720p": "720p", "1080p": "1080p"}}, "aspect": {"field": "aspect_ratio", "pad": "16:9"},
"audio": {"field": "generate_audio", "off": false}},
"note": "Google Veo 3.1 (first and last frame). 16:9 or 9:16 only: ASF pads the frames onto a 16:9 key-colour canvas and job.json records the crop back. safety_tolerance (\"1\" to \"6\") passes through --provider-option",
"url_ttl_s": 604800, "async": "poll", "cost_unit": "second"
},
"fal-ai/veo3.1/fast/first-last-frame-to-video": {
"kind": "video", "verifiedAt": "2026-10-06", "docs": ["https://fal.ai/models/fal-ai/veo3.1/fast/first-last-frame-to-video/api"],
"video": {"i2v": true, "last_frame": true, "durations": {"values": [4, 6, 8]}, "resolutions": ["720p", "1080p"], "fps": 24, "aspect_1_1": "no", "audio_off": true},
"fal": {"first": "first_frame_url", "last": "last_frame_url", "last_required": true, "duration": {"field": "duration", "format": "s"},
"resolution": {"field": "resolution", "map": {"720p": "720p", "1080p": "1080p"}}, "aspect": {"field": "aspect_ratio", "pad": "16:9"},
"audio": {"field": "generate_audio", "off": false}},
"note": "Veo 3.1 Fast; padded to 16:9 like the standard model",
"url_ttl_s": 604800, "async": "poll", "cost_unit": "second"
},
"fal-ai/kling-video/v3/pro/image-to-video": {
"kind": "video", "verifiedAt": "2026-10-06", "docs": ["https://fal.ai/models/fal-ai/kling-video/v3/pro/image-to-video/api"],
"video": {"i2v": true, "last_frame": true, "durations": {"min": 3, "max": 15, "step": 1}, "resolutions": "any", "fps": null, "aspect_1_1": "follows_input", "audio_off": true},
"input_px": [300, 8192], "input_aspect": [0.4, 2.5],
"fal": {"first": "start_image_url", "last": "end_image_url", "duration": {"field": "duration", "format": "str"},
"audio": {"field": "generate_audio", "off": false}},
"note": "Kling 3.0 Pro: the end frame is end_image_url (Kling's own API calls it image_tail); the aspect follows the start image",
"url_ttl_s": 604800, "async": "poll", "cost_unit": "second"
},
"fal-ai/kling-video/v3/standard/image-to-video": {
"kind": "video", "verifiedAt": "2026-10-06", "docs": ["https://fal.ai/models/fal-ai/kling-video/v3/standard/image-to-video/api"],
"video": {"i2v": true, "last_frame": true, "durations": {"min": 3, "max": 15, "step": 1}, "resolutions": "any", "fps": null, "aspect_1_1": "follows_input", "audio_off": true},
"input_px": [300, 8192], "input_aspect": [0.4, 2.5],
"fal": {"first": "start_image_url", "last": "end_image_url", "duration": {"field": "duration", "format": "str"},
"audio": {"field": "generate_audio", "off": false}},
"url_ttl_s": 604800, "async": "poll", "cost_unit": "second"
},
"luma/agent/ray/v3.2/image-to-video": {
"kind": "video", "verifiedAt": "2026-10-06", "docs": ["https://fal.ai/models/luma/agent/ray/v3.2/image-to-video/api"],
"video": {"i2v": true, "last_frame": true, "durations": {"values": [5]}, "resolutions": ["480p", "720p", "1080p"], "fps": 24, "aspect_1_1": "yes", "audio_off": "none"},
"loop": true,
"fal": {"first": "image_url", "last": "end_image_url", "loop": "loop", "duration": {"field": "duration", "format": "s"},
"resolution": {"field": "resolution", "map": {"480p": "540p", "720p": "720p", "1080p": "1080p"}},
"aspect": {"field": "aspect_ratio", "values": ["3:4", "4:3", "1:1", "9:16", "16:9", "21:9"]}},
"note": "Luma Ray 3.2: a last frame identical to the first is sent as loop: true (the model's own loop); 5 s with a start image",
"url_ttl_s": 604800, "async": "poll", "cost_unit": "second"
},
"minimax/h3/image-to-video": {
"kind": "video", "verifiedAt": "2026-10-06", "docs": ["https://fal.ai/models/minimax/h3/image-to-video/api"],
"video": {"i2v": true, "last_frame": true, "durations": {"min": 5, "max": 15, "step": 1}, "resolutions": ["480p", "720p", "1080p"], "fps": 24, "aspect_1_1": "follows_input", "audio_off": "none"},
"fal": {"first": "image_url", "last": "end_image_url", "duration": {"field": "duration", "format": "int"},
"resolution": {"field": "resolution", "map": {"480p": "480P", "720p": "768P", "1080p": "2K"}},
"fixed": {"prompt_expansion_mode": "disabled"}},
"note": "MiniMax H3: 768P for a 720p request; 2K is an upscale of 768P; prompt expansion is off so the prompt is used as written",
"url_ttl_s": 604800, "async": "poll", "cost_unit": "second"
},
"alibaba/wan-3.0/image-to-video": {
"kind": "video", "verifiedAt": "2026-10-06", "docs": ["https://fal.ai/models/alibaba/wan-3.0/image-to-video/api"],
"video": {"i2v": true, "last_frame": true, "durations": {"min": 2, "max": 15, "step": 1}, "resolutions": ["480p", "720p", "1080p"], "fps": null, "aspect_1_1": "yes", "audio_off": true},
"fal": {"first": "start_image_url", "last": "end_image_url", "duration": {"field": "duration", "format": "int"},
"resolution": {"field": "resolution", "map": {"480p": "480p", "720p": "720p", "1080p": "1080p"}},
"aspect": {"field": "aspect_ratio", "values": ["16:9", "4:3", "1:1", "3:4", "9:16"], "default": "adaptive"},
"audio": {"field": "audio", "off": false}, "fixed": {"enable_prompt_expansion": false}},
"note": "Wan 3.0 (a preview model); prompt expansion is off",
"url_ttl_s": 604800, "async": "poll", "cost_unit": "second"
},
"fal-ai/vidu/q3/image-to-video": {
"kind": "video", "verifiedAt": "2026-10-06", "docs": ["https://fal.ai/models/fal-ai/vidu/q3/image-to-video/api"],
"video": {"i2v": true, "last_frame": true, "durations": {"min": 1, "max": 15, "step": 1}, "resolutions": ["480p", "720p", "1080p"], "fps": 24, "aspect_1_1": "follows_input", "audio_off": true},
"fal": {"first": "image_url", "last": "end_image_url", "duration": {"field": "duration", "format": "int"},
"resolution": {"field": "resolution", "map": {"480p": "540p", "720p": "720p", "1080p": "1080p"}},
"audio": {"field": "audio", "off": false}},
"note": "Vidu Q3: the start-end endpoint is gone; the end frame is end_image_url here. Vidu may cut between shots: check the clip",
"url_ttl_s": 604800, "async": "poll", "cost_unit": "second"
},
"lightricks/ltx-2.5/image-to-video/pro": {
"kind": "video", "verifiedAt": "2026-10-06", "docs": ["https://fal.ai/models/lightricks/ltx-2.5/image-to-video/pro/api"],
"video": {"i2v": true, "last_frame": true, "durations": {"values": [6, 8, 10]}, "resolutions": ["720p", "1080p"], "fps": 24, "aspect_1_1": "no", "audio_off": true},
"camera_static": true,
"fal": {"first": "image_url", "last": "end_image_url", "duration": {"field": "duration", "format": "int"},
"resolution": {"field": "resolution", "map": {"720p": "720p", "1080p": "1080p"}}, "aspect": {"field": "aspect_ratio", "pad": "16:9"},
"audio": {"field": "generate_audio", "off": false}, "fixed": {"camera_motion": "static", "fps": 24}},
"note": "LTX-2.5 Pro: camera_motion static is always sent; 16:9 only, so the frames are padded and the crop recorded",
"url_ttl_s": 604800, "async": "poll", "cost_unit": "second"
},
"lightricks/ltx-2.5/image-to-video/fast": {
"kind": "video", "verifiedAt": "2026-10-06", "docs": ["https://fal.ai/models/lightricks/ltx-2.5/image-to-video/fast/api"],
"video": {"i2v": true, "last_frame": true, "durations": {"values": [6, 8, 10, 12, 14]}, "resolutions": ["720p", "1080p"], "fps": 24, "aspect_1_1": "no", "audio_off": true},
"camera_static": true,
"fal": {"first": "image_url", "last": "end_image_url", "duration": {"field": "duration", "format": "int"},
"resolution": {"field": "resolution", "map": {"720p": "720p", "1080p": "1080p"}}, "aspect": {"field": "aspect_ratio", "pad": "16:9"},
"audio": {"field": "generate_audio", "off": false}, "fixed": {"camera_motion": "static", "fps": 24}},
"note": "LTX-2.5 Fast: clips over 10 s need 720p or 1080p at 24 or 25 fps",
"url_ttl_s": 604800, "async": "poll", "cost_unit": "second"
},
"fal-ai/nano-banana-2/edit": {
"kind": "image", "verifiedAt": "2026-10-06", "docs": ["https://fal.ai/models/fal-ai/nano-banana-2/edit/api"],
"image": {"generate": false, "edit": "instruct", "refs_max": 14, "transparent_bg": "none", "sizes": ["0.5K", "1K", "2K", "4K"]},
"fal": {"refs": "image_urls", "refs_min": 1,
"size": {"kind": "aspect_resolution", "aspect_field": "aspect_ratio", "aspects": ["21:9", "16:9", "3:2", "4:3", "5:4", "1:1", "4:5", "3:4", "2:3", "9:16", "4:1", "1:4", "8:1", "1:8"],
"resolution_field": "resolution", "resolutions": {"0.5K": 512, "1K": 1024, "2K": 2048, "4K": 4096}, "default": "1K"},
"fixed": {"num_images": 1, "output_format": "png"}},
"note": "Gemini 3.1 Flash Image on fal.ai (reference edits only)",
"url_ttl_s": 604800, "async": "poll", "cost_unit": "image"
},
"fal-ai/nano-banana-pro/edit": {
"kind": "image", "verifiedAt": "2026-10-06", "docs": ["https://fal.ai/models/fal-ai/nano-banana-pro/edit/api"],
"image": {"generate": false, "edit": "instruct", "refs_max": 14, "transparent_bg": "none", "sizes": ["1K", "2K", "4K"]},
"fal": {"refs": "image_urls", "refs_min": 1,
"size": {"kind": "aspect_resolution", "aspect_field": "aspect_ratio", "aspects": ["21:9", "16:9", "3:2", "4:3", "5:4", "1:1", "4:5", "3:4", "2:3", "9:16"],
"resolution_field": "resolution", "resolutions": {"1K": 1024, "2K": 2048, "4K": 4096}, "default": "1K"},
"fixed": {"num_images": 1, "output_format": "png"}},
"note": "Gemini 3 Pro Image on fal.ai (reference edits only)",
"url_ttl_s": 604800, "async": "poll", "cost_unit": "image"
},
"bytedance/seedream/v5/pro/edit": {
"kind": "image", "verifiedAt": "2026-10-06", "docs": ["https://fal.ai/models/bytedance/seedream/v5/pro/edit/api"],
"image": {"generate": false, "edit": "instruct", "refs_max": 10, "transparent_bg": "none", "sizes": ["WxH up to 2048x2048"]},
"fal": {"refs": "image_urls", "refs_min": 1, "size": {"kind": "width_height", "field": "image_size"},
"price_tiers": {"up-to-1536": 2359296, "up-to-2048": 4194304}, "extra_inputs_priced": true,
"fixed": {"num_images": 1, "output_format": "png"}},
"note": "Seedream 5.0 Pro on fal.ai (reference edits only)",
"url_ttl_s": 604800, "async": "poll", "cost_unit": "image"
},
"openai/gpt-image-2/edit": {
"kind": "image", "verifiedAt": "2026-10-06", "docs": ["https://fal.ai/models/openai/gpt-image-2/edit/api"],
"image": {"generate": false, "edit": "mask", "refs_max": 16, "transparent_bg": "native", "sizes": ["auto", "WxH"]},
"fal": {"refs": "image_urls", "refs_min": 1, "size": {"kind": "width_height", "field": "image_size"},
"quality": "quality", "quality_default": "high", "background": "background",
"fixed": {"num_images": 1, "output_format": "png"}},
"note": "GPT Image 2 on fal.ai (reference edits only); quality defaults to high as on fal.ai",
"url_ttl_s": 604800, "async": "poll", "cost_unit": "image"
}
}
}
}
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |