Skip to main content
POST
/
segment
/
conversation
Segment conversation
curl --request POST \
  --url https://api.illocution.ai/segment/conversation \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "timeline": [
    {
      "utterance_id": "<string>",
      "speaker": "<string>",
      "t_start": 123,
      "t_end": 123,
      "text": "<string>",
      "asr_confidence": 123,
      "prosody": {},
      "prosody_desc": "<string>",
      "emotion": {},
      "sentiment": {},
      "polarity": 123,
      "subjectivity": 123,
      "cognitive": {},
      "commitment_score": 123,
      "commitment_level": "<string>",
      "passion_score": 123,
      "passion_level": "<string>",
      "conviction_score": 123,
      "lexical_markers": {},
      "acoustic_reasoning": "<string>",
      "confidence": 123
    }
  ]
}
'
{
  "segmentation": {
    "phases": [
      {
        "phase_id": "<string>",
        "phase_name": "<string>",
        "start_timestamp": 123,
        "end_timestamp": 123,
        "start_utterance_id": "<string>",
        "end_utterance_id": "<string>",
        "utterance_count": 123,
        "theme": "<string>",
        "summary": "<string>",
        "emotional_tone": "<string>",
        "key_moments": [
          {
            "moment_id": "<string>",
            "category": "objection",
            "speaker_id": "<string>",
            "start_ms": 123,
            "end_ms": 123,
            "utterance_ids": [
              "<string>"
            ],
            "summary": "<string>",
            "labels": [
              "<string>"
            ],
            "confidence": 123
          }
        ],
        "transition_signal": {
          "transition_id": "<string>",
          "at_ms": 123,
          "from_state": {},
          "to_state": {},
          "evidence_utterance_ids": [
            "<string>"
          ],
          "drivers": {},
          "confidence": 123,
          "stability": "<string>"
        }
      }
    ],
    "total_phases": 123,
    "segmentation_rationale": "<string>",
    "narrative_arc": "<string>",
    "key_transitions": [
      {
        "transition_id": "<string>",
        "at_ms": 123,
        "from_state": {},
        "to_state": {},
        "evidence_utterance_ids": [
          "<string>"
        ],
        "drivers": {},
        "confidence": 123,
        "stability": "<string>"
      }
    ]
  }
}

Authorizations

X-API-Key
string
header
required

API key for authentication. Can also be passed as query parameter: api_key=

Body

application/json
timeline
object[]
required

Full timeline array from /analyze

context
string

Optional context for segmentation (e.g., "Highlight where trust improved")

Response

Segmentation complete

segmentation
object