Authorizations
API key for authentication. Can also be passed as query parameter: api_key=
Body
application/json
Response
Segmentation complete
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>"
}
]
}
}Expose segmentation as a standalone capability for previously analyzed calls.
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>"
}
]
}
}API key for authentication. Can also be passed as query parameter: api_key=
Segmentation complete
Show child attributes