모바일 앱 광고 영상 생성 API: 크리에이터 데모와 엔드 카드

Sume API로 모바일 앱 광고 영상을 만들려면 앱 스크린샷을 첨부하고 앱 정보를 input에 넣어 POST /v1/formats/sume/sume-mobile-app-ugc/runs로 카탈로그 Format sume-mobile-app-ugc를 실행하세요. 브랜드 인트로나 엔드 카드가 필요하면 앱 아이콘으로 sume-logo-motion-design을 실행한 뒤, POST /v1/timeline-1.0/render로 두 클립을 이어 붙이세요.

아래 내용은 2026-09-27에 확인한 Sume 문서 Format 카탈로그 (영문), Format 호출하기 (영문), Timeline 1.0, 오디오 분리 페이지에서 가져왔습니다. 작성한 스크립트를 그대로 읽는 진행자는 Avatar 1.0 경로이며, AI UGC 광고 생성 API에서 다룹니다.

앱 광고에는 어떤 카탈로그 Format이 맞나요?

설명에 앱이나 테크 작업을 언급하는 영상 Format은 세 개이며, 모두 “Not for: static campaign deliverables.”(정적인 캠페인 결과물용 아님)로 끝납니다. 인용한 문구는 각 Format이 명시한 목표일 뿐, 개별 영상에 대한 보장이 아닙니다.

앱에 대해서는 무엇을 보내야 하나요?

스크린샷은 공개 HTTPS URL을 담은 input_image 항목으로 attachments에 넣으세요. JPEG, PNG, WebP, GIF, AVIF를 장당 30 MB까지 받습니다. 앱에 관한 사실은 input에 넣으세요. input은 최상위 키 최대 64개, 최대 2 MiB인 JSON 객체입니다. Sume는 이 객체의 필드 목록을 공개하지 않으므로 키 이름은 직접 정합니다. input은 실행 안의 파일에 통째로 기록되며, 에이전트는 이를 지시가 아니라 데이터로만 읽으라는 안내를 받습니다.

input 안의 미디어 URL은 실행의 파일 예산 30개를 함께 쓰며, 그중 영상은 최대 10개입니다. 따라서 화면 녹화 URL은 영상 하나로 셉니다. 파일 이름이 미디어 확장자로 끝나는 URL만 세며, 스토어 등록 페이지 URL은 세지 않습니다.

curl -sS -X POST "https://api.sume.com/v1/formats/sume/sume-mobile-app-ugc/runs" \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: budget-app-v4-ugc-v1" \
  -d '{
    "instruction": "Vertical creator ad: finds the app, reacts to the bill-split screen.",
    "input": {
      "app_name": "Acme Budget",
      "store_url": "https://example.com/apps/acme-budget",
      "benefit": "Splits shared bills in two taps"
    },
    "attachments": [
      { "type": "input_image", "image_url": "https://example.com/screens/home.png" },
      { "type": "input_image", "image_url": "https://example.com/screens/split.png" }
    ],
    "generation_spend_cap_usd": 25
  }'

앱 인트로나 엔드 카드는 어떻게 넣나요?

앱 아이콘을 첨부해 sume-logo-motion-design을 실행하세요. 이 Format의 설명은 “a supplied brand mark”(제공된 브랜드 마크)에서 출발합니다. 카드 자체를 만드는 방법은 로고 애니메이션 API에서 다룹니다.

두 실행 모두 artifacts[]에 내구성 있는 media.sume.com URL을 반환하며, 실행의 미디어는 그 실행을 호출한 키에 귀속됩니다. 이 점이 중요한 이유는 Timeline 1.0이 그 밖의 URL을 받지 않기 때문입니다. 모든 URL은 이미 이 워크스페이스의 media.sume.com 아티팩트나 에셋이어야 하므로, Format을 실행한 워크스페이스의 키로 렌더하세요.

크리에이터 컷과 카드는 어떻게 이어 붙이나요?

Timeline 1.0은 오디오 스파인 하나와 순서 있는 video[] 슬롯으로 MP4 하나를 렌더하므로, 광고의 소리는 곧 스파인입니다. 클립마다 POST /v1/audio-detach로 오디오를 분리하고(기본 출력은 샘플 단위로 정확한 wav), 그 파일들을 재생 순서대로 audio.parts[]에 나열하세요. 오디오 트랙이 없는 클립은 detach_source_has_no_audio로 실패하므로, 먼저 영상 검사로 probe.has_audio를 확인하세요. 카드에 소리가 없다면 크리에이터 컷의 마지막 몇 초 위에서 카드를 시작하고, 크리에이터 오디오만 스파인으로 쓰세요.

• video[0].start는 0이어야 하고, 이후의 시작 시점은 계속 커져야 합니다. 선언한 파트 길이의 합이 audio.duration_seconds보다 짧으면 거부됩니다.
• transition은 첫 슬롯 이후의 슬롯에 붙이며(fade, dissolve, 와이프, 슬라이드), 최대 1초이고 더 짧은 이웃 슬롯 길이의 절반 이하여야 합니다.
• 인트로로 쓰려면 카드를 start: 0에 먼저 두고 크리에이터 컷을 그 뒤에 두세요. 기본 출력은 1080×1920입니다.

curl -X POST https://api.sume.com/v1/timeline-1.0/render \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: budget-app-v4-ad-v1" \
  -d '{
    "audio": {
      "duration_seconds": 18,
      "parts": [
        { "url": "https://media.sume.com/artifacts/artf_demo/creator.wav", "duration": 15 },
        { "url": "https://media.sume.com/artifacts/artf_demo/card.wav", "duration": 3 }
      ]
    },
    "video": [
      { "source_url": "https://media.sume.com/artifacts/artf_demo/creator.mp4", "start": 0, "duration": 15 },
      { "source_url": "https://media.sume.com/artifacts/artf_demo/card.mp4", "start": 15, "duration": 3,
        "transition": { "type": "fade", "duration": 0.5 } }
    ]
  }'

비용은 얼마이고, 어떤 제한이 있나요?

각 Format 실행은 최대 $500인 generation_spend_cap_usd 안에서 API 요금의 요율로 생성을 계량합니다. Timeline 렌더는 출력 분당 $0.10로 나와 있고 스파인 길이를 분 단위로 올림한 만큼 예약되며, 오디오 분리는 건마다 오디오 분리 페이지에 나온 Job당 정액 요율이 적용됩니다. 두 요금에는 각각 기본적으로 5.5% 에이전트 수수료가 더해집니다. POST /v1/timeline-1.0/plan은 과금 없이 렌더 본문을 검사합니다. 렌더링 전 영상 타임라인 JSON 검증을 참고하세요.

• Format 실행은 attachments와 input 안의 미디어 URL을 합쳐 미디어 파일을 모두 30개까지 받으며, 그중 영상은 최대 10개, 오디오는 최대 10개입니다.
• Timeline: 스파인 1–1,800초, video[] 슬롯 1–200개, audio.parts[] 최대 20개.
• 오디오 분리: 소스 최대 1,800초, 출력 최대 900초.
• 각 Format의 설명은 그 Format이 명시한 목표입니다. 모델은 Format의 도구가 고르며, 끝낼 수 없는 실행은 failed로 돌아옵니다.