Passer au contenu principal
POST
Téléversez un média de référence et recevez directement son URL publique en cas de succès, sans suivi périodique. Le téléversement est gratuit, mais le solde du compte doit être positif. Les trois endpoints partagent un quota par utilisateur : 2000 fichiers sur 72 heures par défaut.
Le Playground de la documentation ne permet pas le téléversement. Utilisez les exemples cURL, Python ou JavaScript ci-dessous. L’exemple JavaScript nécessite un <input type="file"> avec un fichier sélectionné.

Authentification

string
requis
Utilisez une APIMart API Key valide, active et non expirée sous la forme Bearer <token>. Le compte ne doit pas être suspendu et son solde doit être positif. Un quota propre à la Key épuisé n’empêche pas le téléversement. Obtenez une Key dans Gestion des API Keys.

Paramètres de requête

file
requis
Envoyez un fichier avec son nom dans le champ file d’une requête multipart/form-data. Ne remplacez pas cette partie par du JSON, une chaîne base64 ou une URL. Les autres champs sont ignorés ; si plusieurs parties file sont présentes, seule la première est traitée.Formats pris en charge: MP4 (.mp4), MOV (.mov), WebM (.webm)Taille maximale par défaut: 50MB. Les limites de taille sont configurables. La configuration active et le message d’erreur de dépassement font référence.
Avec cURL --form, Python files ou JavaScript FormData, laissez le client créer Content-Type avec sa boundary. Ne définissez pas cet en-tête manuellement.

Validation des fichiers

Le type est détecté à partir du contenu, pas de l’extension ou du MIME déclaré. Le contenu doit correspondre à l’endpoint. Renommer ne convertit pas un fichier ; un type incorrect renvoie HTTP 400. La structure du conteneur vidéo est vérifiée. Les faux en-têtes et conteneurs endommagés sont refusés. Seuls les formats ci-dessous sont acceptés ; renommer un AVI ou MKV ne suffit pas.

Réponse de succès

HTTP 200 renvoie les informations du fichier. url est à la racine du JSON, sans enveloppe data ni identifiant de tâche de génération.
string
URL publique à passer au paramètre de référence approprié de l’API de génération. Les modèles conservent leurs propres limites de format, taille, nombre et durée. Un téléversement réussi ne garantit pas la compatibilité avec le modèle.
string
Nom d’origine du fichier.
string
Type MIME détecté par le serveur à partir du contenu, et non la valeur déclarée par le client.
string
Catégorie de fichier. Cet endpoint renvoie video.
integer
Taille réelle en octets.
integer
Date de téléversement en secondes Unix.
object
Informations facultatives sur le quota. Les champs d’un utilisateur limité sont listés ci-dessous. La structure peut différer pour un accès illimité ou des statistiques indisponibles.

Quota partagé et limites de requêtes

Images, vidéos et audios partagent un quota par utilisateur. Plusieurs Keys d’un même utilisateur n’ajoutent pas de quota. La fenêtre glisse à chaque heure pleine et compte par défaut les succès des dernières 71–72 heures environ. Les fichiers invalides, trop volumineux ou non enregistrés ne consomment pas ce quota. Les réponses limitées ordinaires incluent X-Upload-Quota-Limit, X-Upload-Quota-Remaining et X-Upload-Quota-Reset, correspondant à limit, remaining et reset_at. Reset est en secondes Unix. Les utilisateurs illimités reçoivent quota: {"unlimited": true} sans ces trois en-têtes. Si les statistiques sont indisponibles, une réponse réussie peut omettre quota. Cette absence ne signifie ni zéro ni illimité ; ne téléversez pas de nouveau uniquement pour cette raison. Un quota de fichiers épuisé renvoie HTTP 429, error.type: rate_limit_exceeded, quota avec remaining: 0 et Retry-After. Attendez le nombre de secondes indiqué. Une limite distincte de 1000 requêtes par Key sur 60 secondes utilise rate_limit_error.

Gestion des erreurs

Les erreurs se trouvent dans l’objet error à la racine du JSON. Consultez le statut HTTP, error.type / error.code et error.message.

Utilisation des URL et conservation

72 heures est la fenêtre de quota par défaut, pas une garantie de conservation. La durée dépend de la politique de stockage. Conservez les originaux et utilisez rapidement les URL pour la génération ; ne les considérez pas comme permanentes.

Autres endpoints de téléversement