Asset Library

Asset Library는 업로드 영상, 생성 영상, 소스 미디어에서 색인된 장면 단위 에셋을 노출합니다. 검색 결과는 API 키 워크스페이스 범위로 제한됩니다.

Mental model

객체	의미
Source video	ingest된 원본 업로드 또는 생성 영상입니다.
Scene asset	해당 영상에서 나온 검색 가능한 클립/세그먼트입니다.
Metadata	transcript, visual summary, action labels, 브랜드/제품 언급, 태그, 키워드, CTA, 타이밍입니다.
Safe URL	도구가 재사용할 수 있는 안정적인 미디어 또는 썸네일 URL입니다. 전체 query string URL은 로그에 남기지 마세요.

장면 메타데이터가 없는 에셋은 색인이 장면 row를 만들기 전까지 검색 결과에 나타나지 않습니다.

장면 검색

curl "https://www.sume.so/api/v1/assets?q=woman%20camera%20hook&source_type=generated&limit=5&sort=relevance" \
  -H "Authorization: Bearer $SUME_API_KEY"

CLI:

sume assets search "woman looking at camera hook" \
  --source-type generated \
  --max-duration 15 \
  --sort relevance \
  --limit 5 \
  --json

검색어가 있을 때 응답에는 relevance context가 포함됩니다.

{
  "object": "list",
  "data": [
    {
      "id": "asset_...",
      "object": "asset",
      "title": "Scene 1",
      "media_url": "https://media.sume.so/...",
      "thumbnail_url": "https://media.sume.so/...",
      "metadata": {
        "visual_summary": "Creator faces camera and introduces the product.",
        "cta_present": false
      }
    }
  ],
  "has_more": false,
  "next_cursor": null
}

위 형태는 예시입니다. 정확한 필드는 API 레퍼런스를 기준으로 보세요.

필터

Query parameter	CLI flag	용도
q	assets search "<query>" 또는 assets list --query	자연어 또는 키워드 장면 검색입니다.
search_mode	--search-mode auto|text	텍스트/메타데이터 검색 모드입니다.
source_type	--source-type	업로드, 생성 같은 소스 범주입니다.
segment_type	--segment-type	hook, product demo, CTA 같은 장면 역할입니다.
brand	--brand	브랜드 언급입니다.
product	--product	제품 언급입니다.
tag	--tag	재사용 에셋 태그입니다.
keyword	--keyword	색인된 키워드입니다.