Adobe Fotos und Videos in der Größe ändern
Ändert die Größe von Bildern oder Videos auf benutzerdefinierte Abmessungen, Seitenverhältnisse oder benannte Größen.
Für Social-Media-Plattform-Sets (Instagram, TikTok usw.) → stattdessen das adobe-create-social-variations-Skill verwenden.
Werkzeugreferenz
| Schritt | Werkzeug | Notizen |
|---|---|---|
| Dateiauswahl öffnen | asset_add_file | Gibt presignedAssetUrl, assetId und mediaType zurück |
| Asset in CC suchen | asset_search | Ergebnis für Bilder über asset_add_file neu bereitstellen; id direkt für Videos verwenden |
| PSD/AI rendern | document_render_vector | Konvertiert vor der Größenänderung in JPEG |
| Bildgröße ändern | image_crop_and_resize | Ein Aufruf pro Dimension; reframe standardmäßig |
| Vorschau der Ausgaben | asset_preview_file | Alle Ausgaben in einem einzigen Aufruf |
| In CC hochladen (Start) | asset_initialize_file_upload | Erster Aufruf im Block-Upload-Pipeline |
| In CC hochladen (Ende) | asset_finalize_file_upload | Zweiter Aufruf; gibt signierte CC-URL für das Board zurück |
| Firefly-Board erstellen | create_firefly_board | import_adobe_storage mit der Finalize-URL übergeben |
| Videogröße ändern | video_resize | Gibt statusId für Polling zurück |
| Polling der Videogrößenänderung | resizeVideoPoll | Deferred-Tool – vor dem Aufruf laden |
Arbeitsablauf
Schritt 0 – Adobe-Tools initialisieren
Zuerst adobe_mandatory_init aufrufen. Dies gibt Dateiverarbeitungsregeln und Tool-Routing-Anleitungen zurück, die für den Rest des Arbeitsablaufs erforderlich sind.
{ "skill_name": "adobe-resize-photos-and-videos", "skill_version": "1.1.0" }
Schritt 1 – Berechtigungsprüfung
Nachdem adobe_mandatory_init bestätigt hat, dass der Connector „Adobe for creativity“ aktiv ist, prüfen, welche Tools über diesen Connector verfügbar sind, indem die obige Werkzeugreferenz-Tabelle abgeglichen wird.
SOFORTIGE MASSNAHME ERFORDERLICH
Schritt 1: Wenn Parameter fehlen oder mehrdeutig sind → die mehrstufige Eingabe (Schritt 2 unten) ausführen.
Schritt 2: Wenn keine Datei hochgeladen wurde, Schritt 3 (asset_add_file({})) ausführen.
Schritt 3: Bild vs. Video erkennen und zum richtigen Arbeitsablauf leiten (Schritt 5 Bild/Video).
Schritt 2 – Mehrstufige Eingabe
Ausführen, wenn der Benutzer keine vollständigen Parameter (Typ + Abmessungen + Anpassungsmodus) angegeben hat. Vollständig überspringen, wenn die Nachricht des Benutzers bereits alle drei enthält.
AskUserQuestion verwenden, um Parameter Schritt für Schritt zu sammeln.
Schritt 2a – Typ
AskUserQuestion([{
question: "Foto oder Video?",
type: "single_select",
options: ["Foto", "Video"]
}])
Schritt 2b – Abmessungen
Wenn Foto (multi_select – Benutzer kann eine oder mehrere auswählen):
AskUserQuestion([{
question: "Abmessungen – wählen Sie alle, die Sie benötigen",
type: "multi_select",
options: [
"1080 × 1080 – Instagram Quadrat",
"1080 × 1350 – Instagram Hochformat",
"1080 × 1920 – Stories / Reels",
"1920 × 1080 – YouTube / Querformat",
"1280 × 720 – YouTube Thumbnail",
"1200 × 675 – X / Twitter Post",
"1200 × 630 – Facebook / OG Image",
"1080 × 566 – LinkedIn Post",
"2560 × 1440 – YouTube Banner",
"3840 × 2160 – 4K / UHD",
"400 × 400 – Profil / Avatar",
"2480 × 3508 – A4 Druck (300 dpi)",
„Benutzerdefiniert – Ich gebe es ein“
]
}])
Wenn der Benutzer „Benutzerdefiniert“ auswählt → nachfragen: „Geben Sie Ihre benutzerdefinierten Abmessungen ein (z.B. 1500×800):“
Wenn der Benutzer mehrere Voreinstellungen auswählt → image_crop_and_resize einmal pro Dimension ausführen,
wobei jedes Mal dieselbe Quell-URI und dieselben Parameter verwendet werden. Alle Ausgaben am Ende gemeinsam als Vorschau anzeigen.
Wenn Video (multi_select – Benutzer kann eine oder mehrere auswählen):
AskUserQuestion([{
question: "Abmessungen – wählen Sie alle, die Sie benötigen",
type: "multi_select",
options: [
"1080 × 1920 – Reels / TikTok / Stories",
"1920 × 1080 – YouTube / Querformat",
"1080 × 1080 – Quadratischer Post",
"1280 × 720 – YouTube 720p",
"3840 × 2160 – 4K / UHD",
„854 × 480 – SD / 480p",
„Benutzerdefiniert – Ich gebe es ein“
]
}])
Wenn der Benutzer mehrere Video-Voreinstellungen auswählt → einen separaten video_resize-Job pro Dimension einreichen,
jeden bis zum Abschluss abfragen, alle Ausgaben gemeinsam als Vorschau anzeigen.
Schritt 2c – Anpassungsmodus
Wenn Foto (single_select):
AskUserQuestion([{
question: "Anpassungsmodus",
type: "single_select",
options: [
„Reframe – zuschneiden, um auszufüllen"
„Pad – Letterbox, kein Zuschnitt“
„Extract – Motiv isolieren“
]
}])
Wenn Video (single_select):
AskUserQuestion([{
question: "Anpassungsmodus",
type: "single_select",
options: [
"Letterbox – Verhältnis beibehalten",
„Zuschneiden – ausfüllen, keine Balken“
„Strecken – exakt erzwingen (verzerren)“
]
}])
Schritt 2d – Intelligenter Fokus (nur Foto)
AskUserQuestion([{
question: "Intelligenter Fokus – wo soll der Zuschnitt zentriert werden?",
type: "single_select",
options: [
"Motiv",
"Gesicht/Portrait",
„Oberkörper“,
"Mitte (geometrisch)",
„Benanntes Objekt – Ich beschreibe es“
]
}])
Wenn der Benutzer „Benanntes Objekt“ auswählt → nachfragen: „Beschreiben Sie das Objekt (z.B. ‚das rote Auto‘, ‚das Logo‘):“
Schritt 2e – Optionen (nur Foto)
AskUserQuestion([{
question: "Zusätzliche Optionen?",
type: "multi_select",
options: [
"Stapel – mehrere Bilder",
"Ausgabe: JPEG",
"Ausgabe: PNG"
]
}])
Schritt 2f – Quelle (nur Video)
AskUserQuestion([{
question: "Wo befindet sich das Video?",
type: "single_select",
options: [
"Vom Gerät hochladen",
"Aus Creative Cloud"
]
}])
Schritt 3 – Quelldatei abrufen
Wichtig – /mnt/user-data/uploads/-Pfade sind KEINE verwendbaren URLs.
Selbst wenn der Benutzer eine Datei angehängt hat und sie im Kontext unter einem /mnt/user-data/uploads/-Pfad erscheint,
können Sie diesen Pfad nicht an ein Adobe-Tool übergeben. Rufen Sie asset_add_file() auf, um die Datei bereitzustellen – /mnt/user-data/uploads/-Pfade können von Adobe-Tools nicht abgerufen werden.
FALSCH ❌ imageURI: "/mnt/user-data/uploads/photo.jpg"
FALSCH ❌ imageURI: "file:///mnt/user-data/uploads/photo.jpg"
RICHTIG ✅ asset_add_file() aufrufen → presignedAssetUrl aus dem Auswahlkontext verwenden
Noch keine Datei → sofort die Auswahl öffnen:
asset_add_file()
Typ aus dem zurückgegebenen mediaType erkennen:
image/*→ BILD-WORKFLOWvideo/*→ VIDEO-WORKFLOW
Schritt 4 – Zielabmessungen auflösen
| Benutzer sagt | Auflösen zu |
|---|---|
1920×1080, 1920x1080 | width: 1920, height: 1080 |
4K | 3840 × 2160 |
HD, 1080p | 1920 × 1080 |
720p | 1280 × 720 |
480p | 854 × 480 |
A4 Druck | 2480 × 3508 (300 DPI Hochformat) |
Letter Druck | 2550 × 3300 (300 DPI Hochformat) |
16:9, 1:1, 4:5, 9:16 | Verhältniszeichenfolge → als output: "16:9" übergeben |
square | output: "1:1" |
Nur Breite (800px breit) | width: 800, Verhältniszeichenfolge verwenden, um Seitenverhältnis beizubehalten |
Wenn kein Ziel im Formular UND in der Benutzernachricht angegeben wurde → fragen:
„Welche Abmessungen benötigen Sie? (z.B. 1920×1080, A4, 16:9)"
BILD-WORKFLOW
Schritt 5 (Bild) – Gültige URI-Quellen
Nur diese funktionieren als imageURI:
presignedAssetUrlvonasset_add_file()✅outputUrlvon einem vorherigen Tool-Aufruf ✅- Öffentliche HTTPS-URL vom Benutzer ✅
Nicht verwendbar als imageURI:
/mnt/user-data/uploads/-Pfade ❌renditionURLvonasset_searchdirekt ❌file://-URIs ❌
| Quelle | Auflösung |
|---|---|
| Hochgeladene Datei | asset_add_file() → presignedAssetUrl |
| CC-Speicher-Asset | asset_search → über asset_add_file() neu bereitstellen → presignedAssetUrl |
| Vorherige Tool-Ausgabe | outputUrl direkt verwenden |
| PSD / AI-Datei | document_render_vector (JPEG, 300 DPI) → outputPresignedUrl |
Schritt 6 (Bild) – Anpassungsmodus
| Absicht | Modus | Notizen |
|---|---|---|
| „Größe auf WxH ändern“ / Standard | reframe | Größter Zuschnitt im Zielverhältnis, zentriert – keine Verzerrung |
| „Kein Zuschnitt“, „Letterbox“, „hineinpassen“ | pad | Füllt leeren Raum mit Weiß |
| „Motiv isolieren“, „enger Zuschnitt“ | extract | Enger Zuschnitt um erkannten Bereich |
Standard: reframe. Nur ändern, wenn der Benutzer explizit ist.
⛔
fit: "extract"ist inkompatibel mit explizitem{ width, height }– es streckt das Bild. Eine Verhältniszeichenfolge verwenden oderoutputweglassen.
Schritt 7 (Bild) – image_crop_and_resize aufrufen
image_crop_and_resize({
imageURI: presignedAssetUrl,
options: {
output: { width: 1920, height: 1080 }, // oder "16:9"
fit: "reframe",
focus: "subject", // oder "face", "upper_body", { prompt: "the car" }, { x:0.5, y:0.5 }
quality: 7
},
outputFileType: "jpeg" // oder "png" bei Transparenzbedarf
})
// result.outputUrl → für Vorschau oder Verkettung verwenden
Fokus-Referenz:
"subject"– Standard; Ganzkörpererkennung, Landschaften, Objekte"face"– Porträts, Kopfaufnahmen"upper_body"– Zuschnitte ab Brusthöhe{ prompt: "the logo" }– benanntes Objekt aus dem Formular des Benutzers{ x: 0.5, y: 0.5 }– geometrischer Mittelpunkt (kein klares Motiv)
Schritt 8 (Bild) – Stapel
Wenn Stapel im Formular ausgewählt wurde ODER der Benutzer mehrere Dateien bereitgestellt hat:
asset_add_file()für jede Datei aufrufen, um individuelle signierte URLs zu erhaltenimage_crop_and_resizefür jede mit denselben Parametern aufrufen- Alle
outputUrl-Werte sammeln asset_preview_filemit allen Ausgaben in einem einzigen Aufruf aufrufen
Aufrufe erfolgen in dieser Umgebung sequenziell. Bei >10 Bildern vor dem Start mit dem Benutzer bestätigen.
Seitenweise Aufteilung über Gesprächsrunden (Stapel >20): Bei großen Stapeln kann der Gesprächskontext gefüllt sein, bevor alle Bilder verarbeitet sind, wodurch Claude mitten im Stapel pausiert. Dies ist erwartet – kein Fehler. Wenn es passiert:
- Angeben, wie viele abgeschlossen und wie viele übrig sind (z.B. „20 / 24 erledigt – sagen Sie ‚weiter‘ für den Rest“)
- Auf Bestätigung des Benutzers warten, bevor fortgefahren wird
- Beim Fortsetzen mit dem nächsten unverarbeiteten Bild weitermachen und bis zum Ende fortfahren
- Alle Ausgaben erst nach Abschluss des letzten Bildes gemeinsam als Vorschau anzeigen
Schritt 9 (Bild) – Vorschau + Bereitstellen + Firefly-Board
asset_preview_file({
assets: [
{ name: "photo_1920x1080.jpg", presignedAssetUrl: result.outputUrl },
// alle erfolgreichen Ausgaben
]
})
In CC speichern + Firefly-Board erstellen
Nach der Vorschau jede Ausgabe mit der Block-Upload-Pipeline in den CC-Speicher hochladen
(asset_initialize_file_upload → PUT chunk → asset_finalize_file_upload).
Dann das Firefly-Board-Tool mit den endgültigen Ausgabe-URLs aufrufen:
create_firefly_board({
import_adobe_storage: [
final_output_url_1,
final_output_url_2,
// ...
]
})
✅ Bestätigt funktionierend (Stage):
import_adobe_storagemit signierten URLs vonasset_finalize_file_uploadfüllt Boards erfolgreich.❌ Funktioniert nicht:
import_generic_assetsmit CC-Asset-IDs (urn:aaid:sc:US:...) – USS-Indexierungsverzögerung verursacht leere Boards.Wenn die Board-Erstellung fehlschlägt oder die URL fehlerhaft ist, den Board-Link weglassen (Wiederholen hilft nicht).
Die Zusammenfassung nach dem Board-Schritt posten:
✅ Fertig! [N] Bild(er) wurden in der Größe geändert und sind bereit.
📥 Herunterladen:
• resized_1920x1080.jpg → <cc_storage_url>
[Einzeln auflisten, wenn N ≤ 3, oder einzelner Ordner-Link, wenn N > 3]
🎨 Im Firefly-Board anzeigen → <board_url> ← weglassen, wenn Board-Erstellung fehlgeschlagen ist
VIDEO-WORKFLOW
Schritt 5 (Video) – Asset-ID abrufen
Video-Tools benötigen assetId, keine URL.
| Quelle | Vorgehen |
|---|---|
Hochladen über asset_add_file | Zurückgegebene assetId verwenden |
| CC-Speicher | asset_search mit filters.mediaType: "video/mp4" → Asset-id verwenden |
Schritt 6 (Video) – Gängige Ziele
| Name | Abmessungen |
|---|---|
| 4K / UHD | 3840 × 2160 |
| 1080p / HD | 1920 × 1080 |
| 720p | 1280 × 720 |
| 480p | 854 × 480 |
| Vertikal 9:16 | 1080 × 1920 |
| Quadrat 1:1 | 1080 × 1080 |
Schritt 7 (Video) – video_resize aufrufen
⚠️
resizeVideoPollist ein deferred-Tool – zuerst laden, bevor ein Polling versucht wird. Direkte Aufrufe ohne Laden schlagen mit einem „not loaded“-Fehler fehl.
video_resize({
assetId: videoAssetId,
width: targetW,
height: targetH,
mode: "letterbox" // Standard; siehe Modustabelle unten
})
// Gibt { jobStatus: "pending", statusId } zurück
Modus – exakte API-Werte verwenden (nicht benutzerorientierte Bezeichnungen):
| Benutzer sagt | API-Wert | Verhalten |
|---|---|---|
| „anpassen |