Référence des commandes

Syntaxe, arguments et options des commandes Reela. Exécutez reela <command> -h pour obtenir de l’aide dans la version installée.

login / logout / whoami / statusCopier le lien d’ancrage

reela login
reela logout
reela whoami
reela status

• login se connecte via l’autorisation dans le navigateur. Ouvrez l’URL affichée, saisissez le code si cela vous est demandé, puis attendez la fin de la commande.
• logout déconnecte le profil sélectionné.
• whoami affiche le compte connecté.
• status vérifie le compte et l’état de la livraison.

reela --profile work login
reela --profile work whoami

createCopier le lien d’ancrage

Créez une vidéo à partir d’une invite et de fichiers multimédias facultatifs.

reela create [PROMPT] --visual <TYPE> [OPTIONS]

Fournissez une invite positionnelle ou --prompt-file. Au moins un --visual est requis.

Types visuels et rôles des fichiersCopier le lien d’ancrage

• ai-video : génère des plans ; vous pouvez joindre reference-image:<path> pour le style.
• avatar : inclut un présentateur sélectionné avec --avatar <id>.
• original-clip : monte des séquences sans leur audio ; joignez video-source:<path>.
• original-sync : conserve l’audio des séquences ; joignez video-audio:<path>.
• image-video : anime une image ; joignez original-image:<path>.

Utilisez background-music:<path> pour votre propre musique. Répétez les options au lieu de regrouper les valeurs en les séparant par des virgules.

ExemplesCopier le lien d’ancrage

reela create "A product demo" --visual ai-video --layout portrait --dry-run
reela create --prompt-file brief.txt --visual image-video --file original-image:photo.png --dry-run

Vérifiez d’abord les crédits estimés. Démarrez le démon et configurez votre abonnement de livraison avant de supprimer --dry-run pour soumettre la demande. La soumission peut consommer des crédits ; Reela génère la vidéo en arrière-plan et livre le résultat final via votre abonnement. Consultez la section démon / abonnement ci-dessous.

tasksCopier le lien d’ancrage

Répertoriez les tâches et consultez les détails d’une tâche ou les versions de sortie. Pour les générations vidéo de longue durée, utilisez les abonnements de fin du démon pour recevoir automatiquement les résultats terminés.

reela tasks list [--status <STATUS>] [--limit <N>] [--offset <N>] [--sort <ORDER>]
reela tasks get <TASK_ID>
reela tasks versions <TASK_ID> --origin brand [--limit <N>] [--offset <N>]
reela tasks download <TASK_ID> [--video <ID>] [--out-dir <DIR>]

• list : affiche 20 résultats par défaut, avec un décalage de 0, triés par created_at:desc. Filtres d’état : cancelled, pending, processing, failed, partial, completed.
• get : affiche l’état de la tâche, sa progression et l’invite de création, si disponible.
• versions : répertorie les versions de sortie Brand, y compris celles qui ne sont pas terminées. Nécessite --origin brand. Limite : 1–100 (20 par défaut) ; le décalage est de 0 par défaut.
• download : télécharge la vidéo terminée dans le répertoire configuré ou --out-dir (forme courte : -o). Utilisez --video pour sélectionner une sortie Brand terminée.

reela tasks list --status completed --output json

collectionCopier le lien d’ancrage

Répertoriez les vidéos d’une collection existante, y compris leurs titres et descriptions.

reela collection list [--session <TITLE>]
reela collection list --session "Product launch" --output json

REELA_COLLECTION_ID est prioritaire lorsqu’il est défini. Sinon, la commande recherche la session dans le profil sélectionné. La session par défaut est reela-YYYY-MM-DD, en fonction de la date locale et non de la dernière session utilisée. Cette commande ne crée pas de collection ; utilisez create pour en démarrer une.

Les vidéos terminées peuvent inclure des URL de téléchargement. Traitez ces liens comme des informations sensibles et ne les publiez pas ; ne supposez pas que chaque lien nécessite une authentification ou a la même durée de validité.

avatarCopier le lien d’ancrage

reela avatar list
reela avatar get <ID>

avatar list répertorie les avatars disponibles ; avatar get affiche les détails d’un avatar. Utilisez son ID avec create --avatar.

tiersCopier le lien d’ancrage

Répertoriez les options de génération et le niveau par défaut du profil sélectionné.

reela tiers list
reela tiers list --output json
reela --profile work tiers list

La sortie en texte brut affiche le libellé entre guillemets de chaque niveau, sa description et l’indicateur de niveau par défaut. La sortie JSON comprend :

• default_tier : le libellé du niveau par défaut, s’il est disponible.
• tiers : la liste des choix, avec label, content (description) et is_default pour chaque entrée.

Utilisez le libellé exact comme create --tier, en respectant les majuscules et en mettant entre guillemets les libellés contenant des espaces. Les descriptions des niveaux expliquent les options de génération disponibles. L’accès au compte est vérifié lors de la validation ou de la soumission d’une demande.

reela create "A product demo" --visual ai-video \
  --tier "<tier-label>" --dry-run --output json

Remplacez <tier-label> par un libellé renvoyé par tiers list. L’aperçu renvoie credits_cost et quota_after sans créer de tâche. Supprimez --dry-run pour soumettre la demande avec les mêmes options.

Sans --tier, create utilise le niveau par défaut disponible dans la CLI. Si aucun niveau par défaut n’est disponible, actualisez avec tiers list ou fournissez --tier. Sélectionnez le même profil pour répertorier les niveaux et créer la vidéo.

brandCopier le lien d’ancrage

Répertoriez et appliquez les kits de marque existants.

reela brand list [--limit <N>] [--offset <N>]
reela brand apply <BRAND_ID> --task <TASK_ID> [--inputs '<JSON>']

list affiche 20 résultats par défaut, avec un décalage de 0 ; la limite doit être comprise entre 1 et 100. apply applique un kit de marque et attend jusqu’à 10 minutes la fin de la vidéo.

Utilisez --inputs pour fournir les valeurs requises par votre kit de marque. Il accepte un objet JSON contenant des valeurs de type chaîne, nombre ou booléen ; les tableaux, objets imbriqués et valeurs null ne sont pas pris en charge. Les noms des paramètres sont définis par le kit. Par exemple :

reela brand apply <BRAND_ID> --task <TASK_ID> \
  --inputs '{"AUTHOR_PROFILE_IMAGE_URL":"https://example.com/avatar.jpg","AUTHOR_NAME":"Alex"}'

Les valeurs obligatoires manquantes du modèle sont rejetées avant le rendu. Fournissez les valeurs manquantes avant de réessayer. N’incluez pas d’identifiants ni de secrets dans ces paramètres.

Si l’attente est interrompue, l’opération peut se poursuivre. Vérifiez les versions de sortie avant de réessayer :

reela tasks versions <task-id> --origin brand
reela tasks download <task-id> --video <video-id>

editCopier le lien d’ancrage

Exportez le JSON de montage pour continuer le montage dans Reela, ou exportez un projet Remotion autonome pour effectuer des modifications locales sans restriction.

reela edit versions <TASK_ID>
reela edit export-json <TASK_ID> --file <PATH> [--version <N>]
reela edit export-remotion <TASK_ID> [--video <VIDEO_ID>] [--out-dir <DIR>]
reela edit validate <FILE>
reela edit save <FILE>
reela edit render <FILE>

• versions : répertorie les versions modifiables, y compris les brouillons et les rendus ayant échoué.
• export-json : exporte la version de montage la plus récente ou sélectionnée au format JSON pour la modifier dans Reela. Modifiez le fichier, validez-le, puis utilisez save ou render.
• export-remotion : exporte un projet Remotion autonome pour effectuer des modifications locales sans restriction. Sans --video, la modification en cours est exportée ; utilisez --video pour sélectionner une version vidéo. --out-dir (forme courte : -o) correspond au répertoire du projet lui-même, et non à son répertoire parent. Sans cette option, un dossier de projet est créé dans le répertoire de téléchargement configuré. Les destinations existantes sont préservées en ajoutant un suffixe numérique. La sortie JSON contient le répertoire final path.
• validate : vérifie si le JSON de montage contient des erreurs sans téléverser son contenu. Une connexion au compte et une connexion Internet sont requises.
• save : enregistre le brouillon sans effectuer le rendu. Ouvrez l’URL d’aperçu renvoyée pour le vérifier.
• render : enregistre le brouillon et attend la fin du rendu. En cas de succès, l’ID de tâche et l’URL d’aperçu ne sont renvoyés qu’une fois la sortie rendue enregistrée. Le service attend jusqu’à dix minutes ; la CLI laisse dix minutes et trente secondes pour recevoir la réponse. Un échec de rendu confirmé entraîne une sortie avec le code 10 ; un délai d’attente dépassé entraîne une sortie avec le code 6. Les soumissions ne sont pas réessayées automatiquement. Une interruption ou un délai d’attente dépassé n’annule pas le rendu ; vérifiez reela edit versions <task-id> avant de relancer le rendu.

reela edit export-json <task-id> --file edit.json
reela edit validate edit.json
reela edit save edit.json

L’export Remotion attend la préparation du paquet, télécharge et décompresse le projet, et ne conserve pas le fichier ZIP. La préparation du paquet peut prendre jusqu’à dix minutes. Les soumissions ne sont pas réessayées automatiquement ; une interruption ou l’expiration du délai d’attente n’annule pas la préparation du paquet en arrière-plan. Le projet exporté ne peut pas être réimporté dans Reela et n’utilise pas les commandes validate, save ou render.

showCopier le lien d’ancrage

Téléchargez et modifiez un espace de travail Show contenant show.yaml, subjects.yaml et episodes/*.md.

reela show list [--limit <N>] [--offset <N>]
reela show download <SHOW_ID> [--out-dir <DIR>] [--force]
reela show validate
reela show update [--dry-run] [--yes]

list affiche 20 résultats par défaut, avec un décalage de 0. Exécutez validate et update depuis le répertoire de l’espace de travail téléchargé. update --dry-run affiche un aperçu sans écrire de données localement ou à distance ; --yes soumet la demande sans confirmation interactive.

Options destructives : download --force supprime tous les fichiers existants dans le répertoire cible, y compris ceux qui ne sont pas liés. update soumet l’intégralité de l’espace de travail local : supprimer un fichier Episode le supprime à distance, et le contenu local modifiable remplace le contenu distant sans vérification de version ni fusion. Les Shows en cours de génération ou en pause ne peuvent pas être mis à jour.

reela show download <show-id> --out-dir ./my-show
cd my-show
reela show validate
reela show update --dry-run
reela show update

show subjectCopier le lien d’ancrage

reela show subject download (--all | --subject-id <ID>) [--history] [--force]
reela show subject replace-image <SUBJECT_ID> --file <PATH>
reela show subject regenerate <SUBJECT_ID> --prompt-file <PATH> --model <MODEL> [--reference-image-id <ID>] [--yes]

• download : télécharge des images pour tous les Subjects ou un seul Subject dans l’espace de travail actuel. --history inclut les images historiques ; --force remplace les fichiers image existants.
• replace-image : téléverse une image statique JPEG, PNG ou WebP (20 MiB et 40 mégapixels maximum), en préservant l’historique des images et les vidéos existantes.
• regenerate : génère une image et attend jusqu’à 10 minutes. Le fichier d’invite doit être encodé en UTF-8. --reference-image-id sélectionne une image dans l’espace de travail actuel ; --yes autorise la génération sans confirmation interactive.

Les téléchargements Show contiennent des fichiers structurés, et non des images ; téléchargez séparément les images Subject. Pour sélectionner une image historique, modifiez current_image_id dans subjects.yaml, puis effectuez la mise à jour.

L’interruption de la génération d’images arrête uniquement l’attente, pas la génération en arrière-plan. Relancer la commande peut entraîner une nouvelle génération et de nouveaux frais.

configCopier le lien d’ancrage

Gérez les paramètres et les profils de compte.

reela config list
reela config get <KEY>
reela config set <KEY> <VALUE>
reela config profiles list
reela config profiles create <NAME>
reela config profiles show [NAME]
reela config profiles use <NAME>
reela config profiles delete <NAME>

Les paramètres s’appliquent au profil sélectionné. Utilisez config list pour découvrir les clés et leurs valeurs actuelles. profiles use modifie le profil par défaut ; --profile en sélectionne un pour une seule commande.

reela config set delivery.download ~/Videos/reela
reela config profiles create work
reela --profile work login
reela config profiles use work

daemon / subscribeCopier le lien d’ancrage

Gérez la livraison automatique locale sous Linux et macOS. Ces commandes ne sont pas disponibles sous Windows.

reela daemon start [--foreground] [--keep-backlog]
reela daemon stop
reela daemon status
reela daemon install
reela daemon uninstall
reela daemon logs [--tail <N>]

• start : démarre la livraison automatique. --foreground la maintient attachée au terminal. Si ce profil n’a pas de progression de livraison enregistrée, --keep-backlog livre également les vidéos terminées précédemment qui sont toujours disponibles pour la livraison automatique. Sinon, la livraison reprend à partir de la progression enregistrée.
• stop arrête la livraison ; status affiche son état actuel.
• install active le démarrage à la connexion ; uninstall désactive le démarrage automatique.
• logs affiche les journaux récents ; --tail affiche 20 lignes par défaut.

subscribeCopier le lien d’ancrage

reela subscribe list
reela subscribe status
reela subscribe add download [--dir <DIR>]
reela subscribe add email [--address <EMAIL>]
reela subscribe add script --path <PATH> [--timeout-seconds <N>] [--max-retries <N>]
reela subscribe remove <METHOD>

Les méthodes sont download, email ou script. Par défaut, l’adresse e-mail est celle du compte. Un script doit être un exécutable fiable qui lit un objet JSON depuis stdin et renvoie le code de sortie 0 en cas de succès. --max-retries correspond au nombre maximal total de tentatives de livraison ; utilisez reela subscribe add -h pour la charge utile du script.

L’ajout d’une méthode tente de démarrer un démon arrêté. Après avoir modifié les paramètres de livraison, redémarrez tout démon déjà en cours d’exécution pour qu’il les prenne en compte : pour un démon démarré manuellement, utilisez reela daemon stop, puis reela daemon start ; pour un démarrage géré par un service, redémarrez-le à l’aide de votre gestionnaire de services.

reela subscribe add download --dir ~/Videos/reela
reela subscribe status

updateCopier le lien d’ancrage

Mettez à jour la CLI installée et vérifiez sa version.

reela update
reela --version