Utilisez POST /api/v1/hub/files pour obtenir une URL temporaire utilisable dans les champs de modèle au format URI.
Le champ multipart doit s’appeler file. La taille maximale est de 50 MiB par défaut. Elle peut être plus basse selon la configuration du service.
Réutiliser un fichier par son empreinte
Les champs de modèle au format URI acceptent l’URL temporaire ou une référence sha256:<64 caractères hexadécimaux>. Construisez cette référence avec la propriété sha256 renvoyée par l’envoi.
La référence ne résout qu’un fichier non expiré envoyé par le même compte. Une empreinte inconnue, expirée ou appartenant à un autre compte renvoie 400 invalid_input lors de la soumission.
Types acceptés
Images : image/png, image/jpeg, image/webp, image/gif.
Vidéos : video/mp4, video/webm, video/quicktime.
Audio et documents : audio/mpeg, audio/wav, audio/ogg, application/pdf, application/octet-stream.
Les fichiers envoyés expirent après 24 heures par défaut. Les sorties générées expirent après 7 jours par défaut. Les valeurs effectives restent indiquées dans expires_at et peuvent varier selon la configuration du service. Un téléchargement expiré renvoie 410 file_expired.
