판매자용 · 내 자료·스톡

비디아 · v1 · 패키지 0개

설계도의 내 자료·무료 스톡 장면에 화면 자료를 확보합니다(판매자 제공용 공개 모듈).

이 모듈이 내는 JSON 의 모양입니다. 최상위 키가 이 모듈이 내는 필드이고, 앞 단계까지 쌓인 JSON 에 합쳐져 다음 모듈의 입력이 됩니다. 만든 파일 목록(files)은 실행 때 서버가 채웁니다.

{
  "assets": {
    "media:s02": 84,
    "media:s04": 85
  },
  "mediaMissing": [
    {
      "scene": "s05",
      "type": "stock-video",
      "reason": "맞는 무료 스톡 영상을 찾지 못함 — 이미지 단계가 AI 이미지로 채움"
    }
  ],
  "credits": [
    {
      "scene": "s04",
      "source": "pexels",
      "title": "Garden hose spraying water in sunlight",
      "author": "Pexels 작가",
      "url": "https://www.pexels.com/video/000000/",
      "license": "Pexels License"
    }
  ],
  "mediaStats": {
    "found": 2,
    "missing": 1,
    "skipped": 0
  }
}

지시서를 공개하지 않은 모듈도 어떤 API·모델을 몇 번까지 부르는지, 어느 외부 주소로 요청을 보내는지는 누구나 볼 수 있습니다.

외부 연결 없음

비디아 밖의 주소로 요청을 보내지 않습니다.

[이 모듈이 하는 일]
(판매자용 템플릿 · 내 자료·스톡) 설계도에서 AI 로 그리지 않는 장면(내 자료 upload·무료 스톡 영상 stock-video)의 화면 자료를 찾아 가져온다.
찾은 자료는 assets["media:<장면id>"] 에 적고, 못 찾은 장면은 뒤 이미지 단계가 AI 이미지로 채우도록 표시한다.
무료 도구만 쓰는 기본형 템플릿이며 비디아 내부 제작 방식·비밀값은 들어 있지 않다.

[입력]
이전 단계 JSON(vidia.doc@1).
- blueprint.video.aspectRatio: 화면 방향(9:16 세로 / 16:9 가로 / 1:1 정사각)
- blueprint.scenes[]: {id, title, purpose, media{type, assetId, stock{provider, id}}}
- input.media_asset_ids: 회원이 쓰라고 준 내 자료 asset id 목록(선택)
- assets: 이미 가져온 "media:<장면>" 은 다시 가져오지 않는다.

[할 일]
대상 장면(media.type 이 upload·stock-video)이 하나도 없으면 도구를 부르지 않고 입력을 그대로 내보낸다(mediaStats 만 더한다).
장면마다 설계도 순서대로, assets["media:<장면id>"] 가 이미 있으면 건너뛴다.

A. upload(내 자료)
1. scene.media.assetId 가 있으면 get_asset 으로 확인하고 그 id 를 쓴다.
2. 없으면 list_my_assets(scope "library", kind 는 "video", 영상이 없으면 "image")를 한 번만 불러 목록을 재사용한다.
   input.media_asset_ids 에 든 자료를 먼저 보고, 이름표·파일 이름이 장면 title·purpose 와 가장 잘 맞는 것을 고른다. 한 자료를 여러 장면에 겹쳐 쓰지 않는다.
3. 맞는 자료가 없으면 missing 으로 표시한다.

B. stock-video(무료 스톡)
1. scene.media.stock.provider 가 pexels·pixabay 이고 id 가 있으면 stock_fetch(provider, id) 를 바로 부른다.
2. 없으면 stock_search 로 찾는다: query 는 장면의 눈에 보이는 대상·장소·동작만 담은 영어 2~5 단어, provider 는 scene.media.stock.provider 가 pexels·pixabay 면 그것 아니면 "pexels", orientation 은 9:16 "portrait"·16:9 "landscape"·1:1 은 넣지 않는다, per_page 8.
   - 결과가 비면 더 일반적인 말로 바꾸거나 다른 provider 로 최대 2번 더 찾는다.
   - STOCK_KEY_MISSING 오류면 그 provider 는 더 쓰지 않는다. 둘 다 키가 없으면 남은 stock-video 장면을 missing(사유 "스톡 API 키 없음")으로 표시한다.
3. 고른 항목을 stock_fetch(provider, id) 로 가져와 asset_id 를 얻고 license·attribution 을 credits 에 기록한다.
4. 끝내 못 찾으면 missing 으로 표시한다.

C. 기록
- 찾은 자료: assets["media:<장면id>"] = asset_id.
- 못 찾은 장면: mediaMissing 에 {"scene": 장면id, "type": media.type, "reason": "…"} 을 더한다.
- credits: [{"scene", "source", "title", "author", "url", "license"}] — 기존 배열 뒤에 이번 기록을 더한다.

[출력]
다음 최상위 필드만 담은 JSON 객체 하나(적지 않은 최상위 필드는 입력값이 그대로 이어진다).
- assets: "media:<장면id>" 키를 더한 값
- mediaMissing: 못 찾은 장면 목록(없으면 [])
- credits: 기존 credits 뒤에 이번 기록을 더한 배열
- mediaStats: {"found", "missing", "skipped"}

[주의]
- 무료 도구만 쓴다. 스톡 API 키는 도구가 비디아 키로 알아서 쓰며 지시서·출력에 적지 않는다.
- 설계도(blueprint)는 바꾸지 않는다.
- 설명·마크다운 없이 JSON 객체 하나만 답한다.