> ## Documentation Index > Fetch the complete documentation index at: https://docs.youka.io/llms.txt > Use this file to discover all available pages before exploring further. # Projets > Créer, inspecter, attendre et modifier des projets de karaoké en cours Un projet est la ressource de travail en cours pour une piste de karaoké. Il contient le média source, les paroles synchronisées, les stems séparés, les paramètres de rendu et les exports créés à partir de celui-ci. ## `project create` Créer un nouveau projet à partir d’un fichier local ou d’une URL. ```bash theme={null} youka project create [options] ``` Un chemin de fichier local (`./song.mp3`) ou une URL HTTP/HTTPS (`https://example.com/song.mp4`). ### Options | Option | Description | | ------------------------------- | ------------------------------------------------------------------------------ | | `--title ` | Titre du projet | | `--mode <mode>` | `none`, `transcribe`, ou `align` | | `--lyrics <text>` | Texte des paroles | | `--lang <code>` | Code de langue | | `--sync-model <model>` | Modèle de synchronisation des paroles | | `--split-model <model>` | Modèle de séparation des stems | | `--max-video-quality <quality>` | Qualité vidéo maximale pour les sources URL : `720p`, `1080p`, `4k`, ou `best` | | `--preset <presetId>` | Appliquer un preset lors de la création du projet | | `--export` | Créer un export une fois le projet prêt | | `--download` | Créer un export, attendre qu’il soit prêt et le télécharger | | `--output <path>` | Chemin de sortie pour `--download` | ### Exemples <CodeGroup> ```bash local-file theme={null} youka project create ./song.mp3 \ --title "My Song" \ --mode transcribe \ --lang en \ --wait \ --json ``` ```bash url theme={null} youka project create "https://example.com/song.mp4" \ --max-video-quality 4k \ --download \ --output ./karaoke.mp4 \ --json ``` ```bash align theme={null} youka project create ./song.mp3 \ --mode align \ --lyrics "$(cat lyrics.txt)" \ --sync-model audioshake-alignment \ --wait \ --json ``` </CodeGroup> Règles : * Si vous fournissez des paroles et omettez `--mode`, la CLI utilise `align` par défaut * `align` nécessite des paroles * `transcribe` et `none` n’acceptent pas de paroles * `--download` implique `--export` * `--max-video-quality` s’applique uniquement aux sources URL HTTP/HTTPS. La valeur par défaut est `1080p`, la CLI utilise la meilleure qualité disponible jusqu’à cette limite et bascule vers le meilleur format disponible lorsque la plateforme n’expose pas de flux plafonné. ## `project list` Lister tous les projets du compte authentifié. ```bash theme={null} youka project list youka project list --json ``` ## `project quote` Estimer les crédits nécessaires pour créer un projet sans créer le projet. ```bash theme={null} youka project quote <source> [options] ``` `source` accepte les mêmes formes de chemin de fichier local ou d’URL HTTP/HTTPS que `project create`. Sans `--duration`, la CLI téléverse la source afin que le serveur puisse mesurer le média précisément, mais elle ne crée pas de projet. ### Options | Option | Description | | ------------------------------- | ------------------------------------------------------------------------------ | | `--title <title>` | Titre du projet | | `--mode <mode>` | `none`, `transcribe`, ou `align` | | `--lyrics <text>` | Texte des paroles pour `align` | | `--lang <code>` | Code de langue | | `--sync-model <model>` | Modèle de synchronisation des paroles | | `--split-model <model>` | Modèle de séparation des stems | | `--max-video-quality <quality>` | Qualité vidéo maximale pour les sources URL : `720p`, `1080p`, `4k`, ou `best` | | `--duration <seconds>` | Estimer à partir d’une durée connue sans téléverser la source | Exemples : ```bash theme={null} youka project quote ./song.mp3 --mode transcribe --json youka project quote https://example.com/song.mp4 --max-video-quality 4k --mode transcribe --json youka project quote ./song.mp3 --duration 210 --mode none --json ``` ## `project show` Obtenir l’état actuel du projet, y compris `state` normalisé, `pendingOperation`, les stems, les paramètres et les exports. ```bash theme={null} youka project show <projectId> ``` <ParamField path="projectId" type="string" required> L’ID de projet renvoyé par `project create`. </ParamField> ## `project wait` Interroger un projet jusqu’à ce qu’il atteigne un état terminal. ```bash theme={null} youka project wait <projectId> --json ``` ## `project delete` Supprimer un projet ainsi que tous ses stems, paroles et exports associés. ```bash theme={null} youka project delete <projectId> --idempotency-key delete-<projectId> ``` <Warning> La suppression est définitive. Passez `--idempotency-key` pour sécuriser les tentatives de réexécution. </Warning> ## `project sync` Relancer la transcription ou l’alignement des paroles sur un projet existant. ```bash theme={null} youka project sync <projectId> [options] ``` | Option | Description | | ---------------------- | ------------------------------------- | | `--mode <mode>` | `transcribe` ou `align` | | `--text <text>` | Texte des paroles | | `--lang <code>` | Code de langue | | `--sync-model <model>` | Modèle de synchronisation des paroles | Exemple : ```bash theme={null} youka project sync $PROJECT_ID \ --mode align \ --text "$(cat lyrics.txt)" \ --wait \ --json ``` ## `project separate` Relancer la séparation des stems sur un projet existant. ```bash theme={null} youka project separate <projectId> [--split-model <model>] ``` Exemple : ```bash theme={null} youka project separate $PROJECT_ID --split-model audioshakeai --wait --json ``` ## `project settings` Lire ou mettre à jour les paramètres actifs du projet. ```bash theme={null} youka project settings <projectId> youka project settings <projectId> --preset <presetId> --body ./settings.json ``` Si ni `--preset` ni `--body` ne sont présents, la commande renvoie les paramètres actuels. Si l’un ou l’autre est présent, elle effectue une mise à jour. Exemples : <CodeGroup> ```bash show theme={null} youka project settings $PROJECT_ID --json ``` ```bash update theme={null} youka project settings $PROJECT_ID \ --preset preset_abc123 \ --body ./project-settings.json \ --json ``` </CodeGroup> ## `project stem list` Lister les stems d’un projet. ```bash theme={null} youka project stem list <projectId> youka project stem list <projectId> --json ``` ## `project stem download` Télécharger un ou plusieurs fichiers de stem sur disque. Les stems sont téléchargés dans leur format d’origine tel qu’il est stocké ; la CLI ne les transcode pas. ```bash theme={null} youka project stem download <projectId> <stemId> --output ./stems youka project stem download <projectId> --type instrumental --output ./stems youka project stem download <projectId> --type original --type backing-vocals --type vocals --output ./stems youka project stem download <projectId> --all --output ./stems ``` Les valeurs `--type` prises en charge sont `original`, `instrumental`, `vocals` et `backing_vocals`. La CLI accepte également `backing-vocals`, `backingVocals` et `backingvocals` comme alias. ## What's next * [Exports](/fr/cli/exports) - rendre le karaoké final * [Presets](/fr/cli/presets) - gérer des configurations de rendu réutilisables * [Render settings reference](/en/render-settings-reference) - champs partagés des presets et des paramètres