API 레퍼런스설명 영상과 슬라이드
설명 영상과 스토리
info 모드와 story 모드 — 각각 무엇을 그리는지, 언제 어느 쪽을 고르는지, 그리고 둘을 가르는 하나의 필드.
info와 story는 공용 storybook 엔드포인트의 세 가지 모드 중 두 가지입니다. 엔드포인트,
요청 파라미터, 폴링, 상태, 영상 렌더링 단계는
설명 영상과 슬라이드 개요를 참고하세요. 이 페이지는
두 모드에 고유한 내용만 다룹니다.
mode는 선택 사항이며, 생략하면 info가 됩니다. 요청의 나머지 부분은 두 모드가 완전히 동일합니다 —
같은 엔드포인트, 같은 파라미터, 같은 응답 구조입니다.
개요 페이지의 모드 표에 각 모드가 무엇을 그리는지
정리돼 있습니다.
언제 어느 쪽을 고르는가
소스에 보여줄 만한 구조가 있을 때 info를 고릅니다: 비교, 프로세스, 일련의 수치 같은 것들입니다.
비주얼은 차트와 다이어그램 위주이고, 표지는 매거진 특집 기사처럼 읽힙니다.
소스가 하나의 서사일 때 story를 고릅니다: 고객 여정, 창업 스토리, 사례 연구 같은 것들입니다.
비주얼은 다이어그램이 아니라 장면 일러스트이므로, 통계 데이터 한 페이지는 차트로 플롯되는 것이 아니라
장면으로 그려져 반환됩니다.
예시
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"}
],
"speakers": [{"speakerId": "<SPEAKER_ID>"}],
"language": "en",
"mode": "info"
}'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": "How a two-person team shipped their first product in ninety days..."}
],
"speakers": [{"speakerId": "<SPEAKER_ID>"}],
"language": "en",
"mode": "story"
}'둘 다 episodeId를 반환합니다. 이를 폴링한 뒤, 필요하면 영상을 렌더링하세요 —
워크플로를 참고하세요.