Skip to content
HALOWERK

Tonwerk

guest briefing

Uses supplied speaker-labeled turns only. Question-marked sentences from another speaker immediately followed by the target become source-linked candidates; other question sentences remain separately visible. Quotes carry exact UTF-16 offsets and a bounded next-target-turn excerpt. Groups only identical normalized wording; lexical Dice review pairs stay separate. Reuses the existing statistical episode-topic-map method on titles, target turns and paired question turns. No language model,.

POST https://ton.halowerk.com/v1/guest-briefing

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
target_speaker_idstringYesConsistent caller-assigned target speaker label across all episodes; identity is not inferred.
languagestringNoICU sentence boundary locale; statistical stop words cover German and English.
episodesarrayYes
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "target_speaker_id",
    "episodes"
  ],
  "properties": {
    "target_speaker_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,32}$",
      "maxLength": 32,
      "description": "Consistent caller-assigned target speaker label across all episodes; identity is not inferred."
    },
    "language": {
      "type": "string",
      "enum": [
        "de",
        "en"
      ],
      "default": "de",
      "description": "ICU sentence boundary locale; statistical stop words cover German and English."
    },
    "episodes": {
      "type": "array",
      "minItems": 2,
      "maxItems": 12,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "title",
          "turns"
        ],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_.-]{1,64}$",
            "maxLength": 64
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "maxLength": 160
          },
          "turns": {
            "type": "array",
            "minItems": 1,
            "maxItems": 200,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "speaker_id",
                "text"
              ],
              "properties": {
                "speaker_id": {
                  "type": "string",
                  "pattern": "^[A-Za-z0-9_-]{1,32}$",
                  "maxLength": 32
                },
                "text": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 4000,
                  "description": "Original plain text retained for verbatim quotes and UTF-16 offsets."
                },
                "start_seconds": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 86400
                },
                "end_seconds": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 86400
                }
              }
            }
          }
        }
      }
    }
  }
}

Open original schema

Published input example

{
  "target_speaker_id": "guest",
  "episodes": [
    {
      "id": "e1",
      "title": "Podcast planen",
      "turns": [
        {
          "speaker_id": "host",
          "text": "Wie planst du deinen Podcast?"
        },
        {
          "speaker_id": "guest",
          "text": "Ich plane jeden Podcast mit einer Themenliste."
        }
      ]
    },
    {
      "id": "e2",
      "title": "Themenliste weiterentwickeln",
      "turns": [
        {
          "speaker_id": "host",
          "text": "Wie planst du deinen Podcast?"
        },
        {
          "speaker_id": "guest",
          "text": "Meine Themenliste sammelt Themen für den Podcast."
        }
      ]
    }
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →