챕터

챕터 노드는 팟캐스트나 인터뷰 녹화의 챕터를 한 번에 나열합니다. 녹화를 녹취하고, 제목과 시작 시간이 있는 챕터를 찾습니다. 쇼 노트나 동영상 설명에 바로 붙여 넣을 수 있습니다. 아무것도 렌더링하지 않으며, 결과는 텍스트입니다.

내부에서 노드는 직접 연결해 만들 수 있는 것과 같은 단계를 실행합니다. 화자 레이블과 단어 타이밍이 있는 음성 텍스트 변환, 그리고 챕터 모드의 편집 계획입니다. 각 단계는 자체 작업으로 실행되므로, 긴 녹화, 취소, 실패는 직접 만든 워크플로에서와 똑같이 동작합니다.

챕터는 계획 단계를 Nodaro Cloud에서 실행합니다. 셀프 호스팅 설치에서는 연동 › nodaro.ai에서 또는 API 키로 설치를 Nodaro Cloud에 연결하세요. 연결이 없으면 노드가 제공되지 않으며, 실행은 아무것도 시작되기 전에 거부됩니다.

사용 시기

• 팟캐스트 에피소드의 쇼 노트에 챕터 표시를 넣을 때.
• 동영상 설명에 타임스탬프를 넣을 때.
• 긴 인터뷰나 강의의 목차를 만들 때.
• 챕터 목록을 JSON으로 플레이어, 웹사이트 또는 워크플로의 다음 단계에 넘길 때.

이미 녹취가 있다면 챕터 모드의 편집 계획을 직접 쓰세요. 에피소드를 다듬는 작업도 하려면 에피소드 다듬기를 쓰세요.

빠른 시작

입력

3시간보다 긴 녹화나 소리가 없는 녹화는 청구되기 전에 거부됩니다. 녹화를 여러 개 연결하면 실행은 첫 번째 녹화를 읽습니다.

출력

쇼 노트를 쓰는 방식:

• 첫 챕터는 0:00에 시작합니다. 청취자의 플레이어가 재생을 시작하는 위치입니다.
• 시간은 필요할 때만 표시됩니다. 1:00:00 이후에 시작하는 챕터가 있으면 모든 줄이 시간을 포함합니다: 0:00:00 Intro, 1:04:10 Questions. 마지막 챕터가 58:00에 시작하는 70분 에피소드는 짧은 형식을 유지합니다.
• 시간은 늘어나기만 합니다. 두 챕터가 같은 초에 시작하면 첫 번째만 남고 나머지는 빠집니다. 처음 1초 안에 시작하는 챕터도 빠집니다.
• 제목은 한 줄입니다. 제목 안의 줄 바꿈과 연속된 공백은 공백 하나가 됩니다.

게시한 앱에서는 쇼 노트가 텍스트로 표시됩니다.

설정

실행이 실패하면

완료된 단계는 완료된 상태로 남습니다. 녹취는 유지되며 다시 청구되지 않습니다. 노드에서 계속을 누르세요. 실패한 단계와 그 뒤의 단계만 다시 실행됩니다.

목록에서 입력받는 노드는 항목마다 한 번씩 실행됩니다. 계속 버튼이 없으므로 대신 다시 실행하세요.

계획이 챕터를 찾지 못하면 실행은 “The plan found no chapters in this recording.”(이 녹음에서 챕터를 찾지 못했습니다)라는 메시지와 함께 실패합니다. 실행당 수수료는 환불됩니다. 녹취와 계획은 실행되었으므로 각자의 요금으로 청구됩니다. 모든 단계가 완료되었으므로 이 실행은 이어서 할 수 없으며, 노드에 계속이 표시되지 않습니다. 다른 지침이나 다른 녹화로 노드를 다시 실행하세요.

크레딧

챕터는 각 단계를 해당 노드와 같은 각자의 요금으로 청구하고, 실행마다 소액의 수수료가 더해집니다. 노드는 실행 전에 수수료를 포함한 전체 예상치를 보여 줍니다.

• 실행당 수수료는 실행마다 한 번 청구됩니다. 실패한 실행의 수수료는 환불되며, 계속을 누르면 다시 예약됩니다.
• 목록은 각 항목을 별도의 실행으로 처리하며, 항목마다 수수료가 있습니다.
• 예상치는 편집 계획과 같은 방식으로 녹화의 분을 셉니다. 길이를 알 수 없는 녹화는 상한인 180분으로 예상됩니다. 편집 계획이 분을 세는 방식은 편집 계획에서 설명합니다.

팁

• 원하는 챕터 수를 알려 주세요. 지침으로 챕터 수와 제목 스타일을 정하세요. 예: titles under six words(제목은 여섯 단어 미만).
• 알맞은 출력을 쓰세요. 쇼 노트는 텍스트 필드나 게시 단계에 연결하세요. 시작 시간을 숫자로 써야 할 때는 챕터(JSON)를 연결하세요.
• 이코노미로 시작하세요. 기본값은 이코노미입니다. 챕터가 더 정확해야 하면 더 높은 계획 품질을 써 보세요.

문제 해결

API에서 사용

POST /v1/episode-chapters는 실행을 시작하고 jobId와 executionId를 담아 202로 응답합니다. 본문에는 mediaUrls(녹화 URL 하나)를 넣고, 선택적으로 planTier, instructions, styleGuide를 넣습니다. 작업은 GET /v1/jobs/:id/status로 폴링하세요.

• 작업의 output_data에는 쇼 노트(text), 챕터 목록(json), 편집 계획이 만든 그대로의 계획(plan), 녹취(transcript)가 들어 있습니다. 실패한 실행은 완료된 부분을 유지하고, 실패한 단계를 failedStep에 표시합니다.
• Idempotency-Key 헤더를 붙이면 같은 요청을 재시도했을 때 같은 jobId와 "deduped": true로 응답하며, 아무것도 시작하지 않습니다.
• POST /v1/episode-chapters/estimate는 같은 본문을 받아, 아무것도 시작하지 않고 { data: { totalCredits, stepsCredits, feeCredits, durationSec } }로 응답합니다.
• POST /v1/episode-chapters/continue에 { jobId, "mode": "from-failed" }를 보내면 실패한 실행이 완료하지 못한 부분을 실행합니다. 모든 단계가 완료된 실행은 409 continuation_not_failed로 응답합니다. 챕터는 아무것도 렌더링하지 않으므로 "mode": "render-final"은 render_final_not_preview로 응답합니다.

SDK(client.edit.episodeChapters, client.edit.estimateEpisodeChapters, client.edit.continueUseCase), CLI(nodaro edit episode-chapters, 예상치는 --estimate, 그리고 nodaro edit continue-use-case), MCP make_chapters, estimate_use_case, continue_use_case 도구는 같은 라우트를 호출합니다. 단일 노드 실행, SDK에서 편집, MCP 분석 및 EDL 도구를 참조하세요.