로고 애니메이션 API: 브랜드 마크를 아이덴트·엔드 카드로

Sume API로 로고 애니메이션을 만들려면 마크를 이미지 첨부로 넣어 카탈로그 Format sume-logo-motion-design을 POST /v1/formats/sume/sume-logo-motion-design/runs로 호출하거나, 마크를 POST /v1/videos 요청의 first_frame으로 넣어 직접 움직이게 하세요. 영상을 로고로 마무리하려면 그 클립을 Timeline 1.0 렌더의 마지막 슬롯으로 넣으세요.

아래 내용은 Format 카탈로그 (영문), Format API (영문), Format 호출하기 (영문), 영상 생성 (영문), Timeline 1.0 문서 페이지, 이 Format의 공개 설명, 그리고 Sume API 레퍼런스의 바탕이 되는 OpenAPI 문서에서 가져왔으며, 2026-09-27에 확인했습니다.

로고 Format은 무엇을 만드나요?

sume-logo-motion-design은 “a finished logo motion video that reveals a supplied brand mark through clean material, light, depth, or graphic movement”(제공한 브랜드 마크를 깔끔한 재질, 빛, 깊이감 또는 그래픽 움직임으로 드러내는 완성된 로고 모션 영상)을 만듭니다. 설명은 “logo idents, brand stings, app intros, launch bumpers, and social end cards”(로고 아이덴트, 브랜드 스팅, 앱 인트로, 런칭 범퍼, 소셜 엔드 카드)를 나열하고 “Not for: static campaign deliverables”(정적인 캠페인 결과물용 아님)로 끝나므로, 결과물은 영상입니다.

레시피는 비공개입니다. 실행의 model 필드는 오케스트레이션을 맡는 LLM만 고르며, 이미지·영상·오디오 모델은 Format의 도구가 고릅니다. 소유하고 있거나 사용 허가를 받은 마크만 움직이게 하세요.

로고는 어떻게 보내나요?

formats:write가 있는 키로, 마크를 공개 HTTPS image_url을 담은 input_image로 첨부하세요. Format 실행의 첨부 파일은 JPEG, PNG, WebP, GIF, AVIF 형식이어야 하고 한 장당 30 MB까지입니다. SVG는 이 목록에 없으므로 먼저 마크를 PNG로 내보내세요. 길이, 배경, 배치는 instruction에 적으세요. 레시피와 어긋나면 instruction이 우선합니다.

• 실행은 영수증과 함께 202로 응답하고 몇 분이 걸립니다. 완료된 실행의 primary_output_url이 화면에 보여 줄 결과 하나이며, URL을 가진 누구에게나 공개되는 내구성 있는 media.sume.com URL입니다.
• Idempotency-Key를 보내세요. 같은 키와 본문을 다시 보내면 원래 실행이 돌아오며, 두 번 과금되지 않습니다.

curl -sS -X POST "https://api.sume.com/v1/formats/sume/sume-logo-motion-design/runs" \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: acme-logo-ident-v1" \
  -d '{
    "instruction": "Short logo ident on a dark background, for the end of our product videos.",
    "attachments": [
      { "type": "input_image", "image_url": "https://example.com/acme-logo.png", "filename": "acme-logo.png" }
    ],
    "generation_spend_cap_usd": 20
  }'

로고가 사진 속에만 있다면 어떻게 하나요?

먼저 RMBG 1.0으로 배경을 제거하세요. POST /v1/rmbg-1.0/remove는 공개 HTTPS image_url을 받고, 완료된 결과는 Sume로 미러링된, 알파 채널이 있는 PNG 아티팩트를 제공합니다. 잘라 낸 결과를 확인한 뒤 그 PNG의 media.sume.com URL을 그대로 attachments에 넘기세요. 이미 media.sume.com에 있는 URL은 다시 복사되지 않습니다. 요청 필드는 배경 제거 API에 있습니다.

마크를 직접 움직이게 하려면 어떻게 하나요?

마크를 frame_type이 first_frame인 frame_images 항목으로 넣어 POST /v1/videos를 보내고, 움직임은 prompt에 설명하세요. supported_frame_images에 last_frame이 있는 모델이라면 최종 로고 락업을 마지막 프레임으로 고정할 수도 있습니다. model: "sume/auto"에서 생성 옵션의 기본값은 720p와 8초이고, 클립 길이는 3–10초, 비율은 16:9 또는 9:16입니다. 프레임 규칙은 Image-to-Video API: 첫 프레임과 마지막 프레임 지정에 있습니다.

영상 끝에 로고를 넣으려면 어떻게 하나요?

Timeline 1.0(POST /v1/timeline-1.0/render)을 쓰세요. 결과는 MP4 하나이며, 기본 해상도는 1080×1920입니다. 로고 클립을 fade나 dissolve 전환 효과와 함께 마지막 video[] 슬롯으로 넣으세요. 전환 효과는 첫 슬롯 이후 어느 슬롯에든 지정할 수 있고, 길이는 최대 1초이면서 이웃한 두 슬롯 중 짧은 쪽의 절반 이하입니다. 스틸은 정지 화면으로 유지되므로 마크의 스틸도 슬롯으로 쓸 수 있습니다. output.fade_out_seconds(0–5)는 마지막 몇 초를 검은 화면과 무음으로 페이드아웃하고, soundtrack.fade_out_seconds(최대 10)는 배경 음악을 페이드아웃합니다.

• 모든 URL은 이미 워크스페이스에 있는 media.sume.com 아티팩트나 에셋이어야 합니다. Format 실행 미디어와 생성된 Job 출력은 media.sume.com 아래에 Sume가 호스팅하며, 호스트 밖 URL은 접수 단계에서 거부됩니다.
• POST /v1/videos로 만든 클립이라면 GET /v1/jobs/{id}/result에서 그 media.sume.com 아티팩트 URL을 읽으세요. 폴링 응답의 unsigned_urls는 미디어 호스트가 아니라 api.sume.com을 가리킵니다.
• Idempotency-Key는 필수이며, POST /v1/timeline-1.0/plan은 Job을 만들거나 크레딧을 예약하지 않고 문서를 검사합니다.
• 전환 효과 규칙은 영상 전환 효과(트랜지션) API에 더 있습니다.

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: promo-with-end-card-v1" \
  -d '{
    "audio": { "url": "https://media.sume.com/artifacts/artf_demo/voice.wav", "duration_seconds": 20 },
    "video": [
      { "source_url": "https://media.sume.com/artifacts/artf_demo/promo.mp4", "start": 0, "duration": 16 },
      { "source_url": "https://media.sume.com/artifacts/artf_demo/logo-ident.mp4", "start": 16, "duration": 4,
        "transition": { "type": "fade", "duration": 0.5 } }
    ],
    "output": { "fade_out_seconds": 1 }
  }'

한도는 어떻게 되나요?

같은 문서 페이지에 나온 한도입니다.

• Format: 첨부 파일은 input_image만 가능하며, 한 장당 30 MB, 실행당 500 MB까지입니다. 끝낼 수 없는 실행은 반쯤 끝난 completed가 아니라 failed로 돌아옵니다.
• 직접 애니메이션: sume/auto에서 클립은 16:9 또는 9:16에 3–10초입니다. 모델을 직접 지정하면 그 모델의 해상도, 화면 비율, 길이가 GET /v1/videos/models에 나와 있습니다.
• Timeline: 슬롯은 1–200개이고 각각 최소 0.2초이며, 출력은 1–1800초입니다. 첫 슬롯의 전환 효과는 거부되며(transition_on_first_segment), 인접한 페이드가 8개를 넘어도 거부됩니다(too_many_chained_transitions).

단계별 비용은 얼마인가요?

에이전트 자체의 LLM 턴까지 포함한 Format 실행의 총비용은 영수증의 usage.debited_usd_micros입니다.