Prérequis
Installez et chargez ces compétences avant de générer (ignorer si déjà dans le contexte via @pruna):
| Compétence | Description | Installer |
|---|---|---|
generation-diversity | À utiliser lors de la rédaction de tout prompt génératif — rituel de seed, structure explicite, axes de scénario et contrôles de qualité avant les appels API payants. | npx skills add PrunaAI/pruna-skills@generation-diversity -y |
image-prompting | À utiliser lors de la création de prompts d'image fixe pour tout modèle génératif — composition, fiches d'identité, retouches, essayage virtuel et personnages photoréalistes. | npx skills add PrunaAI/pruna-skills@image-prompting -y |
pruna-api | À utiliser 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 la suite complète en une fois : npx skills add PrunaAI/pruna-skills@pruna -y
Suivez les sections Avant de générer / craft de chaque compétence — ne répétez pas le contenu du guide ici.
Habitude de l'agent
Routage : Utilisez `p-image` pour une génération de photos simple et rapide à partir d'un prompt court. Quand la génération de photos nécessite plus de contrôle (texte dans l'image, JSON structuré avec hex/bbox, photoréalisme haute définition), utilisez `p-image-ideogram` (par défaut thinking: high, prompt_upsampling: true ; low + prompt_upsampling: false + prompt explicite pour un passage plus rapide sur le même modèle). Pour les retouches ou la vidéo, utilisez `p-image-edit` ou `p-video-2` — pas une nouvelle génération de photo.
Dans la première réponse, mentionnez `p-image` entre guillemets, confirmez que PRUNA_API_KEY est définie (ou arrêtez avec des liens d'inscription depuis pruna-api), puis demandez le prompt / le rapport d'aspect (ouverture de collecte → clarification de collecte generation-diversity). Lors de la rédaction du prompt, suivez Craft du prompt (dynamique + fidèle) — ne copiez pas les exemples de la compétence.
Craft du prompt (dynamique + fidèle)
Chaque input.prompt doit être frais et spécifique, et doit respecter la demande de l'utilisateur. La diversité ne remplace jamais le brief.
| À faire | À ne pas faire |
|---|---|
Exécutez le rituel de seed aléatoire generation-diversity ; mentionnez-le ; faites varier ≥2 axes libres (appareil photo, éclairage, texture du décor, catégorie de rendu) | Copiez des exemples curl de cette compétence (otter DJ, corgi cowboy, …) ou réutilisez un prompt d'une session précédente |
| Verrouillez d'abord les faits demandés par l'utilisateur (sujet, produit, indices de marque, accessoires à conserver, texte lisible si demandé) | Remplacez le sujet par une scène "plus cool" qui ignore la demande |
Enrichissez avec des noms concrets, une action figée, des matériaux, un placement (règles d'or de image-prompting) | Chaînes vagues basées uniquement sur l'ambiance (cool product vibe, neon) |
Montrez le prompt rédigé + aspect_ratio avant le POST si l'utilisateur n'a pas encore validé le wording | Re-générez en silence avec un sujet différent de celui approuvé |
Vérification de fidélité (avant de payer) : si vous supprimez le sujet/produit/décor nommé par l'utilisateur du prompt, le travail est erroné — réécrivez. Les axes libres ne remplissent que ce que le brief a laissé ouvert.
Lors de la présentation d'un prompt rédigé, mentionnez toujours `p-image` (les guides aident à la rédaction ; c'est cet outil qui possède l'appel).
Note Pruna : p-image n'a pas de remontée de prompt — un langage concret est l'essence même du craft. Évitez la typographie dense et lisible sauf si l'utilisateur a explicitement demandé du texte sur une surface.
Quand NE PAS utiliser
Utilisez une autre compétence :
| Compétence | Description | Installer |
|---|---|---|
p-image-ideogram | À utiliser quand la génération de photos nécessite plus de contrôle — résultats photoréalistes, texte dans l'image, ou JSON structuré avec couleurs hex et boîtes englobantes. Les générations de photos plus simples, les retouches et la vidéo utilisent d'autres compétences de la suite. | npx skills add PrunaAI/pruna-skills@p-image-ideogram -y |
p-image-edit | À utiliser quand quelqu'un souhaite modifier une photo existante — changer les tenues ou les fonds, composer à partir d'images de référence, ou appliquer des retouches guidées par un prompt. | npx skills add PrunaAI/pruna-skills@p-image-edit -y |
p-image-try-on | À utiliser quand quelqu'un souhaite un essayage virtuel — habiller une personne avec des vêtements à partir de photos de référence pour la mode ou l'e-commerce. | npx skills add PrunaAI/pruna-skills@p-image-try-on -y |
HTTP (curl)
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' \
-d '{
"input": {
"prompt": "Reflets de boule à facettes sur une loutre DJ grattant un vinyle dans une patinoire bondée des années 1970, objectif fish-eye, confettis scintillants en suspension, énergie funky",
"aspect_ratio": "9:16"
}
}'
Interrogez et téléchargez : suivez pruna-api.
Effectuez le rituel de seed aléatoire de generation-diversity avant d'écrire les prompts — ne passez pas la chaîne du rituel comme seed de l'API. api_seed optionnel seulement si 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' \
-H 'Try-Sync: true' \
-d '{"input":{"prompt":"Corgi cowboy lassant un camion à tacos en fuite dans une tempête de poussière à Monument Valley, énergie d\'affiche western pulp, composition diagonale dynamique","aspect_ratio":"16:9"}}'
Flux de génération
Suivez le flux de prompt d'image fixe de generation-diversity à chaque fois :
- Verrouiller le brief — sujet utilisateur, produit, format, tout texte sur surface.
- Seed rituel — chaîne fraîche ; dérivez les axes libres (appareil photo, éclairage,
render_category_tag,aspect_ratioquand non défini). - Rédiger un prompt explicite — Craft du prompt (dynamique + fidèle) + règles d'or de
image-prompting; vérification de fidélité avant de payer. - Confirmer — montrez
prompt+aspect_ratiosauf si le wording est verrouillé. - POST — curl asynchrone ci-dessous ; interrogez via
pruna-api; exécutez la liste de contrôle qualitép-imageavant upscale/vidéo.
Rapport d'aspect : passez aspect_ratio dans input ; si les dimensions de sortie ne correspondent pas (ex. demandé 16:9, obtenu portrait), réessayez une fois avec un wording explicite horizontal wide / vertical dans le prompt.
Mood board / lot : nouveau rituel par image indépendante ; aspect_ratio différent par panneau si le format n'est pas verrouillé.
Photo approuvée → retouche : passez à p-image-edit sur l'URL de sortie — ne relancez pas la génération photo pour le même sujet.
Entrée requise
prompt(string)
Champs optionnels courants
aspect_ratio:1:1,16:9,9:16,4:3,3:4,3:2,2:3,custom(avecwidth/heightmultiples de 16, 256–1440)seed,lora_weights,lora_scale,hf_api_token,disable_safety_checker
Prochaines étapes typiques
Suites courantes après cette compétence :
| Compétence | Description | Installer |
|---|---|---|
p-image-edit | À utiliser quand quelqu'un souhaite modifier une photo existante — changer les tenues ou les fonds, composer à partir d'images de référence, ou appliquer des retouches guidées par un prompt. | npx skills add PrunaAI/pruna-skills@p-image-edit -y |
p-image-try-on | À utiliser quand quelqu'un souhaite un essayage virtuel — habiller une personne avec des vêtements à partir de photos de référence pour la mode ou l'e-commerce. | npx skills add PrunaAI/pruna-skills@p-image-try-on -y |
p-image-upscale | À utiliser quand quelqu'un souhaite upscaler ou accentuer une image existante pour l'impression, des recadrages importants ou une livraison de meilleure qualité. | npx skills add PrunaAI/pruna-skills@p-image-upscale -y |
p-video-2-pro | À utiliser quand quelqu'un 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 1080p, pistes audio importées ou présentateurs uniquement en plan poitrine. | npx skills add PrunaAI/pruna-skills@p-video-2-pro -y |
p-video-2 | À utiliser quand quelqu'un souhaite un court clip soigné à partir de texte, d'images ou d'audio importé — B-roll 1080p, animation d'images de début/fin, ou plan mouvementé avec piste mixte. Pas pour les clips audio générés cinématographiques ou les présentateurs uniquement en plan poitrine. | npx skills add PrunaAI/pruna-skills@p-video-2 -y |
p-video | À utiliser quand quelqu'un souhaite un court clip simple à partir de texte ou d'images — B-roll rapide, brouillons ou animation d'images de début/fin. Pas quand le brief nécessite une génération cinématographique, la plus haute qualité, un lip-sync serré ou un audio importé en 1080p. | npx skills add PrunaAI/pruna-skills@p-video -y |
avatar-single-scene | À utiliser quand quelqu'un souhaite un plan soigné d'un présentateur à l'écran — une personne qui parle avec des validations d'intention et de qualité avant la génération. | npx skills add PrunaAI/pruna-skills@avatar-single-scene -y |
avatar-multi-scene | À utiliser quand quelqu'un souhaite que la même personne anime plusieurs clips — contenu UGC multi-segments, bobines comparatives, ou scènes mixtes parlées et animées avec continuité. | npx skills add PrunaAI/pruna-skills@avatar-multi-scene -y |