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.
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.