Les médias sont des fichiers réutilisables — arrière-plans vidéo, images statiques, logos et clips d’intro/outro — que vous téléversez une seule fois et que vous référencez depuis des presets ou les paramètres du projet. Cela évite de devoir retéléverser le même fichier à chaque fois que vous rendez une nouvelle piste.
Types de médias
| Type | Description |
|---|
video | Vidéo d’arrière-plan en boucle. |
image | Image d’arrière-plan statique. |
logo | Superposition de logo. |
intro-video | Lecture avant le démarrage du karaoké. |
outro-video | Lecture après la fin du karaoké. |
Endpoints
| Method | Path | Purpose |
|---|
GET | /media | Lister les médias pour le compte authentifié. |
POST | /media | Enregistrer un fichier déjà téléversé comme média réutilisable. |
GET | /media/{mediaId} | Récupérer un élément média unique. |
DELETE | /media/{mediaId} | Supprimer un élément média. |
Flux de téléversement
La création d’un élément média est un processus en deux étapes. Téléversez d’abord les octets du fichier, puis enregistrez le fichier téléversé comme média réutilisable.
Créer une cible de téléversement
curl -X POST https://api.youka.io/fr/api/v1/uploads \
-H "Authorization: Bearer yk_..." \
-H "Content-Type: application/json" \
-d '{
"filename": "background.mp4",
"contentType": "video/mp4",
"contentLength": 8421120
}'
inputFileId et uploadUrl.PUT les octets du fichier
curl -X PUT "$UPLOAD_URL" \
-H "Content-Type: video/mp4" \
--data-binary "@./background.mp4"
Enregistrer l’élément média
curl -X POST https://api.youka.io/fr/api/v1/media \
-H "Authorization: Bearer yk_..." \
-H "Idempotency-Key: bg-loop-v1" \
-H "Content-Type: application/json" \
-d '{
"inputFileId": "file_abc123",
"type": "video"
}'
mediaId et l’url du média. Utilisez l’url dans les presets ou les paramètres du projet.POST /media n’accepte pas de téléversements de fichiers bruts. Il attend un inputFileId
issu d’un appel préalable POST /uploads + PUT.
Lister les médias
curl https://api.youka.io/fr/api/v1/media \
-H "Authorization: Bearer yk_..."
Appliquer un arrière-plan
Référencez les médias téléversés depuis un preset ou directement depuis les paramètres du projet :
curl -X PATCH https://api.youka.io/fr/api/v1/projects/prj_abc/settings \
-H "Authorization: Bearer yk_..." \
-H "Content-Type: application/json" \
-d '{
"settings": {
"style": {
"background": {
"type": "image",
"url": "https://cdn.youka.io/backgrounds/bg_abc123.jpg",
"objectFit": "cover"
}
}
}
}'
Supprimer des médias
curl -X DELETE https://api.youka.io/fr/api/v1/media/bg_abc123 \
-H "Authorization: Bearer yk_..." \
-H "Idempotency-Key: delete-bg_abc123"
La suppression des médias n’affecte pas les projets ou exports déjà rendus avec
ceux-ci. Les rendus futurs qui référencent le média supprimé reviendront à
l’arrière-plan par défaut.
Et ensuite
