Médias

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.

Les schémas complets des requêtes et des réponses se trouvent dans la API reference.

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
  }'

La réponse contient 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"
  }'

La réponse inclut le nouveau 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_..."

Renvoie un tableau de tous les éléments média réutilisables du compte authentifié.

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

Render settings reference — tous les chemins de champs partagés et les valeurs enum
Presets — regrouper les médias avec d’autres paramètres de rendu
Project settings — appliquer des arrière-plans à un projet
SDK media — le même flux en TypeScript

Overview

How To

Customization

Audio

Settings

Exporting

Account

Types de médias

Endpoints

Flux de téléversement

Lister les médias

Appliquer un arrière-plan

Supprimer des médias

Et ensuite

​Types de médias

​Endpoints

​Flux de téléversement

​Lister les médias

​Appliquer un arrière-plan

​Supprimer des médias

​Et ensuite

Types de médias

Endpoints

Flux de téléversement

Lister les médias

Appliquer un arrière-plan

Supprimer des médias

Et ensuite