Téléversement et téléchargement des médias
Téléversements signés et URL temporaires des résultats.
Une URL HTTPS publique d’image, de vidéo ou d’audio peut être transmise directement dans le champ prévu par le modèle. Le téléversement avec commit ci-dessous concerne seulement les fichiers locaux. Téléchargez directement output.assets[].url, sans clé API. expiresAt est généralement fixé à 20 minutes, sans dépasser les 14 jours de conservation. Une nouvelle interrogation renouvelle le lien ; download-url reste facultatif.
POST /api/v1/common/upload-url
PUT <uploadUrl>
POST /api/v1/files/{fileId}/commit
GET <output.assets[].url>Téléverser du Base64 avec le SDK
client.uploadBase64 accepte une Data URI ou une chaîne Base64 accompagnée de contentType, puis exécute le téléversement et le commit existants. Passez l’URI spicy:// obtenue à input. Les limites sont de 10 MiB pour les images et 100 MiB pour l’audio et la vidéo ; les limites inférieures propres au modèle restent applicables. Cette méthode n’envoie pas le Base64 directement dans un champ d’entrée du modèle.
Téléverser une entrée
POST /api/v1/common/upload-url renvoie fileId et uploadUrl. Effectuez le PUT avec le Content-Type indiqué, appelez ensuite POST /api/v1/files/{fileId}/commit, puis placez uniquement l’URI spicy:// renvoyée dans le champ input du modèle. N’utilisez ni uploadUrl ni un chemin d’objet temporaire comme input.
Le Content-Type doit correspondre à la signature. Vérifiez aussi format et taille côté client. Les URI sont rattachées au compte et ne sont pas partageables entre comptes.
Télécharger un résultat
Téléchargez directement output.assets[].url, sans clé API. expiresAt est généralement fixé à 20 minutes, sans dépasser les 14 jours de conservation. Une nouvelle interrogation renouvelle le lien ; download-url reste facultatif.
Consultez le contrat OpenAPI 3.1 pour la définition complète des champs.
Documentation associée
La limite est de 10 MiB pour les images et 100 MiB pour l’audio et la vidéo. Respectez un max_size_mb inférieur dans le schéma ainsi que le maxBytes du ticket. La durée audio/vidéo maximale est de 600 secondes. Commit valide le format réel et peut renvoyer durationSeconds sous forme décimale, width et height. Utilisez uniquement l’URI spicy:// issue d’un commit réussi, valable un jour.
image/jpeg · image/png · image/webp · image/gif · video/mp4 · video/webm · audio/mpeg · audio/wav