Audio-Kapitel für Podcast-Apps

Podcast-Apps mit Unterstützung für Podcasting-2.0-Kapitel erwarten eine kleine JSON-Datei, die vom RSS-Element der Episode verlinkt wird—nicht Kapitel-Tags, die im MP3 stecken. Diese Fähigkeit nimmt Ihre geordneten Kapitelzeilen—Titel plus Startzeit in Sekunden, mit optionalem Bild und URL pro Kapitel—und liefert das standardisierte versionierte chapters-Objekt sowie eine formattierte json_text-Zeichenkette, die Sie hosten und mit dem podcast:chapters-Tag referenzieren können. Sind die Startzeiten nicht streng aufsteigend, schlägt die Aufgabe mit invalid_input fehl, damit fehlerhafte Marker den Feed nie erreichen.

So sieht Podcasting-2.0-Kapitel-JSON aus

Diese Datei ist ein JSON-Objekt, dessen Pflichtschlüssel version (üblicherweise 1.2.0) und chapters sind—ein Array von Markern, geordnet nach aufsteigendem startTime. Optionale Dateiebene-Felder wie author, title, podcastName und description helfen Webplayern und Archiven, ohne zu ändern, wie Apps im Audio springen. Dieser Exporter mappt Ihre zeilenorientierte Eingabe—start_time und title je Kapitel, optional img und url—in diese camelCase-Form, damit Sie weder Klammern von Hand editieren noch die Versionszeichenkette vergessen. Hosten Sie den resultierenden json_text unter einer stabilen HTTPS-URL und fügen Sie podcast:chapters mit type application/json+chapters im Item hinzu.

Eingabevertrag, Antwortform und Validierungsregeln

Optionale Ausgabeschlüssel werden ganz weggelassen statt auf null gesetzt. Senden Sie per POST einen JSON-Body mit einem Pflicht-Array chapters aus mindestens einem Objekt. Jedes Objekt muss title als nicht leere Zeichenkette und start_time als endliche nicht negative Sekundenzahl enthalten (Aliasse wie startTime werden je Zeile akzeptiert). Optionale Felder pro Kapitel sind img und url als nicht leere Strings, toc als boolesch (false markiert ein stilles Kapitel; true ist Standard und entfällt im Export) sowie end_time als nicht negative Zahl nicht kleiner als der Start dieses Kapitels. Optionale Dateiebene-Strings—version (Standard 1.2.0), episode_title, author, podcast_name und description—werden bei Angabe in das chapters-Objekt kopiert. Bei Erfolg liefert der Body version, chapter_count, chapters als Podcasting-2.0-Array mit startTime-Schlüsseln, json_text als formatierte Upload-Datei, mime_type application/json+chapters sowie gelieferte Episodenmetadaten unter author, title, podcast_name und description. Validierungsfehler werfen invalid_input und werden nicht abgerechnet: fehlende chapters, leerer title, negative oder nicht endliche Zeiten, Ende vor Start, mehr als fünfhundert Zeilen oder Startzeiten, die nicht streng aufsteigend sind. Beispiel: drei Zeilen bei null, hundertzwanzig und eintausendachthundert Sekunden mit Bild und Link im mittleren Kapitel erzeugen ein chapters-Array mit drei Einträgen und einen json_text, der strukturell den öffentlichen Podcasting-2.0-Beispielen entspricht.

Wo ein deterministischer Kapitel-Exporter sich lohnt

Transkript- oder Kapitelvorschlags-Tools, die schlichte Titel-Sekunden-Paare ausgeben, können ihr Ergebnis hierher leiten und das app-seitige Format erhalten, ohne Podcasting-2.0-Wissen in jeden Client einzubetten. Fehlgeschlagene Validierung wird nicht berechnet. Kombinieren Sie diesen Exporter mit getrennten ASR-Kapitelgeneratoren, wenn Zeitstempel aus dem Audio erfunden werden müssen; nutzen Sie diesen Pfad, wenn Marker bereits bekannt sind und nur ein standardkonformer Export fehlt. Unabhängige Produzierende, die eine Episode in einer DAW abschließen, haben Zeitstempel bereits in Tabelle oder Shownotes; sie brauchen eine korrekte JSON-Datei, ohne den Namespace in jeder App per Versuch und Irrtum zu lernen. Weil die Implementierung pure parse der Stufe A ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Basispreis $0.002 ohne Modell-Tokens und ohne ausgehendes Netz. Halten Sie Kapiteltitel kurz genug für mobile Inhaltsverzeichnis-UIs, bevorzugen Sie absolute HTTPS-URLs für img und url, und führen Sie den Formatter nach jeder Bearbeitung erneut aus, damit streng aufsteigende Ordnung erzwungen bleibt.