io.enterpriseai.resources.MediaClient

Source : sdks/java/enterprise-ai-java/src/main/java/io/enterpriseai/resources/MediaClient.java. Retour à l'index de la référence du SDK Java.

remarque

Cette page est générée par tools/docs/gen_sdk_reference.py depuis les sources du SDK et les dossiers de textes OpenAPI. Ne la modifiez pas à la main : changez la source et régénérez.

Classe MediaClient

Multimodal. Médias et traitement multimodal : stockage chiffré de médias et travaux de vision, génération et retouche d'images, traitement et génération de vidéos, transcription de la parole, diarisation, synthèse vocale et DLP multimodale.

Constructeur MediaClient

MediaClient(Transport transport)

Crée le client sur le transport partagé ; EnterpriseAIClient le construit, on y accède par l'accesseur du même nom.

Nom	Type	Défaut	Requis	Description
transport	Transport		oui	Transport partagé par les sous-clients d'un même client.

MediaClient.delete

void delete(String id)

Supprimer un média. Supprime le média et son contenu stocké. Permis pour son créateur, tenant_admin ou security_officer (403 forbidden). Un média sous conservation légale répond 409 legal_hold. Audité sous media.delete.

Route : /v1/media/{media_id} (DELETE).

Nom	Type	Défaut	Requis	Description
id	String		oui	Identifiant (UUID) du média.

Retour : void.

Erreurs levées : les erreurs typées du transport (Erreurs).

MediaClient.get

JsonNode get(String id)

Lire un média. Renvoie le document Multimodal Contract du média. Avec include_content=true, la réponse est {media, content_base64} avec le contenu déchiffré ; cela demande une habilitation au moins égale à la classification du média (403 policy_denied) et est audité sous media.read.

Route : /v1/media/{media_id} (GET).

Nom	Type	Défaut	Requis	Description
id	String		oui	Identifiant (UUID) du média.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lire un média ».

Erreurs levées : les erreurs typées du transport (Erreurs).

MediaClient.get

JsonNode get(String id, Map<String, ?> query)

Lire un média. Renvoie le document Multimodal Contract du média. Avec include_content=true, la réponse est {media, content_base64} avec le contenu déchiffré ; cela demande une habilitation au moins égale à la classification du média (403 policy_denied) et est audité sous media.read.

Route : /v1/media/{media_id} (GET).

Nom	Type	Défaut	Requis	Description
id	String		oui	Identifiant (UUID) du média.
query	Map<String, ?>		oui	Paramètres de la chaîne de requête de la route.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lire un média ».

Erreurs levées : les erreurs typées du transport (Erreurs).

MediaClient.list

io.enterpriseai.Page<JsonNode> list(Map<String, ?> query)

Lister les médias. Médias du tenant (documents Multimodal Contract), paginés par clé avec cursor, filtrés par media_type et classification (400 invalid_request pour une valeur inconnue).

Route : /v1/media (GET).

Nom	Type	Défaut	Requis	Description
query	Map<String, ?>		oui	Paramètres de la chaîne de requête de la route.

Retour : io.enterpriseai.Page<JsonNode>. Réponse JSON décodée de l'opération « Lister les médias ».

Erreurs levées : les erreurs typées du transport (Erreurs).

MediaClient.upload

JsonNode upload(Object body)

Téléverser un média. Enregistre un média (201) à partir de JSON {content_base64, mime_type, filename?, operation?, dlp_mode?, retention_days?, classification?} ou de multipart/form-data avec une partie file et les mêmes champs. Tout principal du tenant peut l'appeler. Étapes : 1. Taille contrôlée par rapport au maximum de la plateforme (50 Mio sauf configuration ; 413 media_too_large). 2. Analyse du fichier par ClamAV et YARA-X (422 file_blocked, 503 file_scan_unavailable). 3. Extraction du texte et DLP avec dlp_mode (detect par défaut ; block répond 422 dlp_blocked quand des données personnelles sont trouvées) ; la classification est relevée en conséquence. 4. Le contenu est chiffré avec une clé du tenant et enregistré. Renvoie le document Multimodal Contract.

Route : /v1/media (POST).

Nom	Type	Défaut	Requis	Description
body	Object		oui	Le fichier (JSON avec contenu en base64, ou multipart avec une partie file) et ses options : operation à laquelle le média est destiné, dlp_mode (detect, mask, tokenize, block), retention_days (0 ou plus), classification.

Retour : JsonNode. Réponse JSON décodée de l'opération « Téléverser un média ».

Erreurs levées : les erreurs typées du transport (Erreurs).

MediaClient.upload

JsonNode upload(Object body, RequestOptions options)

Téléverser un média. Enregistre un média (201) à partir de JSON {content_base64, mime_type, filename?, operation?, dlp_mode?, retention_days?, classification?} ou de multipart/form-data avec une partie file et les mêmes champs. Tout principal du tenant peut l'appeler. Étapes : 1. Taille contrôlée par rapport au maximum de la plateforme (50 Mio sauf configuration ; 413 media_too_large). 2. Analyse du fichier par ClamAV et YARA-X (422 file_blocked, 503 file_scan_unavailable). 3. Extraction du texte et DLP avec dlp_mode (detect par défaut ; block répond 422 dlp_blocked quand des données personnelles sont trouvées) ; la classification est relevée en conséquence. 4. Le contenu est chiffré avec une clé du tenant et enregistré. Renvoie le document Multimodal Contract.

Route : /v1/media (POST).

Nom	Type	Défaut	Requis	Description
body	Object		oui	Le fichier (JSON avec contenu en base64, ou multipart avec une partie file) et ses options : operation à laquelle le média est destiné, dlp_mode (detect, mask, tokenize, block), retention_days (0 ou plus), classification.
options	RequestOptions		oui	Options de l'appel (clé d'idempotence, traceparent, en-têtes, signal d'annulation).

Retour : JsonNode. Réponse JSON décodée de l'opération « Téléverser un média ».

Erreurs levées : les erreurs typées du transport (Erreurs).