Communitygithub.com

Adobe 사진 및 비디오 크기 조정

Adobe 도구를 사용하여 사진과 비디오를 정확한 픽셀 크기 또는 화면 비율로 조정합니다.

Adobe 사진 및 비디오 크기 조정란 무엇인가요?

이 스킬은 이미지 및 비디오 파일의 크기 조정, 배율 변경, 해상도 조정 작업을 자동화하는 Adobe AI 에이전트 도구입니다. 사용자가 "1920x1080으로 크기 조정", "4K로 만들어 줘", "16:9 비율로 변경" 등과 같은 자연어 명령을 입력하면 사진은 `image_crop_and_resize`, 비디오는 `video_resize` 도구를 통해 처리합니다. 사진의 경우 `reframe`, `pad`, `extract` 모드를 지원하고, 스마트 포커스(주제, 얼굴, 상체 등)와 배치 처리도 가능합니다. 비디오는 `letterbox`, `crop`, `stretch` 모드를 지원하며, 다중 프리셋을 선택하면 각각 별도 작업으로 처리한 후 결과를 함께 미리보기 합니다. 또한 완료된 결과물을 Creative Cloud에 업로드하고 Firefly 보드에 추가할 수 있습니다. 소셜 미디어 플랫폼별 변환이 필요한 경우 `adobe-create-social-variations` 스킬을 사용해야 합니다.

지원 대상✓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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Adobe 사진 및 비디오 크기 조정은(는) 무엇을 하나요?

이미지나 비디오를 사용자가 지정한 크기, 화면 비율 또는 명명된 크기로 조정합니다. 소셜 미디어 플랫폼 세트(Instagram, TikTok 등)의 경우 → 대신 adobe-create-social-variations 스킬을 사용하세요.


도구 참조

단계도구비고
파일 선택기 열기asset_add_filepresignedAssetUrl, 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_boardfinalize 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, 1920x1080width: 1920, height: 1080
4K3840 × 2160
HD, 1080p1920 × 1080
720p1280 × 720
480p854 × 480
A4 인쇄2480 × 3508 (300 DPI 세로)
Letter 인쇄2550 × 3300 (300 DPI 세로)
16:9, 1:1, 4:5, 9:16비율 문자열 → output: "16:9"로 전달
squareoutput: "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단계 (이미지) — 배치

양식에서 배치가 선택되었거나 사용자가 여러 파일을 제공한 경우:

  1. 각 파일에 대해 asset_add_file()을 호출하여 개별 presigned URL을 가져옵니다.
  2. 각 파일에 대해 동일한 매개변수로 image_crop_and_resize를 호출합니다.
  3. 모든 outputUrl 값을 수집합니다.
  4. 모든 출력을 한 번에 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 / UHD3840 × 2160
1080p / HD1920 × 1080
720p1280 × 720
480p854 × 480
세로 9:161080 × 1920
정사각형 1:11080 × 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단계 (비디오) — 배치

비디오 배치의 경우:

  1. 각 크기에 대해 별도의 video_resize 작업을 제출합니다.
  2. 각 작업을 완료될 때까지 폴링합니다.
  3. 모든 출력 URL을 수집합니다.
  4. 모든 출력을 함께 미리 봅니다.
// 여러 크기 예시
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>

관련 스킬