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 | 크기당 한 번 호출, 기본 reframe |
| 출력 미리보기 | asset_preview_file | 모든 출력을 한 번에 호출 |
| CC에 업로드 (시작) | asset_initialize_file_upload | 블록 업로드 파이프라인의 첫 번째 호출 |
| CC에 업로드 (완료) | asset_finalize_file_upload | 두 번째 호출, 보드용 presigned CC URL 반환 |
| Firefly 보드 생성 | create_firefly_board | finalize URL과 함께 import_adobe_storage 전달 |
| 비디오 크기 조정 | 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" 커넥터가 활성화되었음을 확인했으므로, 위의 도구 참조 테이블과 대조하여 "Adobe for creativity" 커넥터를 통해 어떤 도구를 사용할 수 있는지 확인합니다.
즉시 실행 필요
1단계: 매개변수가 누락되었거나 모호한 경우 → 다단계 입력(아래 2단계)을 실행합니다.
2단계: 업로드된 파일이 없으면 3단계(asset_add_file({}))를 실행합니다.
3단계: 이미지인지 비디오인지 감지하여 올바른 워크플로우(5단계 이미지/비디오)로 라우팅합니다.
2단계 — 다단계 입력
사용자가 완전한 매개변수(유형 + 크기 + 맞춤 모드)를 제공하지 않은 경우 실행합니다. 사용자의 메시지에 세 가지가 모두 포함된 경우 완전히 건너뜁니다.
AskUserQuestion을 사용하여 단계별로 매개변수를 수집합니다.
2a단계 — 유형
AskUserQuestion([{
question: "사진 또는 비디오?",
type: "single_select",
options: ["사진", "비디오"]
}])
2b단계 — 크기
사진인 경우 (multi_select — 사용자가 하나 이상 선택 가능):
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를 실행하고, 마지막에 모든 출력을 함께 미리 봅니다.
비디오인 경우 (multi_select — 사용자가 하나 이상 선택 가능):
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: [
"Reframe — 채우기 위해 자르기",
"Pad — 레터박스, 자르지 않음",
"Extract — 피사체 분리"
]
}])
비디오인 경우 (single_select):
AskUserQuestion([{
question: "맞춤 모드",
type: "single_select",
options: [
"Letterbox — 비율 유지",
"Crop — 채우기, 막대 없음",
"Stretch — 강제 정확 (왜곡)"
]
}])
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값을 수집합니다. - 모든 출력을 한 번에
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의 presigned 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 값 | 동작 |
|---|---|---|
| "fit", "preserve ratio", "letterbox" | "letterbox" | 비율 유지, 검은색 막대 추가 (기본값) |
| "fill", "crop to fill", "no bars" | "crop" | 가장자리 자르기, 대상에 정확히 채움 |
| "stretch", "force exact" | "stretch" | 정확한 대상으로 왜곡 |
ℹ️ 비디오 자동 리프레임은 아직 Claude에서 사용할 수 없지만 새로운 도구가 계속 추가되고 있습니다. 더 많은 제어가 필요하면 Adobe Premiere를 사용해 보세요.
폴링: 지연된 도구 resizeVideoPoll를 호출하기 전에 로드하세요 — 직접 호출은 "not loaded"로 실패합니다.
// 1단계: 지연된 도구 로드
const pollTool = await loadDeferredTool("resizeVideoPoll");
// 2단계: 폴링에 사용
pollTool({ statusId: "..." });
8단계 (비디오) — 배치
비디오 배치의 경우:
- 각 크기에 대해 별도의
video_resize작업을 제출합니다. - 각 작업을 완료될 때까지 폴링합니다.
- 모든 출력 URL을 수집합니다.
- 모든 출력을 함께 미리 봅니다.
// 여러 크기 예시
const jobs = [
{ assetId, width: 1080, height: 1920, mode: "letterbox" }, // 세로
{ assetId, width: 1920, height: 1080, mode: "letterbox" }, // 가로
];
for (const job of jobs) {
const result = await video_resize(job);
// statusId로 폴링
}
9단계 (비디오) — 미리보기 + 전달 + Firefly 보드
asset_preview_file({
assets: [
{ name: "video_1080x1920.mp4", presignedAssetUrl: outputUrl1 },
{ name: "video_1920x1080.mp4", presignedAssetUrl: outputUrl2 },
]
})
이미지 워크플로우와 동일한 CC 업로드 + Firefly 보드 파이프라인을 따릅니다.
완료 요약:
✅ 완료! [N]개 비디오 크기 조정 완료.
📥 다운로드:
• video_1080x1920.mp4 → <cc_storage_url>
• video_1920x1080.mp4 → <cc_storage_url>
🎨 Firefly 보드에서 보기 → <board_url>