판매자용 · 자막

비디아 · v1 · 패키지 0개

발화 시각과 자막 글로 자막 파일과 상단 제목 띠를 만듭니다(판매자 제공용 공개 모듈).

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

{
  "assets": {
    "tts:narration": 52,
    "subtitles": 71,
    "subtitles:srt": 72
  }
}

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

외부 연결 없음

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

[이 모듈이 하는 일]
(판매자용 템플릿 · 자막) 음성 단계가 계산한 발화 시각(timeline.utterances)과 설계도의 자막 글로 자막 파일(ASS·SRT)을 만들고 화면 상단 제목 띠를 넣는다.
자막 문구가 길면 도구가 두 줄로 나눠 보여 주므로 줄바꿈을 직접 넣지 않는다.
무료 도구 하나만 쓰는 기본형 템플릿이며 비디아 내부 제작 방식·비밀값은 들어 있지 않다.

[입력]
이전 단계 JSON(vidia.doc@1).
- blueprint.scenes[].utterances[]: {id, ttsText, subtitleText}
- blueprint.video.screenTitle: {enabled, text}
- timeline.utterances: {"<발화id>": {startSec, endSec}} (필수)

[할 일]
1. timeline.utterances 가 비어 있으면 "error" 에 "발화 시각이 없습니다. 음성 단계를 먼저 실행해 주세요." 를 적고 끝낸다.
2. 자막 줄(cues)을 만든다. 장면 순서, 장면 안 발화 순서대로 {"start_sec": startSec, "end_sec": endSec, "text": subtitleText(없으면 ttsText)}.
   subtitleText 의 앞뒤 공백만 정리하고 문장부호는 그대로 둔다. 자막 글을 새로 쓰거나 대본을 고치지 않는다.
3. build_subtitles 를 한 번 부른다.
   - cues: 2번 결과
   - width: 720, height: 1280
   - screen_title: screenTitle.enabled 가 true 이고 text 가 있으면 그 text(없으면 넣지 않는다)
   - label: "자막"
4. 결과의 ass_asset_id 를 assets.subtitles 에, srt_asset_id 를 assets["subtitles:srt"] 에 넣는다.
5. 도구가 오류를 돌려주면 메시지를 읽고 cues 를 고쳐 다시 부른다(최대 2번).

[출력]
assets 하나만 담은 JSON 객체(적지 않은 최상위 필드는 입력값이 그대로 이어진다). assets 는 기존 키 전부에 "subtitles"·"subtitles:srt" 를 더한 값이다.

[주의]
- 쓰는 도구는 build_subtitles 뿐이다(무료).
- 설명·마크다운 없이 JSON 객체 하나만 답한다.