NodaroAccount
Nodaro ドキュメント
ドキュメントノードリファレンスモデルテンプレートAI エージェント(MCP)開発者向けセルフホスティングリサーチ比較
TypeScript SDK

編集

TypeScript から、ポッドキャストや長い動画を編集します。エピソードの引き締め、クリップ、チャプター、予告編の作成、カメラの同期と切り替え、編集決定リストのレンダリングができます。

client.edit には、ポッドキャストや長い動画のための編集ツールがまとまっています。1 回の呼び出しで、エピソード全体を引き締め、チャプターを一覧にし、予告編や短いクリップのセットを切り出し、録音を話者ごとにフレーミングします。また、無音を見つけ、複数の録音の時間を揃え、誰がどのカメラに映っているかを見つけ、文字起こしからカットをプランし、編集決定リスト(EDL)をレンダリングします。ほとんどのメソッドはジョブを開始してその ID を返し、client.jobs.getStatus() でポーリングします。estimate... のメソッドと editPlanCapabilities() は何も開始せず、remapTranscript() はリクエストなしでローカルに実行されます。

メソッド

メソッドエンドポイント内容
edit.tightenEpisode(input, options?)POST /v1/tighten-episode1 回の呼び出しで、録音を引き締めて完成したエピソードにします
edit.episodeChapters(input, options?)POST /v1/episode-chapters1 回の呼び出しで、録音のチャプターを一覧にします。何もレンダリングされません
edit.episodeTrailer(input, options?)POST /v1/episode-trailer選んだ SNS の形式ごとに、20〜40 秒の予告編を切り出します
edit.clipPack(input, options?)POST /v1/clip-pack録音を、短いクリップのセットに切り出します
edit.speakerLayout(input, options?)POST /v1/speaker-layout何もカットせずに、録音全体を話者ごとにフレーミングします
edit.estimateTightenEpisode(input) とほかの estimate... メソッドPOST /v1/<type>/estimate上の 5 つの実行のいずれかを見積もります。何も作成されず、課金もされません
edit.continueUseCase(input, options?)POST /v1/<type>/continueそれらの実行を、新しいジョブとして続行します
edit.silenceDetect(input)POST /v1/silence-detectオーディオまたは動画のソースから、無音の範囲を見つけます
edit.audioSync(input)POST /v1/audio-sync2〜6 件の録音の間の時間のずれを測ります
edit.speakerMap(input)POST /v1/speaker-mapカメラ自身のマイクから、各話者がどのカメラに映っているかを見つけます
edit.editPlan(input)POST /v1/edit-plan文字起こしから、詰めたカット、短いクリップ、チャプター、予告編のいずれかをプランします
edit.editPlanCapabilities()GET /v1/edit-plan/capabilitiesこのサーバーがプランできる編集プランのモードを読み取ります。課金はされません
edit.cameraSwitch(input)POST /v1/camera-switchEDL の各カットを、話している人のカメラに置きます
edit.applyEdl(input)POST /v1/apply-edlEDL を動画ファイルまたは音声ファイルにレンダリングします
edit.remapTranscript(edl, transcript)なし、ローカル文字起こしのタイミングを、編集後のタイムラインに移します

コードでポッドキャストを編集する

エピソード全体なら、tightenEpisode() が以下のすべてのステップを 1 回の呼び出しで実行します。各ステップを細かく制御したい場合は、ステップを 1 つずつ使ってください。

録音を文字起こしする

単語単位のタイミングを返すエンジンを指定して、client.audio.transcribe() を実行します。その output_data.json が、プランに必要な文字起こしです。

無音を見つける

マスター録音に対して silenceDetect() を実行します。その output_data.json に、無音の範囲が入ります。

カットをプランする

文字起こし、ソース、無音の情報を指定して、editPlan() を tighten モードで実行します。プランは unwrapEditPlanOutput() で読み取ります。

レンダリングする

プランを applyEdl() に渡します。完了したジョブに、編集後の動画または音声が入ります。

動画アップロードエピソード文字起こし単語単位のタイミング無音検出編集プラン間詰めEDL 適用
ノードと同じ編集の連鎖です。文字起こしと無音の検出を行い、詰めたカットをプランして、レンダリングします。
import { unwrapEditPlanOutput } from "@nodaro/sdk"

async function outputOf(jobId: string): Promise<any> {
  for (;;) {
    const { data } = await client.jobs.getStatus(jobId)
    if (data.status === "completed") return data.output_data
    if (data.status === "failed" || data.status === "cancelled") throw new Error(data.error_message ?? data.status)
    await new Promise((resolve) => setTimeout(resolve, 3_000))
  }
}

// 1. Transcribe with word timings
const tr = await client.audio.transcribe({ audioUrl: masterUrl, provider: "elevenlabs-stt" })
const transcript = (await outputOf(tr.jobId)).json

// 2. Find the silence
const sd = await client.edit.silenceDetect({ audioUrl: masterUrl, thresholdDb: -35 })
const silence = (await outputOf(sd.jobId)).json

// 3. Plan a tighter cut
const plan = await client.edit.editPlan({
  mode: "tighten",
  planTier: "standard",
  transcript,
  sources: [{ id: "ep", url: masterUrl, kind: "video", role: "master-audio" }],
  silence,
})
const edl = unwrapEditPlanOutput(await outputOf(plan.jobId))

// 4. Render the plan
const render = await client.edit.applyEdl({ edl, output: "video", quality: "final" })
const { videoUrl } = await outputOf(render.jobId)

同じ手順が、ノードとしても存在します。文字起こし、無音検出、編集プラン、EDL 適用です。

複数のカメラの場合の手順

複数のカメラで撮影した会話では、3 つのステップを加えます。たとえば diarize: true を指定して、話者ラベル付きで文字起こしします。

  1. audioSync() で、録音の時計がどれだけずれているかを測ります。
  2. offsets を指定した editPlan() で、マスターの時間軸で編集をプランします。
  3. speakerMap() で誰がどのカメラに映っているかを見つけ、cameraSwitch() で各カットを話者のカメラに置きます。

そのあと、切り替えた EDL を applyEdl() でレンダリングします。最初にプレビュー、次に最終版です。

client.edit

1 回の呼び出しで録音全体を編集する

5 つのメソッドが、対応するノードと同じく、編集の連鎖全体を 1 回の呼び出しで実行します。どれも { jobId, executionId?, deduped? }(UseCaseJobResult)を返します。それぞれに estimate... メソッドがあり、同じ入力を見積もって、何も開始しません。実行の料金は、各ステップのそれぞれの料金に、実行ごとの固定の手数料を足したものです。

options.idempotencyKey は Idempotency-Key ヘッダーとして送られます。同じキーで同じリクエストを再試行すると、すでに開始された実行が deduped: true とともに返されます。

1 つの会話の複数の録音

tightenEpisode()、episodeTrailer()、clipPack()、speakerLayout() は、1 つの会話のカメラも受け付けます(UseCaseRecordingsInput)。実行では録音の時間を揃え、誰がどのカメラに映っているかを判断し、話している人に切り替えます。

プロパティ

型

mediaUrl または mediaUrls を送ってください。両方を送るか、どちらも送らない場合は、リクエストの前に TypeError で拒否されます。複数の録音やマスターオーディオには、話者マップが必要です。 話者マップを利用できない場合、リクエストは何かが読み取られたり課金されたりする前に 403 node_not_available で拒否されます。

複数の録音またはマスターオーディオで完了した実行は、出力に cameras を加えます:{ speakers: [{ speaker, ordinal, camera, marginDb }], syncNotes, mapNotes }。誰をどの録音に置いたかを示し、camera: null は引きの映像を意味します。

const multicam = await client.edit.tightenEpisode({
  mediaUrls: [hostCamUrl, guestCamUrl],
  masterAudioUrl: mixerUrl,
  cameras: { wide: null },
})

edit.tightenEpisode(input, options?) と estimateTightenEpisode(input)

エピソードを引き締めるノードと同じように、1 回の呼び出しでポッドキャストの録音を引き締めます。実行では、録音を文字起こしし、引き締めたカットをプランしてレンダリングします。設定に応じて、エピソードに字幕を付け、フレーミングし、BGM を敷きます。必須なのは録音だけで、省略したフィールドにはノードのデフォルトが使われます。

tightenEpisode(input: TightenEpisodeInput, options?: { idempotencyKey?: string }): Promise<TightenEpisodeJobResult>
estimateTightenEpisode(input: TightenEpisodeInput): Promise<{ data: TightenEpisodeEstimate }>

プロパティ

型

const quote = await client.edit.estimateTightenEpisode({ mediaUrl: episodeUrl })
console.log(quote.data.totalCredits)

const { jobId } = await client.edit.tightenEpisode(
  { mediaUrl: episodeUrl, framing: { aspect: "9:16", layout: "auto" } },
  { idempotencyKey: crypto.randomUUID() },
)

jobId をポーリングしてください。完了したジョブの output_data には、エピソードが videoUrl(音声のエピソードでは audioUrl)として入ります。また、プランの EDL が json に、quality が入ります。quality は、確認用のプレビューでは "proxy"、それ以外では "final" です。

estimateTightenEpisode() は { totalCredits, stepsCredits, feeCredits, durationSec, estimate? } を返します。実行の各ステップのそれぞれの料金に、実行ごとの固定の手数料を足したものです。estimate: true は、ステップが従量課金の LLM 呼び出しの見積もりであることを意味するので、合計は ≈N と表示してください。編集の内容がわかる前に、録音の全長でレンダリングの料金を計算するので、見積もりは高めになります。実際の課金は、実際にレンダリングされた分数に従います。録音の長さを読み取れなかった場合、durationSec は null です。クレジットのないエディションでは、すべてのクレジットの額が 0 です。

どちらのメソッドも、何かが作成されたり課金されたりする前に拒否します:

  • 400 には validation_error、media_unreadable、media_has_no_audio、media_too_long、music_has_no_audio のいずれかが入ります。複数の録音では、too_many_recordings、recordings_two_audio_only、wide_camera_out_of_range、invalid_cameras、master_audio_unreadable も入ることがあります。
  • 403 には node_not_available が入ります。
  • 503 には nodaro_connection_required、provider_key_missing、use_case_unavailable のいずれかが入ります。provider_key_missing は、セルフホスティングのインストールに、ステップが必要とする文字起こしのキーがなく、それをまかなう Nodaro Cloud への接続もないことを意味します。メッセージにキーの名前が示されます。

残高が見積もりに足りない場合、tightenEpisode() は InsufficientCreditsError もスローします。セルフホスティングのインストールでは、Nodaro Cloud で実行されるステップに Nodaro Cloud への接続が必要です。

edit.episodeChapters(input, options?) と estimateEpisodeChapters(input)

チャプターノードと同じく、1 回の呼び出しでポッドキャストの録音のチャプターを一覧にします。実行では録音を文字起こしし、チャプターをプランします。各チャプターにはタイトルと開始時刻があります。何もレンダリングされません。

episodeChapters(input: EpisodeChaptersInput, options?: { idempotencyKey?: string }): Promise<UseCaseJobResult>
estimateEpisodeChapters(input: EpisodeChaptersInput): Promise<{ data: UseCaseEstimate }>

プロパティ

型

const chapters = await client.edit.episodeChapters({ mediaUrl: masterUrl })

完了したジョブの output_data.text は、ショーノートとしてのチャプターの一覧です。チャプターごとに M:SS Title の行が 1 行あり、最初の行は 0:00 です。1:00:00 以降に始まるチャプターがある場合、すべての行が H:MM:SS になります。output_data.json は、同じ一覧を [{ startMs, title }] として持ちます。チャプターが見つからない実行は失敗し、手数料は返還されます。

チャプターの実行は、すべてのステップが完了しているため、続行できません。continueUseCase() は 409 continuation_not_failed を返します。代わりに、もう一度実行してください。長さを読み取れない録音は、見積もりでは 180 分として計算されます。どちらのメソッドも、音楽に関するものを除き、tightenEpisode() と同じコードで拒否します。

edit.episodeTrailer(input, options?) と estimateEpisodeTrailer(input)

トレーラーノードと同じく、ポッドキャストの録音から 20〜40 秒の予告編を切り出します。実行では、録音のいちばん強い場面から予告編をプランし、レンダリングします。任意のイントロカードを先に再生し、選んだ形式ごとに予告編をパディングします。切り抜くことはありません。長さはプランが選び、場面は独自の短いクロスフェードでつながれます。

episodeTrailer(input: EpisodeTrailerInput, options?: { idempotencyKey?: string }): Promise<UseCaseJobResult>
estimateEpisodeTrailer(input: EpisodeTrailerInput): Promise<{ data: UseCaseEstimate }>

プロパティ

型

完了したジョブの output_data.formats は [{ format, url }] で、選んだ形式ごとに予告編が 1 本あります。output_data.videoUrl はレンダリングできた最初の形式の予告編で、json は予告編の EDL です。確認用のプレビューでは、quality が "proxy"、videoUrl がプレビューになり、formats は最終レンダリングまで [] です。

レンダリングできなかった形式は、output_data.failedFormats に示されます。実行はほかの形式で完了し、手数料はそのままで、その形式の分は課金されません。どの形式もレンダリングできなかった実行は失敗し、手数料は返還されます。

見積もりでは、プランが切り出す最長の 40 秒で予告編を計算します。どちらのメソッドも、音楽に関するものを除き、tightenEpisode() と同じコードで拒否します。さらに、400 media_needs_video、再生できる動画ではないイントロカードの 400 intro_card_unreadable、400 intro_card_too_long が加わります。

edit.clipPack(input, options?) と estimateClipPack(input)

クリップパックノードと同じく、ポッドキャストの録音を短いクリップのセットに切り出します。実行では、それぞれタイトルとフックを持つクリップをプランし、1 本ずつクリップとしてレンダリングします。デフォルトでは、各動画クリップは話者を縦に並べた 9:16 でフレーミングされ、字幕が付きます。音声の録音からは、フレーミングや字幕のない音声クリップが作られます。複数のカメラでは、各クリップが話している人に切り替わります。

clipPack(input: ClipPackInput, options?: { idempotencyKey?: string }): Promise<UseCaseJobResult>
estimateClipPack(input: ClipPackInput): Promise<{ data: UseCaseEstimate }>

プロパティ

型

完了したジョブの output_data.clips は [{ url, title?, hook?, clipKey, thumbnailUrl?, captionsFailed? }] で、プランの順にクリップごとに 1 件です。output_data.videoUrl は最初のクリップで、音声クリップでは audioUrl です。

すべてのクリップが試されます。レンダリングできなかったクリップは飛ばされ、課金されず、output_data.failedClips に数えられます。字幕を付けられなかったクリップは字幕なしで届き、captionsFailed: true が付き、その字幕は課金されません。どのクリップもレンダリングできなかった実行は失敗し、手数料は返還されます。

見積もりでは、各クリップを目標の長さの 2 倍で計算し、実際の課金は各クリップの実際の長さに従います。どちらのメソッドも、音楽に関するものを除き、tightenEpisode() と同じコードで拒否します。

edit.speakerLayout(input, options?) と estimateSpeakerLayout(input)

スピーカーレイアウトノードと同じく、録音全体を話者ごとにフレーミングします。結果の長さは同じで、何もカットされません。複数の録音では、各話者がそれぞれのカメラで映ります。

speakerLayout(input: SpeakerLayoutInput, options?: { idempotencyKey?: string }): Promise<UseCaseJobResult>
estimateSpeakerLayout(input: SpeakerLayoutInput): Promise<{ data: UseCaseEstimate }>

プロパティ

型

完了したジョブの output_data.videoUrl はフレーミングした動画で、durationSec はその長さ、json は編集、transcript は文字起こしです。1 件の録音での実行は、開始する前に録音のサイズを読み取ります。1 分間にそうした実行を多く開始すると、429 rate_limit_exceeded で拒否されることがあります。少し待ってから再試行してください。

見積もりでは、録音の全長にわたって、話者ビューを高いほうの料金で計算します。どちらのメソッドも、音楽に関するものを除き、tightenEpisode() と同じコードで拒否します。

edit.continueUseCase(input, options?)

エピソードを引き締める、チャプター、トレーラー、クリップパック、スピーカーレイアウトの実行を新しいジョブとして続行し、{ jobId, executionId?, deduped? } を返します。

continueUseCase(input: UseCaseContinueInput, options?: { idempotencyKey?: string }): Promise<UseCaseJobResult>

プロパティ

型

どのルートか。 nodeType がある場合、続行はそのタイプのルートに直接送られます。ない場合、continueUseCase はまずジョブを読み取り(GET /v1/jobs/:id)、実行が記録しているタイプを調べてから、そのタイプのルートで続行します。この読み取りには、接続したアプリのトークンに jobs:read スコープが必要です。タイプを読み取れない場合、continueUseCase はコード use_case_type_unknown(400)の NodaroError をスローし、何も送りません。読み取りを省くには、nodeType を渡します。古いバージョンの SDK は新しいタイプを知らないことがあるので、それらの実行を続行するにはアップグレードしてください。

const preview = await client.edit.tightenEpisode({ mediaUrl: episodeUrl, reviewBeforeRender: true })
// ...after a person reviews the preview:
const final = await client.edit.continueUseCase({ jobId: preview.jobId, mode: "render-final" })

最終レンダリングが完了していても、編集を変えた同じプレビューの最終レンダリングは妨げられません。その場合、最終のステップがもう一度実行されて課金されますが、手数料はかかりません。まったく同じ編集をもう一度レンダリングすることは拒否されます。拒否は、実行が作成される前にスローされます。別のジョブを示す拒否は ContinuationRefusedError をスローします。これはステータス 409 の NodaroError で、その jobId がそのジョブです。コードは 3 つあります。already_running は、続行が進行中か完了していることを意味します。そのジョブを追跡してください。continuation_superseded は、後の続行も失敗したことを意味します。代わりにそのジョブを続行してください。render_final_already_rendered は、そのジョブの結果を使ってください、という意味です。

ほかの拒否には、not_found、continuation_not_found、continuation_not_failed、continuation_not_completed があります。continuation_settling は少し待ってから再試行してください、という意味で、render_final_not_preview は、そのジョブが確認用のプレビューではないことを意味します。use_case_nothing_kept(409)は、クリップを 1 本も残さないクリップパックの確認です。支払う人がまかなえない実行では、InsufficientCreditsError がスローされます。

edit.silenceDetect(input)

オーディオまたは動画のソースから、無音の範囲を見つけます。サーバー上で、AI モデルなしに実行されます。

silenceDetect(input: SilenceDetectInput): Promise<{ jobId: string }>

プロパティ

型

const { jobId } = await client.edit.silenceDetect({ audioUrl: masterUrl, minSilenceMs: 900 })

完了したジョブの output_data.json は、SilenceRanges オブジェクトです。{ version, ranges: [{ startMs, endMs }], durationMs } です。このオブジェクト全体を、silence として editPlan() に渡します。映像だけの動画のように音のないソースでは、ジョブは失敗し、クレジットは返還されます。

edit.audioSync(input)

1 つの会話を収録した 2〜6 件の録音について、その音から、時計がどれだけずれているかを測ります。音声同期ノードと同じ処理です。サーバー上で、AI モデルなしに実行されます。料金は、最初の 1 件を除き、ソース 1 件につき 11 クレジットです。2 件のソースで 11、4 件で 33、6 件で 55 です。

audioSync(input: AudioSyncInput): Promise<{ jobId: string }>

プロパティ

型

const { jobId } = await client.edit.audioSync({
  sources: [
    { id: "mic", url: micUrl },
    { id: "camA", url: camAUrl },
  ],
  reference: "mic",
})
// Wait for the job to finish. output_data is typed unknown, so name the result's type.
let job = (await client.jobs.getStatus(jobId)).data
while (job.status !== "completed" && job.status !== "failed" && job.status !== "cancelled") {
  await new Promise((r) => setTimeout(r, 2000))
  job = (await client.jobs.getStatus(jobId)).data
}
const sync = (job.output_data as { json: AudioSyncResult }).json

完了したジョブの output_data.json は、AudioSyncResult です。

{
  version: number
  reference: string // the source every offset is measured against
  offsets: Array<{
    sourceId: string
    offsetMs: number              // referenceMs = sourceMs + offsetMs
    confidence: number            // 0 to 1; below 0.5 a note asks you to check by ear
    driftMsPerHour: number | null // measured, never corrected; null when the overlap was too short
  }>
  notes: string[] // low confidence, drift above 33 ms over the overlap, no shared sound
}

マスター録音を reference にすると、各 offsetMs は、あなたの EDL におけるそのソースの offsetMs と正確に一致します。不正な形式のリクエストは、クレジットが確保される前に、code が validation_error の NodaroError で拒否されます。これには、ソースが 2 件未満または 6 件を超える場合、id が重複している場合、reference がどの id とも一致しない場合が含まれます。

edit.speakerMap(input)

話者マップノードと同じく、カメラ自身のマイクから、各話者がどのカメラに映っているかを見つけます。サーバー上で AI モデルなしに実行され、料金は 1 回の実行につき定額です。

speakerMap(input: SpeakerMapInput): Promise<{ jobId: string }>

プロパティ

型

完了したジョブの output_data.json は SpeakerMapResult で、output_data.edl は、マスターの時間軸で録音を 1 つの編集にしたものです:

{
  version: 1
  speakerMap: Record<string, string>   // speaker label → camera id; "" = no clear camera (the wide shot, else any camera with picture)
  confidence: Record<string, { camera: string; marginDb: number | null }> // the loudest camera's lead over the next
  notes: string[]                      // no clear camera, a camera with no sound, and more
  edl?: Edl                            // the recordings as one edit (also on output_data.edl)
}

話者が話している間、その声をいちばん大きく、marginDb 以上の差で聞き取るカメラが、その話者のカメラになります。何も聞き取らなかったカメラはメモになり、失敗にはなりません。不正な形式のリクエストは NodaroError(400、validation_error)を、話者ラベルのない文字起こしは 422 no_speakers をスローします。どちらも、クレジットが確保される前です。

const { jobId } = await client.edit.speakerMap({
  sources: [{ id: "camA", url: camAUrl }, { id: "camB", url: camBUrl }, { id: "wide", url: wideUrl }],
  transcript,
  offsets: sync,          // an audioSync result
  wideSourceId: "wide",
})
// ...wait for the job to finish, as for audioSync above, then:
const map = ((await client.jobs.getStatus(jobId)).data.output_data as { json: SpeakerMapResult }).json
await client.edit.cameraSwitch({ edl, transcript, speakerMapResult: map })

edit.editPlan(input)

タイミング付きの文字起こしから、編集をプランします。編集プランノードと同じ処理です。4 種類のプランのいずれかを作成します。録音全体を詰めたカット、短いクリップのセット、チャプター、予告編です。

editPlan(input: EditPlanInput): Promise<{ jobId: string }>

プロパティ

型

import { unwrapEditPlanOutput } from "@nodaro/sdk"

const { jobId } = await client.edit.editPlan({
  mode: "clips",
  planTier: "standard",
  transcript,
  sources: [{ id: "ep", url: masterUrl, kind: "video", role: "master-audio" }],
  silence,
  count: 5,
  targetAspect: "9:16",
})
const { data } = await client.jobs.getStatus(jobId) // poll until completed
const clips = unwrapEditPlanOutput(data.output_data) // one EDL per clip

完了したジョブの出力は、unwrapEditPlanOutput() で読み取ります。tighten と trailer モードでは Edl を、clips モードでは Edl の配列を、chapters モードでは ChapterSet を返します。

offsets を指定すると、editPlan() はリクエストの前にソースをチェックします。ソースが測定されていない、一致が弱い、またはマスターが測定されていない場合は、そのソースを示す edit_plan_sources コードの NodaroError をスローします。その場合は、そのソースの offsetMs を手動で設定してください。各カットは、その部分の映像を持つ最初のカメラに置かれます。

セルフホスティング環境では、このメソッドに Nodaro Cloud への接続が必要です。接続がない場合、503 nodaro_connection_required で失敗します。

edit.editPlanCapabilities()

このサーバーがプランできる編集プランのモードを読み取ります(GET /v1/edit-plan/capabilities)。何も作成されず、課金もされません。応答にないモードを指定した editPlan() は 400 mode_not_available で拒否されるので、モードを提示する前に確認してください。

editPlanCapabilities(): Promise<EditPlanCapabilities>
フィールド型説明
modesEditPlanMode[]このサーバーがプランするモードです。tighten、clips、chapters は常に含まれ、trailer はサーバーが予告編をプランできるようになると含まれます。
source"server" | "nodaro.ai" | "nodaro.ai-unreachable"応答した相手です。このサーバー、接続したセルフホスティングのインストールに対する Nodaro Cloud、または Nodaro Cloud に届かなかった接続済みのセルフホスティングのインストールです。最後の場合は、tighten、clips、chapters だけが含まれます。新しいサーバーでは値が追加されることがあります。
perMinuteboolean編集プランが、録音の開始した 1 分ごとに課金される場合は true です。録音の長さを切り上げた段階で課金される場合は false です。編集プランを参照してください。

サーバーの更新で変わることがあるため、応答はキャッシュされません。

const { modes } = await client.edit.editPlanCapabilities()
if (modes.includes("trailer")) {
  await client.edit.editPlan({ mode: "trailer", planTier: "standard", transcript, sources })
}

edit.cameraSwitch(input)

カメラ切り替えノードと同じく、EDL の各カットを、話している人のカメラに置きます。料金は 1 回の実行につき定額です。Nodaro Cloud で実行されます。セルフホスティングのインストールは、Nodaro Cloud への接続を通じてこれを中継し、接続がない場合は 503 nodaro_connection_required で失敗します。

cameraSwitch(input: CameraSwitchInput): Promise<{ jobId: string }>

プロパティ

型

タイミングはすべて整数で、範囲は @nodaro/shared/edl から CAMERA_SWITCH_BOUNDS としてエクスポートされています。wide のソースがある場合、引きへの切り替えの長さに最短のショット 2 つ分を足した長さより長いショットは、引きへの切り替えの長さの時点で引きの映像に切り替わり、最短のショット 1 つ分続きます。デフォルトでは、25 秒を超えるショットが 20 秒の時点で引きの映像に切り替わります。

完了したジョブの output_data.json は切り替えた EDL で、そのまま applyEdl() に渡せます。output_data.transcript は、speakerNames を適用した文字起こしです。ルートは、課金される前に次のものを拒否します:

  • 400 invalid_edl:edl が、録音の時間軸上の 1 つの編集ではありません。たとえば、クリップセット、チャプターのプラン、レンダリングした出力の EDL です。
  • 400 validation_error:設定が範囲外か、名前が 80 文字を超えています。
  • 422 no_speakers:文字起こしに話者ラベルがありません。SDK もリクエストの前にこれをチェックします。

edit.applyEdl(input)

編集決定リストを、動画ファイルまたは音声ファイルにレンダリングします。EDL 適用ノードと同じ処理です。

applyEdl(input: ApplyEdlInput): Promise<{ jobId: string }>

プロパティ

型

const { jobId } = await client.edit.applyEdl({ edl, output: "video", quality: "proxy", crossfadeMs: 80 })

完了したジョブの output_data には、カットが入ります。videoUrl と thumbnailUrl、または audioUrl です。文字起こしを送った場合は、時間を移した文字起こしが json に入り、さらに quality("proxy" または "final")と、送った場合は clipKey と planBasis が入ります。proxy のレンダリングはプレビューで、公開ギャラリーには表示されません。プレビューと最終レンダリングと、品質ごとのクレジットを参照してください。

EDL は、クレジットが確保される前にチェックされます。不明なソース、動画編集で映像のないセグメント、1 回のレンダリングで出力が 180 分を超える場合のいずれかは、code が invalid_edl の NodaroError で失敗します。長さは、クロスフェードを適用した後で測られます。message には、問題の内容が示されます。たとえば、編集が 200 分になり、最大 180 分の部分に分割する必要がある、といった内容です。

edit.remapTranscript(edl, transcript)

文字起こしを、リクエストなしにローカルで、編集のタイムラインに移します。カットされた範囲内の単語は取り除かれ、カットをまたぐ単語は切り詰められ、すべてのタイミングが編集後の出力に合わせてずらされます。transcript を渡した場合、applyEdl() はサーバー上で同じ処理を行います。

remapTranscript(edl: Edl, transcript: Transcript): Transcript

プロパティ

型

const editedTranscript = client.edit.remapTranscript(edl, transcript)
// caption the edited video without another transcription

レンダリングや 2 回目の文字起こしなしに、編集に字幕を付けるために使います。新しいタイミングだけが必要な場合、大きな文字起こしに対しては、こちらのほうが高速な選択肢でもあります。

よくある質問

Nodaro SDK で、ポッドキャストから間を取り除くには、どうすればよいですか?

録音を文字起こしし、client.edit.silenceDetect を実行してから、文字起こしと無音の範囲を指定して client.edit.editPlan を tighten モードで実行します。返されたプランを、client.edit.applyEdl でレンダリングします。

ポッドキャストのエピソードを 1 回の呼び出しで引き締められますか?

はい。client.edit.tightenEpisode は、最長 3 時間の動画または音声の録音の URL を 1 つ受け取り、ジョブを返します。実行では、文字起こし、プラン、レンダリングを行って引き締めたエピソードを作り、任意で字幕、音楽、フレーミングを加えます。

複数のカメラで収録したポッドキャストを編集できますか?

はい。1 つの会話の録音を mediaUrls として、ミキサーのトラックを masterAudioUrl として、tightenEpisode、episodeTrailer、clipPack、speakerLayout のいずれかに渡します。実行では録音の時間を揃え、話している人に切り替えます。複数の録音には話者マップが必要です。話者マップを利用できない場合、リクエストは 403 node_not_available で拒否されます。

EDL とは何ですか?

編集決定リストのことです。編集の素材と、残すセグメントを、トランジションとともに順番に並べたものです。client.edit.editPlan がこれを作成し、client.edit.applyEdl が動画ファイルまたは音声ファイルにレンダリングします。

1 回の EDL のレンダリングは、どのくらいの長さにできますか?

1 回のレンダリングにつき、出力は最大 180 分です。これより長い編集は、クレジットが確保される前に invalid_edl で拒否されます。いくつかの部分に分けてください。

client.edit.audioSync の料金は、どのくらいですか?

最初の 1 件を除き、1 件につき 11 クレジットです。2 件の録音で 11 クレジット、4 件で 33 クレジット、6 件で 55 クレジットです。

最終更新

目次