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
| Étape | Outil | Notes |
|---|---|---|
| Ouvrir le sélecteur de fichiers | asset_add_file | Retourne presignedAssetUrl, assetId et mediaType |
| Trouver un actif dans CC | asset_search | Remettez en scène le résultat via asset_add_file pour l'image ; utilisez id directement pour la vidéo |
| Rendre un fichier PSD/AI | document_render_vector | Convertit en JPEG avant redimensionnement |
| Redimensionner l'image | image_crop_and_resize | Un appel par dimension ; reframe par défaut |
| Prévisualiser les sorties | asset_preview_file | Toutes les sorties en un seul appel |
| Télécharger vers CC (début) | asset_initialize_file_upload | Premier appel dans le pipeline de téléchargement par blocs |
| Télécharger vers CC (fin) | asset_finalize_file_upload | Deuxième appel ; retourne une URL CC pré-signée pour le tableau |
| Créer un tableau Firefly | create_firefly_board | Passez import_adobe_storage avec l'URL finalisée |
| Redimensionner la vidéo | video_resize | Retourne statusId pour le sondage |
| Sonder le redimensionnement vidéo | resizeVideoPoll | Outil 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 IMAGEvideo/*→ WORKFLOW VIDÉO
Étape 4 — Résoudre les Dimensions Cibles
| L'utilisateur dit | Résoudre en |
|---|---|
1920×1080, 1920x1080 | width: 1920, height: 1080 |
4K | 3840 × 2160 |
HD, 1080p | 1920 × 1080 |
720p | 1280 × 720 |
480p | 854 × 480 |
A4 impression | 2480 × 3508 (300 DPI portrait) |
Letter impression | 2550 × 3300 (300 DPI portrait) |
16:9, 1:1, 4:5, 9:16 | chaîne de ratio → passer comme output: "16:9" |
square | output: "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 :
presignedAssetUrldeasset_add_file()✅outputUrld'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/❌ renditionURLdeasset_searchdirectement ❌- Les URI
file://❌
| Source | Résolution |
|---|---|
| Fichier téléchargé | asset_add_file() → presignedAssetUrl |
| Actif stockage CC | asset_search → remettre en scène via asset_add_file() → presignedAssetUrl |
| Sortie d'outil antérieur | Utilisez outputUrl directement |
| Fichier PSD / AI | document_render_vector (JPEG, 300 DPI) → outputPresignedUrl |
Étape 6 (Image) — Mode d'Ajustement
| Intention | Mode | Notes |
|---|---|---|
| "redimensionner à LxH" / par défaut | reframe | Recadrage le plus grand au ratio cible, centré — pas de distorsion |
| "pas de recadrage", "letterbox", "ajuster à l'intérieur" | pad | Remplit l'espace vide avec du blanc |
| "isoler le sujet", "recadrage serré" | extract | Recadrage 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 omettezoutput.
É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 :
- Appelez
asset_add_file()pour chaque fichier afin d'obtenir des URL pré-signées individuelles - Appelez
image_crop_and_resizepour chacun avec les mêmes paramètres - Collectez toutes les valeurs
outputUrl - Appelez
asset_preview_fileavec 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_storageavec des URL pré-signées deasset_finalize_file_uploadremplit correctement les tableaux.❌ Ne fonctionne pas :
import_generic_assetsavec 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.
| Source | Comment |
|---|---|
Téléchargement via asset_add_file | Utilisez le assetId retourné |
| Stockage CC | asset_search avec filters.mediaType: "video/mp4" → utilisez id de l'actif |
Étape 6 (Vidéo) — Cibles Courantes
| Nom | Dimensions |
|---|---|
| 4K / UHD | 3840 × 2160 |
| 1080p / HD | 1920 × 1080 |
| 720p | 1280 × 720 |
| 480p | 854 × 480 |
| Vertical 9:16 | 1080 × 1920 |
| Carré 1:1 | 1080 × 1080 |
Étape 7 (Vidéo) — Appeler video_resize
⚠️
resizeVideoPollest 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 dit | Valeur API | Comportement |
|---|---|---|
| "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énario | Comportement |
|---|---|
| L'utilisateur sélectionne plusieurs préréglages | Un appel outil par dimension, même URI source, prévisualisation unique en fin |
| L'utilisateur fournit plusieurs fichiers | asset_add_file pour chacun, puis redimensionnement avec les mêmes paramètres |
| Combinaison : plusieurs fichiers × plusieurs dimensions | Toutes 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).