슬라이드

slides는 공용 storybook 엔드포인트의 세 번째 모드입니다. AI 비주얼과 내레이션 스크립트가 있는 프레젠테이션 형식의 페이지를 만들며, 회의, 비즈니스 리포트, 컨퍼런스 발표에 적합합니다. 엔드포인트, 요청 파라미터, 폴링, 상태, 영상 렌더링 단계는 설명 영상과 슬라이드 개요를 참고하세요. 이 페이지는 slides에 고유한 내용만 다룹니다.

POST /v1/storybook/episodes에 mode: "slides"를 지정하세요. 이 필드는 엔드포인트에서 선택 사항이지만 — 생략하면 slides가 아니라 info가 됩니다 — 이 모드에서는 사실상 필수입니다. slides 모드가 무엇을 그리는지는 개요 페이지의 모드 표에 정리돼 있습니다.

PPT 파일 받기

영상 없이 페이지 활용하기

slides는 원본 소재 자체가 최종 산출물이 되는 경우가 가장 많은 모드입니다. pages[]의 각 항목에는 슬라이드 이미지(imageUrl)와 그에 대한 내레이션 스크립트(text)가 들어 있고, 이 스크립트는 발표자 노트로 쓸 수 있으므로, 직접 쓰는 도구로 프레젠테이션을 구성하고 영상 렌더링은 완전히 건너뛸 수 있습니다.

내레이션 오디오가 전혀 필요 없다면 생성 시 skipAudio: true를 함께 지정하세요 — 이미지와 스크립트는 그대로 반환되고, speakers는 선택 사항이 됩니다.

예시

내레이션이 있는 슬라이드:

curl -X POST "https://api.marswave.ai/openapi/v1/storybook/episodes" \
  -H "Authorization: Bearer $LISTENHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sources": [
      {"type": "text", "content": "Q3 results: revenue, retention and the two bets for Q4..."}
    ],
    "speakers": [{"speakerId": "<SPEAKER_ID>"}],
    "language": "en",
    "mode": "slides"
  }'

슬라이드 이미지와 스크립트만 — speakers 없이, 오디오 렌더링 없이:

curl -X POST "https://api.marswave.ai/openapi/v1/storybook/episodes" \
  -H "Authorization: Bearer $LISTENHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sources": [
      {"type": "url", "content": "https://example.com/quarterly-report"}
    ],
    "language": "zh",
    "mode": "slides",
    "skipAudio": true
  }'

반환된 episodeId를 폴링한 뒤, 필요하면 영상을 렌더링하세요 — 워크플로를 참고하세요.