Communitygithub.com

Adobe Redimensionner Photos et Vidéos

Redimensionne des photos et des vidéos à des dimensions précises en pixels ou à un rapport d'aspect donné à l'aide des outils Adobe.

Qu'est-ce que Adobe Redimensionner Photos et Vidéos ?

Cette compétence permet de redimensionner des images et des vidéos à des dimensions exactes, telles que 1920x1080, 4K, A4, ou un rapport d'aspect comme 16:9, en utilisant les outils d'Adobe via l'API Adobe pour la créativité. Elle prend en charge les workflows pour les photos (via `image_crop_and_resize`) et les vidéos (via `video_resize`), avec des options pour le mode d'ajustement (recadrage, letterbox, extraction de sujet), le focus intelligent, le traitement par lots, et l'exportation vers Creative Cloud ou un tableau Firefly. La compétence gère l'ensemble du pipeline, de l'obtention du fichier source (téléchargement ou stockage CC) à la prévisualisation et à la livraison des résultats. Elle nécessite que l'utilisateur fournisse le type de média (photo ou vidéo), les dimensions souhaitées, et le mode d'ajustement ; en cas d'ambiguïté, elle pose des questions interactives pour clarifier les paramètres.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/adobe/skills/tree/HEAD/plugins/creative-cloud/adobe-for-creativity/skills/adobe-resize-photos-and-videos

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Adobe Redimensionner Photos et Vidéos ?

Redimensionne des images ou des vidéos aux dimensions, au rapport d'aspect ou à la taille nommée spécifiés par l'utilisateur. Pour les ensembles de plateformes de médias sociaux (Instagram, TikTok, etc.) → utilisez plutôt la compétence adobe-create-social-variations.


Référence des Outils

ÉtapeOutilNotes
Ouvrir le sélecteur de fichiersasset_add_fileRetourne presignedAssetUrl, assetId et mediaType
Trouver un actif dans CCasset_searchRemettez en scène le résultat via asset_add_file pour l'image ; utilisez id directement pour la vidéo
Rendre un fichier PSD/AIdocument_render_vectorConvertit en JPEG avant redimensionnement
Redimensionner l'imageimage_crop_and_resizeUn appel par dimension ; reframe par défaut
Prévisualiser les sortiesasset_preview_fileToutes les sorties en un seul appel
Télécharger vers CC (début)asset_initialize_file_uploadPremier appel dans le pipeline de téléchargement par blocs
Télécharger vers CC (fin)asset_finalize_file_uploadDeuxième appel ; retourne une URL CC pré-signée pour le tableau
Créer un tableau Fireflycreate_firefly_boardPassez import_adobe_storage avec l'URL finalisée
Redimensionner la vidéovideo_resizeRetourne statusId pour le sondage
Sonder le redimensionnement vidéoresizeVideoPollOutil différé — chargez-le avant d'appeler

Workflow

Étape 0 — Initialiser les Outils Adobe

Appelez adobe_mandatory_init en premier. Cela retourne les règles de gestion des fichiers et les directives de routage des outils nécessaires pour le reste du workflow.

{ "skill_name": "adobe-resize-photos-and-videos", "skill_version": "1.1.0" }

Étape 1 — Vérification des Droits

Maintenant que adobe_mandatory_init a confirmé que le connecteur "Adobe for creativity" est actif, vérifiez quels outils sont disponibles via le connecteur "Adobe for creativity" en recoupant avec le tableau Référence des Outils ci-dessus.


ACTION IMMÉDIATE REQUISE

Étape 1 : Si des paramètres sont manquants ou ambigus → exécutez le processus de saisie en plusieurs étapes (Étape 2 ci-dessous). Étape 2 : Si aucun fichier n'est téléchargé, exécutez l'Étape 3 (asset_add_file({})). Étape 3 : Détectez image vs. vidéo et acheminez vers le bon workflow (Étape 5 Image/Vidéo).


Étape 2 — Saisie en Plusieurs Étapes

Exécutez cette étape lorsque l'utilisateur n'a pas fourni de paramètres complets (type + dimensions + mode d'ajustement). Ignorez-la entièrement si le message de l'utilisateur contient déjà les trois.

Utilisez AskUserQuestion pour collecter les paramètres étape par étape.

Étape 2a — Type

AskUserQuestion([{
  question: "Photo ou vidéo ?",
  type: "single_select",
  options: ["Photo", "Vidéo"]
}])

Étape 2b — Dimensions

Si Photo (multi_select — l'utilisateur peut en choisir une ou plusieurs) :

AskUserQuestion([{
  question: "Dimensions — sélectionnez toutes celles dont vous avez besoin",
  type: "multi_select",
  options: [
    "1080 × 1080 — Carré Instagram",
    "1080 × 1350 — Portrait Instagram",
    "1080 × 1920 — Stories / Reels",
    "1920 × 1080 — YouTube / paysage",
    "1280 × 720 — Vignette YouTube",
    "1200 × 675 — Publication X / Twitter",
    "1200 × 630 — Facebook / image OG",
    "1080 × 566 — Publication LinkedIn",
    "2560 × 1440 — Bannière YouTube",
    "3840 × 2160 — 4K / UHD",
    "400 × 400 — Profil / avatar",
    "2480 × 3508 — Impression A4 (300 dpi)",
    "Personnalisé — Je vais le taper"
  ]
}])

Si l'utilisateur inclut "Personnalisé" → suivi : "Entrez vos dimensions personnalisées (ex. 1500×800) :"

Si l'utilisateur sélectionne plusieurs préréglages → exécutez image_crop_and_resize une fois par dimension, en utilisant la même URI source et les mêmes paramètres à chaque fois. Prévisualisez toutes les sorties ensemble à la fin.

Si Vidéo (multi_select — l'utilisateur peut en choisir une ou plusieurs) :

AskUserQuestion([{
  question: "Dimensions — sélectionnez toutes celles dont vous avez besoin",
  type: "multi_select",
  options: [
    "1080 × 1920 — Reels / TikTok / Stories",
    "1920 × 1080 — YouTube / paysage",
    "1080 × 1080 — Publication carrée",
    "1280 × 720 — YouTube 720p",
    "3840 × 2160 — 4K / UHD",
    "854 × 480 — SD / 480p",
    "Personnalisé — Je vais le taper"
  ]
}])

Si l'utilisateur sélectionne plusieurs préréglages vidéo → soumettez un travail video_resize séparé par dimension, sondez chaque travail jusqu'à son achèvement, prévisualisez toutes les sorties ensemble.

Étape 2c — Mode d'Ajustement

Si Photo (single_select) :

AskUserQuestion([{
  question: "Mode d'ajustement",
  type: "single_select",
  options: [
    "Recadrer — recadrer pour remplir",
    "Letterbox — boîte aux lettres, sans recadrage",
    "Extraire — isoler le sujet"
  ]
}])

Si Vidéo (single_select) :

AskUserQuestion([{
  question: "Mode d'ajustement",
  type: "single_select",
  options: [
    "Letterbox — préserver le ratio",
    "Recadrer — remplir, sans barres",
    "Étirer — forcer exact (déformer)"
  ]
}])

Étape 2d — Focus Intelligent (Photo uniquement)

AskUserQuestion([{
  question: "Focus intelligent — où doit se centrer le recadrage ?",
  type: "single_select",
  options: [
    "Sujet",
    "Visage / portrait",
    "Haut du corps",
    "Centre (géométrique)",
    "Objet nommé — Je vais le décrire"
  ]
}])

Si l'utilisateur sélectionne "Objet nommé" → suivi : "Décrivez l'objet (ex. 'la voiture rouge', 'le logo') :"

Étape 2e — Options (Photo uniquement)

AskUserQuestion([{
  question: "Options supplémentaires ?",
  type: "multi_select",
  options: [
    "Lot — plusieurs images",
    "Sortie : JPEG",
    "Sortie : PNG"
  ]
}])

Étape 2f — Source (Vidéo uniquement)

AskUserQuestion([{
  question: "Où se trouve la vidéo ?",
  type: "single_select",
  options: [
    "Télécharger depuis l'appareil",
    "Depuis Creative Cloud"
  ]
}])

Étape 3 — Obtenir le Fichier Source

Critique — Les chemins /mnt/user-data/uploads/ ne sont PAS des URL utilisables. Même lorsque l'utilisateur a joint un fichier et qu'il apparaît dans le contexte à un chemin /mnt/user-data/uploads/, vous NE pouvez PAS passer ce chemin à un outil Adobe. Appelez asset_add_file() pour mettre en scène le fichier — les chemins /mnt/user-data/uploads/ ne sont pas accessibles par les outils Adobe.

MAUVAIS  ❌  imageURI: "/mnt/user-data/uploads/photo.jpg"
MAUVAIS  ❌  imageURI: "file:///mnt/user-data/uploads/photo.jpg"
CORRECT  ✅  appeler asset_add_file() → utiliser presignedAssetUrl depuis le contexte du sélecteur

Pas encore de fichier → ouvrez le sélecteur immédiatement :

asset_add_file()

Détectez le type à partir du mediaType retourné :

  • image/* → WORKFLOW IMAGE
  • video/* → WORKFLOW VIDÉO

Étape 4 — Résoudre les Dimensions Cibles

L'utilisateur ditRésoudre en
1920×1080, 1920x1080width: 1920, height: 1080
4K3840 × 2160
HD, 1080p1920 × 1080
720p1280 × 720
480p854 × 480
A4 impression2480 × 3508 (300 DPI portrait)
Letter impression2550 × 3300 (300 DPI portrait)
16:9, 1:1, 4:5, 9:16chaîne de ratio → passer comme output: "16:9"
squareoutput: "1:1"
Largeur uniquement (800px wide)width: 800, utiliser la chaîne de ratio pour maintenir l'aspect

Si aucune cible n'a été spécifiée dans le formulaire ET aucune dans le message de l'utilisateur → demandez :

"De quelles dimensions avez-vous besoin ? (ex. 1920×1080, A4, 16:9)"


WORKFLOW IMAGE

Étape 5 (Image) — Sources URI Valides

Seules ces sources fonctionnent comme imageURI :

  • presignedAssetUrl de asset_add_file() ✅
  • outputUrl d'un appel d'outil antérieur ✅
  • URL HTTPS publique fournie par l'utilisateur ✅

Ne peuvent pas être utilisées comme imageURI :

  • Les chemins /mnt/user-data/uploads/ ❌
  • renditionURL de asset_search directement ❌
  • Les URI file:// ❌
SourceRésolution
Fichier téléchargéasset_add_file() → presignedAssetUrl
Actif stockage CCasset_search → remettre en scène via asset_add_file() → presignedAssetUrl
Sortie d'outil antérieurUtilisez outputUrl directement
Fichier PSD / AIdocument_render_vector (JPEG, 300 DPI) → outputPresignedUrl

Étape 6 (Image) — Mode d'Ajustement

IntentionModeNotes
"redimensionner à LxH" / par défautreframeRecadrage le plus grand au ratio cible, centré — pas de distorsion
"pas de recadrage", "letterbox", "ajuster à l'intérieur"padRemplit l'espace vide avec du blanc
"isoler le sujet", "recadrage serré"extractRecadrage serré autour de la région détectée

Par défaut : reframe. Changez uniquement lorsque l'utilisateur est explicite.

⛔ fit: "extract" est incompatible avec un { width, height } explicite — il étire l'image. Utilisez une chaîne de ratio ou omettez output.


Étape 7 (Image) — Appeler image_crop_and_resize

image_crop_and_resize({
  imageURI: presignedAssetUrl,
  options: {
    output: { width: 1920, height: 1080 },  // ou "16:9"
    fit: "reframe",
    focus: "subject",  // ou "face", "upper_body", { prompt: "la voiture" }, { x:0.5, y:0.5 }
    quality: 7
  },
  outputFileType: "jpeg"  // ou "png" si la transparence est nécessaire
})
// result.outputUrl → utiliser pour la prévisualisation ou le chaînage

Guide du focus :

  • "subject" — par défaut ; détection du corps entier, paysages, objets
  • "face" — portraits, photos de visage
  • "upper_body" — recadrages au niveau de la poitrine
  • { prompt: "le logo" } — objet nommé à partir de la saisie du formulaire utilisateur
  • { x: 0.5, y: 0.5 } — centre géométrique (pas de sujet clair)

Étape 8 (Image) — Lot

Si le lot a été sélectionné dans le formulaire OU l'utilisateur a fourni plusieurs fichiers :

  1. Appelez asset_add_file() pour chaque fichier afin d'obtenir des URL pré-signées individuelles
  2. Appelez image_crop_and_resize pour chacun avec les mêmes paramètres
  3. Collectez toutes les valeurs outputUrl
  4. Appelez asset_preview_file avec toutes les sorties en un seul appel

Les appels s'exécutent séquentiellement dans cet environnement. Pour >10 images, confirmez avec l'utilisateur avant de commencer.

Pagination entre les tours (lots >20) : Pour les lots volumineux, le contexte de la conversation peut se remplir avant que toutes les images soient traitées, ce qui amène Claude à faire une pause au milieu du lot. C'est attendu — pas une erreur. Quand cela se produit :

  • Indiquez combien ont été terminées et combien restent (ex. "20 / 24 terminés — dites 'continuer' pour le reste")
  • Attendez que l'utilisateur confirme avant de reprendre
  • À la reprise, reprenez à partir de l'image non traitée suivante et continuez jusqu'à la fin
  • Prévisualisez toutes les sorties ensemble uniquement après la dernière image terminée

Étape 9 (Image) — Prévisualisation + Livraison + Tableau Firefly

asset_preview_file({
  assets: [
    { name: "photo_1920x1080.jpg", presignedAssetUrl: result.outputUrl },
    // toutes les sorties réussies
  ]
})

Enregistrer dans CC + Créer un Tableau Firefly

Après la prévisualisation, téléchargez chaque sortie vers le stockage CC en utilisant le pipeline de téléchargement par blocs (asset_initialize_file_upload → PUT chunk → asset_finalize_file_upload).

Appelez ensuite l'outil du tableau Firefly avec les URL de sortie finales :

create_firefly_board({
  import_adobe_storage: [
    final_output_url_1,
    final_output_url_2,
    // ...
  ]
})

✅ Confirmé fonctionnel (Stage) : import_adobe_storage avec des URL pré-signées de asset_finalize_file_upload remplit correctement les tableaux.

❌ Ne fonctionne pas : import_generic_assets avec des IDs d'actifs CC (urn:aaid:sc:US:...) — un décalage d'indexation USS provoque des tableaux vides.

Si la création du tableau échoue ou si l'URL est mal formée, omettez le lien du tableau (réessayer n'aide pas).

Publiez le résumé de fin après l'étape du tableau :

✅ Terminé ! [N] image(s) redimensionnée(s) et prête(s).

📥 Téléchargement :
• redimensionnee_1920x1080.jpg → <cc_storage_url>
[liste individuellement si N ≤ 3, ou lien de dossier unique si N > 3]

🎨 Voir dans le tableau Firefly → <board_url>   ← omettre si la création du tableau a échoué

WORKFLOW VIDÉO

Étape 5 (Vidéo) — Obtenir l'ID de l'Actif

Les outils vidéo nécessitent assetId, pas une URL.

SourceComment
Téléchargement via asset_add_fileUtilisez le assetId retourné
Stockage CCasset_search avec filters.mediaType: "video/mp4" → utilisez id de l'actif

Étape 6 (Vidéo) — Cibles Courantes

NomDimensions
4K / UHD3840 × 2160
1080p / HD1920 × 1080
720p1280 × 720
480p854 × 480
Vertical 9:161080 × 1920
Carré 1:11080 × 1080

Étape 7 (Vidéo) — Appeler video_resize

⚠️ resizeVideoPoll est un outil différé — chargez-le d'abord avant d'essayer de sonder. Les appels directs sans chargement échoueront avec une erreur "not loaded".

video_resize({
  assetId: videoAssetId,
  width: targetW,
  height: targetH,
  mode: "letterbox"  // par défaut ; voir le tableau des modes ci-dessous
})
// Retourne { jobStatus: "pending", statusId }

Mode — utilisez les valeurs exactes de l'API (pas les libellés utilisateur) :

L'utilisateur ditValeur APIComportement
"ajuster", "préserver le ratio", "letterbox""letterbox"Préserve le ratio, ajoute des barres noires (par défaut)
"remplir", "recadrer pour remplir", "pas de barres""crop"Recadre les bords pour remplir exactement la cible
"étirer", "forcer exact""stretch"Déforme pour atteindre exactement la cible

ℹ️ Le recadrage automatique pour la vidéo n'est pas encore disponible dans Claude, mais de nouveaux outils sont ajoutés régulièrement. Si vous avez besoin de plus de contrôle, essayez d'utiliser Adobe Premiere.

Sondage : chargez l'outil différé resizeVideoPoll avant de l'appeler — les appels directs échouent avec "not loaded".

// Étape 1 : chargez l'outil différé

Étape 7 (Vidéo) — Sonde le Travail

resizeVideoPoll({
  statusId: returnedStatusId
})

Sondez jusqu'à ce que jobStatus soit "completed" ou "failed". Utilisez un intervalle de 5 secondes entre les sondes.

Étape 8 (Vidéo) — Prévisualisation + Livraison

asset_preview_file({
  assets: [
    { name: "video_1920x1080.mp4", presignedAssetUrl: result.outputUrl },
    // toutes les sorties réussies
  ]
})

Enregistrer dans CC + Créer un Tableau Firefly

Comme pour le workflow image, après la prévisualisation, téléchargez chaque sortie vers le stockage CC en utilisant le pipeline de téléchargement par blocs, puis créez un tableau Firefly.

✅ Terminé ! [N] vidéo(s) redimensionnée(s) et prête(s).

📥 Téléchargement :
• redimensionnee_1920x1080.mp4 → <cc_storage_url>

🎨 Voir dans le tableau Firefly → <board_url>   ← omettre si la création du tableau a échoué

Comportement pour les Lots Multiples

ScénarioComportement
L'utilisateur sélectionne plusieurs préréglagesUn appel outil par dimension, même URI source, prévisualisation unique en fin
L'utilisateur fournit plusieurs fichiersasset_add_file pour chacun, puis redimensionnement avec les mêmes paramètres
Combinaison : plusieurs fichiers × plusieurs dimensionsToutes les combinaisons sont traitées ; confirmez d'abord pour >5 sessions

Soyez attentif à la longueur du contexte — pour les lots volumineux, utilisez une pagination de type "continuer" (voir Étape 8 Image).

Skills associés