provider-model-refresh

# 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 `preferred_tool` to require an exact adapter and `hosting_provider` to require an API host. `preferred_provider` remains a legacy ranking preference. Select an exact `model` for images/video or `model_id` 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 `gpt-image-2.5-flare` and `gpt-image-2.5-sunburst` IDs. Use Flare for speed and Sunburst for demanding edits. Describe what changes and what must remain. Direct edits use local `image_path`/`image_paths` and optional `mask_path`. Keep alpha output in PNG or WebP. The old GPT Image 2 default remains available for compatibility. Google Pro's exact ID is `gemini-3-pro-image`; it is distinct from `gemini-3.1-flash-image` (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 `image_path` followed by up to four references in `image_paths`. With a mask, only three references are allowed. Black edits, white preserves. Precise Edit cannot specify output size. `dry_run=true` validates and prices the exact request without generating. On fal, `precise_edit` sets `edit_precision=high`. 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 `operation` selects text_to_video, image_to_video or reference_to_video. Replicate Wan supports text and first-frame image only. Wan on Atlas uses `refers` objects and `duration=-1` for automatic length; fal uses reference URL arrays and nullable duration. Do not transfer native parameters between hosts. Pass route-specific controls in `provider_params`; 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. `duration=null` lets the model choose length, but cannot combine with a last frame. H3 Max is separate from the older H3 endpoint. Set `job_path` to persist a checkpoint. On timeout, pass the returned `resume_job` 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 `eleven_v4` / `eleven_v4_turbo`; fal uses `eleven-v4`. 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 `heygen_avatar` in the avatar-spokesperson pipeline. First `list_looks` or `inspect_look`; generation checks `avatar_type=digital_twin` and `supported_api_engines` before POST. Avatar V is explicitly requested with `engine=avatar_v`; it never falls back to IV. Provide exactly one of `script` (+ `voice_id`), `audio_url`, or `audio_asset_id`. 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.