Provider model refresh
For media production, first follow AGENT_GUIDE.md and the selected pipeline.
These adapters are discoverable through the normal BaseTool registry. Inspect
their input schema and status before making a request. An API credential indicates
configuration, not verified account entitlement. No paid live test is implied.
Routing
Use
to require an exact adapter and
to require
an API host.
remains a legacy ranking preference. Select an
exact
for images/video or
for speech. An unavailable exact
model must fail rather than silently substitute a different model.
| Model | Direct tool | Aggregator tools |
|---|
| GPT Image 2.5 Flare / Sunburst | openai_image | openai_fal_image, atlas_refresh_image |
| Gemini 3 Pro Image / Nano Banana Pro | google_imagen | gemini_fal_image, gemini_replicate_image, atlas_refresh_image |
| Ideogram 4.5 / Precise Edit | ideogram_image | ideogram_fal_image |
| Wan 3.0 | — | wan_fal_video, wan_atlas_video, wan_replicate_video |
| H3 Max | — | h3_max_video (fal) |
| LTX-2.5 Fast / Pro | ltx_api_video | — |
| Eleven v4 / v4 Turbo | elevenlabs_tts | fal_elevenlabs_tts (v4 only) |
| Gemini 3.8 Flash / Flash-Lite TTS | gemini_tts | — |
| Lyria 3.5 | google_music | — |
| Sonic 3.6 | cartesia_tts | — |
| Inworld TTS-2 / Flash | inworld_tts | — |
| Qwen Image 2.1 | qwen_image_21 (local) | — |
| HeyGen Avatar V | heygen_avatar | — |
Image requests
GPT Image 2.5 uses separate
and
IDs. Use Flare for speed and Sunburst for demanding
edits. Describe what changes and what must remain. Direct edits use local
/
and optional
. Keep alpha output in PNG or
WebP. The old GPT Image 2 default remains available for compatibility.
Google Pro's exact ID is
; it is distinct from
(Nano Banana 2). Use up to 14 reference images, and
1K/2K/4K on supported routes. Replicate fallback is disabled.
Ideogram direct
generation_mode=precise_edit
preserves unaffected pixels;
use
followed by up to four references in
. With a
mask, only three references are allowed. Black edits, white preserves. Precise
Edit cannot specify output size.
validates and prices the exact
request without generating. On fal,
sets
.
Qwen Image 2.1 requires the actual local model directory and compatible
Diffusers. It never downloads weights implicitly. Check the Qwen Research
License for the intended use. Transparent generation validates the returned
alpha channel rather than adding an opaque alpha channel.
Video and jobs
selects text_to_video, image_to_video or reference_to_video.
Replicate Wan supports text and first-frame image only. Wan on Atlas uses
objects and
for automatic length; fal uses reference URL
arrays and nullable duration. Do not transfer native parameters between hosts.
Pass route-specific controls in
; checked-in schemas under
tools/provider_contracts validate the complete request before submission.
LTX-2.5 supports text/image/audio generation, not retake or extend. Frame rates
are 24, 25, 48, 50; long durations require Fast at 720p/1080p and 24/25 FPS.
lets the model choose length, but cannot combine with a last
frame. H3 Max is separate from the older H3 endpoint.
Set
to persist a checkpoint. On timeout, pass the returned
to the same tool; this polls the existing job without a second
paid submission. A submission timeout without an ID is ambiguous: check the
provider dashboard before submitting again. Preserve provenance and outputs.
Unknown pricing is reported explicitly, never treated as a free service.
Speech and music
Direct Eleven IDs are
/
; fal uses
.
fal v4 accepts at most 5,000 characters and has no speed/style control.
Direct v4 accepts up to 10,000. Voice catalogs and rights differ by host.
Gemini TTS uses Interactions with speech annotations; configure each dialogue
speaker's voice and turn text separately. Its current adapter outputs WAV.
Cartesia uses API version 2026-08-14 and WAV. Inworld uses a portal-issued
Base64 credential with Basic auth, MP3, and at most 2,000 UTF-16 code units.
Lyria duration is a prompt target, not guaranteed exact timing.
Avatar V
Use
in the avatar-spokesperson pipeline. First
or
; generation checks
and
before POST. Avatar V is explicitly requested with
; it never falls back to IV. Provide exactly one of
(+
),
, or
. A reference look must
be a digital twin in the same verified group. Use an authorized existing
presenter and preserve HeyGen's consent/account requirements.
Evidence and limitations
Contracts were inspected 2026-10-03; each schema records its official source.
See docs/provider-update-plan-2026-10-03.md for release research. Public Kling 4
generation endpoints remain unverified, so do not invent a model ID. Live voice
agents require a separate streaming/session integration beyond batch narration.