Free (requires an active plan). Upload one reference image and get a `reference_id` to reuse:
a product photo, a character, a brand shot. Give exactly one of image_base64 or file_path.
image_base64 - the image bytes as base64 (a `data:image/png;base64,...` URL is also accepted);
this is the way for any remote agent, because the image never has to be public.
file_path - a path on the FILESYSTEM OF THE MCP SERVER, so it only works for local / self-hosted
runs where the server and the agent are on the same machine, and only when the server enables it
(otherwise the tool answers with code local_files_disabled - then send image_base64 instead).
Formats jpeg, png, webp, heic, up to 10 MB, shorter side at least 360 px, longer at most 4096 px.
Bad input comes back as validation_error with details.reason, before anything is uploaded:
one_source_required (gave both or neither), bad_base64, empty, not_image, too_small,
too_large_dimensions, too_large; a file_path that cannot be read is file_not_readable, and a
server that forbids local files answers with code local_files_disabled.
label - a short note (e.g. "hero", "product"), optional, kept to the first 120 characters.
Returns reference_id, the stored url, the label and a model-written description. The reference
expires together with scenarios (the server's scenario TTL, 7 days by default), so upload it
again for a later video. Pass the returned reference_id in `reference_urls` of
tegas_write_scenario or tegas_start_video - no public link needed.
Errors: no_active_plan -> ask the user to activate a plan in the cabinet.
