Prérequis
Installez et chargez ces compétences avant de générer (ignorer si déjà en contexte via @pruna) :
| Compétence | Description | Installation |
|---|---|---|
generation-diversity | Utilisez-la lors de la rédaction de tout prompt génératif — graine rituelle, structure explicite, axes de scénario et portes de qualité avant les appels API payants. | npx skills add PrunaAI/pruna-skills@generation-diversity -y |
video-prompting | Utilisez-la lors de la rédaction de prompts vidéo ou de mouvement pour tout modèle génératif — dramaturgie, caméra, mouvement physiquement plausible, ancres de trame et chaînage de clips. | npx skills add PrunaAI/pruna-skills@video-prompting -y |
pruna-api | Utilisez-la avant tout appel HTTP Pruna ou Replicate — identifiants, téléversement/interrogation/téléchargement, lots parallèles et sécurité de l'agent. | npx skills add PrunaAI/pruna-skills@pruna-api -y |
Ou installez l'ensemble complet une fois : npx skills add PrunaAI/pruna-skills@pruna -y
Suivez les sections Avant de générer / conception de chaque compétence — ne répétez pas le contenu guide ici.
Habitude de l'agent
Dans la première réponse, nommez `p-video-edit` entre guillemets inversés, confirmez PRUNA_API_KEY (ou arrêtez avec les liens d'inscription provenant de pruna-api), puis demandez la vidéo source (max 15s) et le cahier des charges de l'édition. Ouverture du cadrage → cadrage de clarification generation-diversity avant le premier POST. Rédigez les modifications avec Conception de prompt (dynamique et fidèle) — ne collez pas les exemples de compétences. Redirigez lorsque la mention Quand NE PAS utiliser correspond mieux.
Conception de prompt (dynamique et fidèle)
prompt est chirurgical et verrouillé sur la demande. Un seul changement principal par exécution. Décrivez l'état final souhaité, puis nommez ce qui doit rester inchangé. Ne modifiez que ce que l'utilisateur a demandé ; gardez la caméra, le mouvement, l'audio et les éléments non mentionnés identiques.
| À faire | À ne pas faire |
|---|---|
Formule : Changer uniquement [X]. Préserver [géométrie / mouvement / caméra / éclairage / sujets non mentionnés]. | Améliorer vague / réécritures d'ambiance seul qui inventent une nouvelle scène |
| Nommez chaque élément à conserver de l'utilisateur (sujet, trajectoire caméra, éclairage, accessoires) | Supprimez les clauses de conservation et espérez que le modèle les préserve |
| Graine rituelle avant la rédaction ; formulation nouvelle pour les clauses de conservation lorsque le cahier des charges le permet | Copiez l'échantillon de cette compétence (ciel de coucher de soleil) lorsque l'utilisateur a décrit une modification différente |
Référencez les références lorsqu'elles sont utilisées : ajouter l'accessoire de la première référence | Utiliser la référence vague sans emplacement source |
Affichez prompt avant POST lorsque la formulation n'est pas verrouillée | Modification silencieuse qui change la caméra, le casting ou les régions non demandées |
Vérification de fidélité (avant paiement) : le prompt doit toujours satisfaire la modification et chaque conservation énoncée. N'"améliorez" pas avec des extras lorsqu'on vous a demandé un seul attribut ou une modification d'environnement.
Tâches faibles (à éviter ou à avertir) : une toute nouvelle scène/intrigue ; ajouter un objet avec son propre mouvement indépendant (surtout une nouvelle forme tenue en main) ; changer l'angle, le mouvement ou le zoom de la caméra.
Limite de la compétence
| p-video-edit | p-video-replace | |
|---|---|---|
| Question utilisateur | Changer la couleur / l'environnement / l'objet / le texte / l'éclairage dans ce clip ? | Remplacer cette personne dans cette vidéo ? |
| Objectif | Modification par instruction du clip source | Échanger l'identité dans des images existantes |
| Images de référence | images facultatives — 0 à 4 | images obligatoires — 1 à 4 |
Champ prompt | prompt | instruction_prompt |
Utilisez p-video-replace lorsque la tâche est un échange de personnage à partir de photos de référence obligatoires. Utilisez cette compétence pour les modifications d'attribut, d'environnement, d'objet, de texte ou d'éclairage pilotées par prompt.
Quand NE PAS utiliser
Utilisez une autre compétence à la place :
| Compétence | Description | Installation |
|---|---|---|
p-video-2-pro | Utilisez-la lorsqu'on souhaite un clip cinématographique à partir de texte ou d'images de début/fin — publicités produit, plans documentaires ou dialogues avec audio généré. Pas pour le 1080p, les pistes audio importées ou les intervenants tête-parlante uniquement. | npx skills add PrunaAI/pruna-skills@p-video-2-pro -y |
p-video-2 | Utilisez-la lorsqu'on souhaite un clip court et soigné à partir de texte, d'images ou d'audio importé — B-roll 1080p, animation d'image de début/fin, ou plan mouvementé avec piste mixée. Pas pour les clips audio générés cinématographiques ou les intervenants tête-parlante uniquement. | npx skills add PrunaAI/pruna-skills@p-video-2 -y |
p-video | Utilisez-la lorsqu'on souhaite un simple clip court à partir de texte ou d'images — B-roll rapide, brouillons ou animation d'image de début/fin. Pas lorsque le cahier des charges nécessite une génération cinématographique, une qualité maximale, un synchronisme labial serré ou un audio importé en 1080p. | npx skills add PrunaAI/pruna-skills@p-video -y |
p-video-replace | Utilisez-la lorsqu'on souhaite remplacer une personne, une tenue ou un produit dans des images existantes tout en conservant le mouvement de la caméra et l'audio. | npx skills add PrunaAI/pruna-skills@p-video-replace -y |
p-video-animate | Utilisez-la lorsqu'on souhaite qu'une photo bouge comme une autre vidéo — transfert de mouvement, remix de danse ou variations de performance à partir d'un clip modèle. | npx skills add PrunaAI/pruna-skills@p-video-animate -y |
video-editing | Utilisez-la pour assembler ou peaufiner des clips déjà rendus avec ffmpeg — concaténation, fondus enchaînés, légendes et sous-titres incrustés, superpositions de texte/logo, curseurs avant/après, fonds musicaux, exportation pour plateforme — ou pour composer une vidéo de combinaison HTML multicouche avec Hyperframes. Pas pour la génération vidéo IA, la conception de prompts ou les modifications vidéo basées sur modèle. | npx skills add PrunaAI/pruna-skills@video-editing -y |
HTTP (curl)
Téléverser la vidéo source
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: ${PRUNA_API_KEY}" \
-F "content=@/chemin/vers/video-source.mp4"
Utilisez la réponse urls.get dans input.video. Longueur maximale de la vidéo source : 15 secondes.
Images de référence facultatives
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: ${PRUNA_API_KEY}" \
-F "content=@/chemin/vers/image-reference.png"
Utilisez chaque réponse urls.get dans input.images (jusqu'à 4 ; jpg, jpeg, png, webp).
Créer (asynchrone — recommandé)
curl -X POST 'https://api.pruna.ai/v1/predictions' \
-H 'Content-Type: application/json' \
-H "apikey: ${PRUNA_API_KEY}" \
-H 'Model: p-video-edit' \
-d '{
"input": {
"video": "https://api.pruna.ai/v1/files/video-source-abc123",
"prompt": "Changer uniquement le ciel en un coucher de soleil. Préserver le sujet, la trajectoire de la caméra et l\'éclairage sur le premier plan."
}
}'
Interrogez et téléchargez : suivez pruna-api. La durée de sortie suit la vidéo source. La facturation est par seconde retournée (0,045 $ standard, 0,025 $ brouillon). Limite de débit : 50 requêtes par minute.
Effectuez le rituel de graine aléatoire de generation-diversity avant d'écrire les prompts — ne transmettez pas la chaîne rituelle comme seed de l'API. seed facultatif uniquement lorsque l'utilisateur demande la reproductibilité.
Créer (synchrone — test rapide uniquement)
curl -X POST 'https://api.pruna.ai/v1/predictions' \
-H 'Content-Type: application/json' \
-H "apikey: ${PRUNA_API_KEY}" \
-H 'Model: p-video-edit' \
-H 'Try-Sync: true' \
-d '{
"input": {
"video": "https://api.pruna.ai/v1/files/video-source-abc123",
"prompt": "Changer uniquement le ciel en un coucher de soleil. Préserver le sujet, la trajectoire de la caméra et l\'éclairage sur le premier plan.",
"draft": true
}
}'
Avant de générer
- Lisez les guides des prérequis dans l'ordre (
generation-diversity→video-prompting). - Graine rituelle → rédigez un
promptdynamique et fidèle (section ci-dessus) → confirmezvideo(≤15 s),prompt,imagesfacultatives (0–4),draft,save_audioet l'intention de modification (attribut / supprimer / ajouter / environnement / rééclairage / texte / guidé par référence). - Notes Pruna : un seul changement principal par exécution. La correspondance d'identité ou de produit provient des
imagesfacultatives ; l'instruction de modification réside dansprompt. Les cibles vagues et les toutes nouvelles scènes réduisent la qualité. N'envoyez pas de champtask— il n'est pas dans l'API publique.
Entrée requise
video(chaîne URL) : vidéo source à éditer. Longueur maximale : 15 secondesprompt(chaîne) : instruction textuelle décrivant l'édition
Champs facultatifs courants
images(tableau de jusqu'à 4 chaînes URL) : image(s) de référence pour l'édition guidée par référence (jpg,jpeg,png,webp)prompt_upsampling(booléen, défauttrue)draft(booléen, défautfalse) : aperçu plus rapide et de moindre qualité ; facturé à 0,025 $ par seconde de sortiesave_audio(booléen, défauttrue)seed(entier) : définir uniquement pour des réexécutions reproductibles
Prochaines étapes typiques
Suites courantes après cette compétence :
| Compétence | Description | Installation |
|---|---|---|
p-video-replace | Utilisez-la lorsqu'on souhaite remplacer une personne, une tenue ou un produit dans des images existantes tout en conservant le mouvement de la caméra et l'audio. | npx skills add PrunaAI/pruna-skills@p-video-replace -y |
p-image-edit | Utilisez-la lorsqu'on souhaite modifier une photo existante — changer les tenues ou les arrière-plans, composer à partir d'images de référence ou appliquer des modifications pilotées par prompt. | npx skills add PrunaAI/pruna-skills@p-image-edit -y |
video-editing | Utilisez-la pour assembler ou peaufiner des clips déjà rendus avec ffmpeg — concaténation, fondus enchaînés, légendes et sous-titres incrustés, superpositions de texte/logo, curseurs avant/après, fonds musicaux, exportation pour plateforme — ou pour composer une vidéo de combinaison HTML multicouche avec Hyperframes. Pas pour la génération vidéo IA, la conception de prompts ou les modifications vidéo basées sur modèle. | npx skills add PrunaAI/pruna-skills@video-editing -y |