Adobe 写真と動画のリサイズ
画像や動画を、ユーザーが指定した寸法、アスペクト比、または名前付きサイズにリサイズします。
ソーシャルメディアプラットフォーム向けセット(Instagram、TikTokなど)の場合は、代わりに adobe-create-social-variations スキルを使用してください。
ツールリファレンス
| ステップ | ツール | 備考 |
|---|---|---|
| ファイルピッカーを開く | asset_add_file | presignedAssetUrl、assetId、mediaType を返す |
| CC内のアセットを検索 | asset_search | 画像の場合は結果を asset_add_file で再ステージング;動画の場合は id を直接使用 |
| PSD/AIをレンダリング | document_render_vector | リサイズ前にJPEGに変換 |
| 画像をリサイズ | image_crop_and_resize | 寸法ごとに1回呼び出し;デフォルトで reframe |
| 出力をプレビュー | asset_preview_file | すべての出力を1回の呼び出しで |
| CCにアップロード(開始) | asset_initialize_file_upload | ブロックアップロードパイプラインの最初の呼び出し |
| CCにアップロード(完了) | asset_finalize_file_upload | 2回目の呼び出し;ボード用の署名済みCC URLを返す |
| Fireflyボードを作成 | create_firefly_board | import_adobe_storage に最終URLを渡す |
| 動画をリサイズ | video_resize | ポーリング用の statusId を返す |
| 動画リサイズをポーリング | resizeVideoPoll | 遅延ツール — 呼び出し前にロードする |
ワークフロー
ステップ 0 — Adobeツールの初期化
最初に adobe_mandatory_init を呼び出します。これにより、以降のワークフローに必要なファイル処理ルールとツールルーティングガイダンスが返されます。
{ "skill_name": "adobe-resize-photos-and-videos", "skill_version": "1.1.0" }
ステップ 1 — エンタイトルメントチェック
adobe_mandatory_init によって「Adobe for creativity」コネクタが有効であることが確認されたので、上記のツールリファレンステーブルと照合して、どのツールが利用可能かを確認します。
即時対応必須
ステップ 1: パラメータが不足しているか曖昧な場合 → マルチステップ intake(以下のステップ 2)を実行します。
ステップ 2: ファイルがアップロードされていない場合 → ステップ 3(asset_add_file({}))を実行します。
ステップ 3: 画像か動画かを判別し、適切なワークフロー(ステップ 5 画像/動画)にルーティングします。
ステップ 2 — マルチステップ Intake
ユーザーが完全なパラメータ(タイプ + 寸法 + フィットモード)を提供していない場合に実行します。 ユーザーのメッセージにこれらすべてがすでに含まれている場合は完全にスキップします。
AskUserQuestion を使用して、パラメータを段階的に収集します。
ステップ 2a — タイプ
AskUserQuestion([{
question: "写真ですか、動画ですか?",
type: "single_select",
options: ["写真", "動画"]
}])
ステップ 2b — 寸法
写真の場合(multi_select — ユーザーは1つ以上選択可能):
AskUserQuestion([{
question: "寸法 — 必要なものをすべて選択してください",
type: "multi_select",
options: [
"1080 × 1080 — Instagram 正方形",
"1080 × 1350 — Instagram ポートレート",
"1080 × 1920 — ストーリー / リール",
"1920 × 1080 — YouTube / ランドスケープ",
"1280 × 720 — YouTube サムネイル",
"1200 × 675 — X / Twitter 投稿",
"1200 × 630 — Facebook / OG画像",
"1080 × 566 — LinkedIn 投稿",
"2560 × 1440 — YouTube バナー",
"3840 × 2160 — 4K / UHD",
"400 × 400 — プロフィール / アバター",
"2480 × 3508 — A4 印刷 (300 dpi)",
"カスタム — 自分で入力する"
]
}])
ユーザーが「カスタム」を含める場合 → フォローアップ:「カスタム寸法を入力してください(例:1500×800):」
ユーザーが複数のプリセットを選択した場合 → 同じソースURIとパラメータを使用して、寸法ごとに image_crop_and_resize を1回実行します。最後にすべての出力をまとめてプレビューします。
動画の場合(multi_select — ユーザーは1つ以上選択可能):
AskUserQuestion([{
question: "寸法 — 必要なものをすべて選択してください",
type: "multi_select",
options: [
"1080 × 1920 — リール / TikTok / ストーリー",
"1920 × 1080 — YouTube / ランドスケープ",
"1080 × 1080 — 正方形投稿",
"1280 × 720 — YouTube 720p",
"3840 × 2160 — 4K / UHD",
"854 × 480 — SD / 480p",
"カスタム — 自分で入力する"
]
}])
ユーザーが複数の動画プリセットを選択した場合 → 寸法ごとに個別の video_resize ジョブを送信し、それぞれ完了するまでポーリングし、すべての出力をまとめてプレビューします。
ステップ 2c — フィットモード
写真の場合(single_select):
AskUserQuestion([{
question: "フィットモード",
type: "single_select",
options: [
"リフレーム — 埋めるように切り抜き",
"パッド — レターボックス、切り抜きなし",
"抽出 — 被写体を分離"
]
}])
動画の場合(single_select):
AskUserQuestion([{
question: "フィットモード",
type: "single_select",
options: [
"レターボックス — 比率を維持",
"クロップ — 埋める、黒帯なし",
"ストレッチ — 強制的に正確に(歪みあり)"
]
}])
ステップ 2d — スマートフォーカス(写真のみ)
AskUserQuestion([{
question: "スマートフォーカス — 切り抜きの中心をどこにしますか?",
type: "single_select",
options: [
"被写体",
"顔 / ポートレート",
"上半身",
"中央(幾何学的)",
"名前付きオブジェクト — 説明する"
]
}])
ユーザーが「名前付きオブジェクト」を選択した場合 → フォローアップ:「オブジェクトを説明してください(例:「赤い車」、「ロゴ」):」
ステップ 2e — オプション(写真のみ)
AskUserQuestion([{
question: "追加オプションはありますか?",
type: "multi_select",
options: [
"バッチ — 複数の画像",
"出力: JPEG",
"出力: PNG"
]
}])
ステップ 2f — ソース(動画のみ)
AskUserQuestion([{
question: "動画はどこにありますか?",
type: "single_select",
options: [
"デバイスからアップロード",
"Creative Cloud から"
]
}])
ステップ 3 — ソースファイルを取得
重要 — /mnt/user-data/uploads/ パスは使用可能なURLではありません。
ユーザーがファイルを添付し、コンテキスト内で /mnt/user-data/uploads/ パスに表示されている場合でも、このパスをAdobeツールに渡すことはできません。asset_add_file() を呼び出してファイルをステージングしてください — /mnt/user-data/uploads/ パスはAdobeツールで取得できません。
間違い ❌ imageURI: "/mnt/user-data/uploads/photo.jpg"
間違い ❌ imageURI: "file:///mnt/user-data/uploads/photo.jpg"
正解 ✅ call asset_add_file() → ピッカーコンテキストから presignedAssetUrl を使用
ファイルがまだない場合 → すぐにピッカーを開く:
asset_add_file()
返された mediaType からタイプを判別:
image/*→ 画像ワークフローvideo/*→ 動画ワークフロー
ステップ 4 — ターゲット寸法を解決
| ユーザーの入力 | 解決先 |
|---|---|
1920×1080, 1920x1080 | width: 1920, height: 1080 |
4K | 3840 × 2160 |
HD, 1080p | 1920 × 1080 |
720p | 1280 × 720 |
480p | 854 × 480 |
A4 印刷 | 2480 × 3508 (300 DPI ポートレート) |
Letter 印刷 | 2550 × 3300 (300 DPI ポートレート) |
16:9, 1:1, 4:5, 9:16 | 比率文字列 → output: "16:9" として渡す |
square | output: "1:1" |
幅のみ (800px wide) | width: 800、比率文字列を使用してアスペクト比を維持 |
フォームでターゲットが指定されておらず、ユーザーのメッセージにもない場合 → 質問:
「どのような寸法が必要ですか?(例:1920×1080、A4、16:9)」
画像ワークフロー
ステップ 5(画像) — 有効なURIソース
imageURI として機能するのは以下のみ:
asset_add_file()からのpresignedAssetUrl✅- 以前のツール呼び出しからの
outputUrl✅ - ユーザーが提供した公開HTTPS URL ✅
imageURI として使用不可:
/mnt/user-data/uploads/パス ❌asset_searchからのrenditionURLを直接 ❌file://URI ❌
| ソース | 解決方法 |
|---|---|
| アップロードされたファイル | asset_add_file() → presignedAssetUrl |
| CCストレージアセット | asset_search → asset_add_file() で再ステージング → presignedAssetUrl |
| 以前のツール出力 | outputUrl を直接使用 |
| PSD / AIファイル | document_render_vector (JPEG, 300 DPI) → outputPresignedUrl |
ステップ 6(画像) — フィットモード
| 意図 | モード | 備考 |
|---|---|---|
| 「WxHにリサイズ」 / デフォルト | reframe | ターゲット比率で最大の切り抜き、中央配置 — 歪みなし |
| 「切り抜きなし」、「レターボックス」、「内側に収める」 | pad | 空きスペースを白で塗りつぶす |
| 「被写体を分離」、「タイトに切り抜き」 | extract | 検出された領域の周りをタイトに切り抜き |
デフォルト: reframe。 ユーザーが明示的に指定した場合のみ変更します。
⛔
fit: "extract"は明示的な{ width, height }と互換性がありません — 画像が引き伸ばされます。比率文字列を使用するか、outputを省略してください。
ステップ 7(画像) — image_crop_and_resize の呼び出し
image_crop_and_resize({
imageURI: presignedAssetUrl,
options: {
output: { width: 1920, height: 1080 }, // または "16:9"
fit: "reframe",
focus: "subject", // または "face"、"upper_body"、{ prompt: "the car" }、{ x:0.5, y:0.5 }
quality: 7
},
outputFileType: "jpeg" // または透明度が必要な場合は "png"
})
// result.outputUrl → プレビューまたは連鎖に使用
フォーカスガイド:
"subject"— デフォルト;全身検出、風景、オブジェクト"face"— ポートレート、ヘッドショット"upper_body"— 胸から上のクロップ{ prompt: "the logo" }— ユーザーのフォーム入力からの名前付きオブジェクト{ x: 0.5, y: 0.5 }— 幾何学的中心(明確な被写体がない場合)
ステップ 8(画像) — バッチ
フォームでバッチが選択された場合、またはユーザーが複数のファイルを提供した場合:
- 各ファイルに対して
asset_add_file()を呼び出し、個別のpresigned URLを取得 - 同じパラメータで各ファイルに対して
image_crop_and_resizeを呼び出し - すべての
outputUrl値を収集 - すべての出力を1回の呼び出しで
asset_preview_fileを呼び出し
この環境では呼び出しは順次実行されます。10枚を超える画像の場合は、開始前にユーザーに確認してください。
ターン間のページネーション(バッチ >20): 大規模なバッチの場合、すべての画像が処理される前に会話コンテキストがいっぱいになり、Claudeがバッチの途中で一時停止することがあります。これは想定内であり、エラーではありません。発生した場合:
- 完了した数と残りの数を伝えます(例:「20 / 24 完了 — 残りを続行するには「続けて」と入力してください」)
- ユーザーが確認してから再開します
- 再開時には、次の未処理の画像から続けて最後まで処理します
- 最終画像が完了した後にのみ、すべての出力をまとめてプレビューします
ステップ 9(画像) — プレビュー + 納品 + Fireflyボード
asset_preview_file({
assets: [
{ name: "photo_1920x1080.jpg", presignedAssetUrl: result.outputUrl },
// 成功したすべての出力
]
})
CCに保存 + Fireflyボードを作成
プレビュー後、ブロックアップロードパイプライン(asset_initialize_file_upload → PUTチャンク → asset_finalize_file_upload)を使用して、各出力をCCストレージにアップロードします。
次に、最終出力URLを使用してfireflyボードツールを呼び出します:
create_firefly_board({
import_adobe_storage: [
final_output_url_1,
final_output_url_2,
// ...
]
})
✅ (ステージで確認済み):
asset_finalize_file_uploadからの署名済みURLを使用したimport_adobe_storageは、ボードを正常に作成します。❌ 機能しません: CCアセットID (
urn:aaid:sc:US:...) を使用したimport_generic_assets— USSインデックス作成の遅延により空白のボードが発生します。ボードの作成に失敗した場合、またはURLが不正な形式の場合は、ボードリンクを省略します(再試行しても役に立ちません)。
ボードステップの後に完了サマリーを投稿します:
✅ 完了! [N] 枚の画像をリサイズして準備完了です。
📥 ダウンロード:
• resized_1920x1080.jpg → <cc_storage_url>
[N ≤ 3 の場合は個別にリスト表示、N > 3 の場合は単一のフォルダリンク]
🎨 Fireflyボードで表示 → <board_url> ← ボード作成に失敗した場合は省略
動画ワークフロー
ステップ 5(動画) — アセットIDを取得
動画ツールにはURLではなく assetId が必要です。
| ソース | 方法 |
|---|---|
asset_add_file でアップロード | 返された assetId を使用 |
| CCストレージ | filters.mediaType: "video/mp4" を指定して asset_search → アセット id を使用 |
ステップ 6(動画) — 一般的なターゲット
| 名前 | 寸法 |
|---|---|
| 4K / UHD | 3840 × 2160 |
| 1080p / HD | 1920 × 1080 |
| 720p | 1280 × 720 |
| 480p | 854 × 480 |
| 縦型 9:16 | 1080 × 1920 |
| 正方形 1:1 | 1080 × 1080 |
ステップ 7(動画) — video_resize の呼び出し
⚠️
resizeVideoPollは遅延ツールです — ポーリングする前に最初にロードしてください。 ロードせずに直接呼び出すと、「not loaded」エラーで失敗します。
video_resize({
assetId: videoAssetId,
width: targetW,
height: targetH,
mode: "letterbox" // デフォルト;以下のモード表を参照
})
// 戻り値: { jobStatus: "pending", statusId }
モード — ユーザー向けラベルではなく、正確なAPI値を使用:
| ユーザーの入力 | API値 | 動作 |
|---|---|---|
| 「フィット」、「比率を維持」、「レターボックス」 | "letterbox" | 比率を維持し、黒帯を追加(デフォルト) |
| 「埋める」、「埋めるように切り抜き」、「黒帯なし」 | "crop" | エッジを切り抜いて正確にターゲットに合わせる |
| 「ストレッチ」、「強制的に正確に」 | "stretch" | 正確なターゲットに歪める |
ℹ️ 動画の自動リフレームはClaudeではまだ利用できませんが、新しいツールが常に追加されています。より詳細な制御が必要な場合は、Adobe Premiereをお試しください。
ポーリング: 遅延ツール resizeVideoPoll を呼び出す前にロードしてください — 直接呼び出すと「not loaded」で失敗します。
// ステップ 1: 遅延ツールをロード
const pollTool = await loadTool("resizeVideoPoll");
// ステップ 2: ポーリング
const pollResult = await pollTool({ statusId: jobStatusId });
ステップ 8(動画) — プレビュー + 納品 + Fireflyボード
すべての動画リサイズジョブが完了したら、asset_preview_file を使用して結果をまとめてプレビューします。画像ワークフローと同じブロックアップロードパイプラインとFireflyボードの手順に従います。
プレビュー後、画像ワークフローと同様にCCストレージにアップロードし、最終URLをFireflyボードに追加します。
原則
- 常にツールを優先: 手動の指示やユーザーへの質問ではなく、利用可能なAdobeツールを使用します。
- ファイルURLは直接使用しないでください — 常に
asset_add_file()を使用してアップロードしてください。 - バッチはまとめてプレビュー: 複数の出力がある場合は、常に1回の呼び出しで
asset_preview_fileを使用します。 - 即座に行動: 可能な限り即座にアクションを実行します。複数の選択肢が必要な場合にのみ質問します。
- アクション後に結果を表示: アクションを実行した後は、常に結果を表示するか、何が行われたかをユーザーに知らせます。