Prérequis
Installer et charger ces compétences avant de générer (ignorer si déjà en contexte via @pruna) :
| Compétence | Description | Installation |
|---|---|---|
generation-diversity | À utiliser lors de la rédaction de tout prompt génératif — seed rituel, structure explicite, axes de scénario et portes de qualité avant les appels API payants. | npx skills add PrunaAI/pruna-skills@generation-diversity -y |
image-prompting | À utiliser lors de la rédaction de prompts d'image fixe pour tout modèle génératif — composition, fiches d'identité, modifications, essayage et personnages photoréalistes. | npx skills add PrunaAI/pruna-skills@image-prompting -y |
video-prompting | À utiliser 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 frame et chaînage de clips. | npx skills add PrunaAI/pruna-skills@video-prompting -y |
pruna-api | À utiliser avant tout appel HTTP vers Pruna ou Replicate — identifiants, téléchargement/interrogation/téléchargement, lots parallèles et sécurité de l'agent. | npx skills add PrunaAI/pruna-skills@pruna-api -y |
Ou installer toute la suite en une fois : npx skills add PrunaAI/pruna-skills@pruna -y
Suivre les sections Avant de générer / conception de chaque compétence — ne pas reformuler le contenu du guide ici.
Habitude de l'agent
Dans la première réponse, nommer `p-image-edit` entre backticks, confirmer PRUNA_API_KEY, puis demander la photo source (et le brief d'édition). Accueil ouvert → generation-diversity éclaircissement du brief si nécessaire. Rédiger les modifications avec Conception du prompt (dynamique et fidèle). Rediriger vers p-image-try-on lorsqu'il s'agit d'un essayage de vêtements à partir de photos de produit.
Conception du prompt (dynamique et fidèle)
Les prompts d'édition sont chirurgicaux et verrouillés sur la demande. Ne modifier que ce que l'utilisateur a demandé ; garder tout le reste identique. La diversité s'applique à la manière dont vous formulez le changement — pas à l'invention d'une nouvelle scène.
| À faire | À ne pas faire |
|---|---|
Formule : Changer [élément spécifique]. Garder [identité / pose / éclairage / arrière-plan] identique. (édition image-prompting) | Améliorer / réécritures d'ambiance qui ignorent le brief |
| Nommer chaque élément à conserver de l'utilisateur (visage, tenue, pose, arrière-plan, produit) | Omettre les clauses de conservation et espérer que le modèle les préserve |
Seed rituel frais de generation-diversity avant la rédaction ; varier le libellé libre (matériaux, hex, nuance de caméra) lorsque le brief le permet | Copier l'exemple de cette compétence (soft gradient) lorsque l'utilisateur a demandé autre chose |
Pointer vers les références lors de la composition : visage de l'image 1, tenue de l'image 2 | Combiner ces images vague |
Montrer le prompt d'édition avant POST lorsque le libellé n'est pas verrouillé | Édition silencieuse qui modifie le sujet, l'espèce, l'âge ou les zones non demandées |
Vérification de fidélité (avant de payer) : le prompt doit toujours satisfaire le changement demandé et chaque élément conservé énoncé. Si un élément conservé manque, l'ajouter. Ne pas "agrémenter" l'arrière-plan/les personnes lorsqu'on a demandé un simple échange d'arrière-plan.
Quand NE PAS utiliser
Utiliser une autre compétence à la place :
| Compétence | Description | Installation |
|---|---|---|
p-image | À utiliser lorsque quelqu'un souhaite explicitement la génération d'images la plus rapide et la moins chère — mood boards, panneaux en vrac ou itérations rapides — pas lorsque du photoréalisme contrôlé ou du texte dans l'image est nécessaire. | npx skills add PrunaAI/pruna-skills@p-image -y |
p-image-try-on | À utiliser lorsque quelqu'un souhaite un essayage virtuel — habiller une personne avec des vêtements à partir de photos de référence pour la mode ou le e-commerce. | npx skills add PrunaAI/pruna-skills@p-image-try-on -y |
p-image-upscale | À utiliser lorsque quelqu'un souhaite upscaler ou affiner une image existante pour l'impression, les gros recadrages ou une livraison de meilleure qualité. | npx skills add PrunaAI/pruna-skills@p-image-upscale -y |
HTTP (curl)
Télécharger les références
curl -X POST "https://api.pruna.ai/v1/files" \
-H "apikey: ${PRUNA_API_KEY}" \
-F "content=@/path/to/reference.png"
Utiliser chaque réponse urls.get dans input.images.
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-image-edit' \
-d '{
"input": {
"prompt": "Changer l\u0027arrière-plan en dégradé doux, garder le sujet identique",
"images": ["https://api.pruna.ai/v1/files/FILE_ID"],
"aspect_ratio": "9:16"
}
}'
Interroger et télécharger : suivre pruna-api.
Effectuer le rituel de seed aléatoire de generation-diversity avant d'écrire les prompts — ne pas passer la chaîne rituelle comme seed de l'API. seed optionnel 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-image-edit' \
-H 'Try-Sync: true' \
-d '{
"input": {
"prompt": "Changer l\u0027arrière-plan en dégradé doux, garder le sujet identique",
"images": ["https://api.pruna.ai/v1/files/FILE_ID"],
"aspect_ratio": "9:16"
}
}'
Flux d'édition
Suivre le flux de prompt d'image fixe de generation-diversity (section édition) :
- Verrouiller le changement + les éléments conservés — la demande chirurgicale de l'utilisateur ; formule dans Conception du prompt (dynamique et fidèle).
- Télécharger les références —
POST /v1/files;urls.get→input.images(1–5). Ne jamais inventer d'URLs de fichiers. - Seed rituel → rédiger le prompt d'édition (
image-promptingconception d'édition) → vérification de fidélité (chaque clause de conservation présente). - Confirmer —
prompt, références,aspect_ratio,turbo(désactivé pour les éditions difficiles). - POST — curl asynchrone ci-dessous ; liste de vérification avant upscale/vidéo.
Format d'image : préférer match_input_image pour les éditions ; la sortie doit conserver le format de la plaque — en cas de dérive, réessayer avec la même URL de référence et des clauses de conservation explicites.
Note Pruna : pipelines d'avatar — édition à partir d'une URL de héros upscalée verrouillée ; upscaler à nouveau avant p-video* — ne jamais passer d'URLs d'édition brutes aux modèles vidéo.
Pas une édition : nouveau sujet à partir de zéro → p-image. Essayage de vêtements à partir de photos de produit → p-image-try-on.
Multi-références (jusqu'à 5) : indexer les références par rôle — par exemple, composition à trois références : visage de l'image 1, tenue de l'image 2, café de l'image 3 ; turbo: false pour les compositions difficiles. Modèle complet dans image-prompting p-image-edit-prompting.
Entrée requise
prompt(chaîne)images(tableau de 1 à 5 URLs, typiquementhttps://api.pruna.ai/v1/files/{id})
Champs optionnels courants
aspect_ratio:match_input_image,1:1,16:9,9:16, etc.turbo(booléen, défaut true ; désactiver pour les éditions plus difficiles)seed,disable_safety_checker
Étapes suivantes typiques
Suites courantes après cette compétence :
| Compétence | Description | Installation |
|---|---|---|
p-image-upscale | À utiliser lorsque quelqu'un souhaite upscaler ou affiner une image existante pour l'impression, les gros recadrages ou une livraison de meilleure qualité. | npx skills add PrunaAI/pruna-skills@p-image-upscale -y |
p-video-2-pro | À utiliser lorsque quelqu'un souhaite un clip cinématographique à partir de texte ou d'images de début/fin — publicités de produits, plans documentaires ou dialogues avec audio généré. Pas pour le 1080p, les pistes audio importées ou les présentateurs en plan poitrine uniquement. | npx skills add PrunaAI/pruna-skills@p-video-2-pro -y |
p-video-2 | À utiliser lorsque quelqu'un souhaite un clip court soigné à partir de texte, d'images ou d'audio importé — B-roll 1080p, animation d'image de début/fin ou plan de mouvement avec piste mixte. Pas pour les clips avec audio généré cinématographique ou les présentateurs en plan poitrine uniquement. | npx skills add PrunaAI/pruna-skills@p-video-2 -y |
p-video | À utiliser lorsque quelqu'un souhaite un clip court simple à partir de texte ou d'images — B-roll rapide, brouillons ou animation d'image de début/fin. Pas lorsque le brief nécessite une génération cinématographique, la meilleure qualité, un synchronisme labial précis ou de l'audio importé en 1080p. | npx skills add PrunaAI/pruna-skills@p-video -y |
p-video-edit | À utiliser lorsque quelqu'un souhaite éditer une vidéo existante avec une instruction textuelle — recolorier, restyler, supprimer ou ajouter des objets, changer l'environnement ou l'éclairage, mettre à jour le texte à l'écran, ou appliquer des modifications guidées par référence sur des produits et accessoires. Pas pour un nouveau clip à partir de zéro ou un assemblage ffmpeg. | npx skills add PrunaAI/pruna-skills@p-video-edit -y |
p-video-avatar | À utiliser lorsque quelqu'un souhaite voir une personne à l'écran récitant un script — présentateur synchronisé labialement, porte-parole ou avatar narré à partir d'une photo portrait. | npx skills add PrunaAI/pruna-skills@p-video-avatar -y |
avatar-multi-scene | À utiliser lorsque quelqu'un souhaite que la même personne anime plusieurs clips — UGC multi-segments, reels comparatifs ou scènes mixtes parlées et animées avec continuité. | npx skills add PrunaAI/pruna-skills@avatar-multi-scene -y |
narrated-multi-scene | À utiliser lorsque quelqu'un souhaite une histoire en plusieurs parties avec voix off — B-roll épisodique, promotion chapitrée ou plusieurs scènes vidéo liées sans dialogue à l'écran. | npx skills add PrunaAI/pruna-skills@narrated-multi-scene -y |
visual-transition-reel | À utiliser lorsque quelqu'un souhaite un montage avec transitions entre les plans — reel de séquence d'action ou pièce multi-scènes où la narration est optionnelle. | npx skills add PrunaAI/pruna-skills@visual-transition-reel -y |