Select an existing conversion
AI input selection is server-side. It is independent of Filament and works with Studio’s existing external-variant contract. All sources are converted to a bounded, stripped temporary provider-compatible copy; persistent AVIF/WebP files and originals remain unchanged.auto: prefer the named ready conversion, otherwise applymissing.rendition: select the named current-version conversion; external projections are revalidated using their registered owner before use.original: prepare a temporary analysis copy from the current original under source byte/pixel limits. Never sends an unlimited original directly.provider: ask a registeredExternalVariantProviderfor the named conversion.
wait returns waiting_input; skip returns skipped_input. Neither fetches an
original or calls the paid provider when the selected conversion is missing.
temporary explicitly permits creating the analysis copy from the original.
Waiting is a persisted job result, not an automatic readiness subscription yet;
after conversion completion the host must explicitly rerun analysis. A cropped
conversion analyzes only the visible crop: choose an uncropped rendition if the
whole scene matters.
Spatie and custom conversion systems
UseFlex\MediaStudio\Renditions\ExternalVariantProvider.
It receives the authorized workspace, entry, immutable version and principal.
It must resolve the linked Spatie/custom record itself, check ownership and
conversion readiness, and return ExternalVariant objects. Each describes a
configured Laravel disk and relative object key, MIME, actual byte size and an
SHA-256 digest. Digest is mandatory for AI input even though ordinary display
variants allow it to be null. Prepare/store the digest when the conversion is
created; do not hash all source files on gallery requests.
This supports custom models/disks/conversion names without requiring every
uploader to use Studio’s converters. There is not yet a generic automatic
Spatie conversion adapter or automatic external FileUpload-to-Studio identity
registration. Analysis currently starts from a managed Studio entry; do not
represent an arbitrary storage path as an owned entry without an explicit host
integration. OCR will need its own input profile and is not connected yet.