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
}
]
}
'import requests
url = "https://api.illocution.ai/segment/conversation"
payload = { "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
}
] }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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
}
]
})
};
fetch('https://api.illocution.ai/segment/conversation', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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>",
"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>"
}
]
}
}{
"detail": "Invalid or missing API key"
}{
"detail": "Invalid or missing API key"
}Segmentation
Segment conversation
Expose segmentation as a standalone capability for previously analyzed calls.
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
}
]
}
'import requests
url = "https://api.illocution.ai/segment/conversation"
payload = { "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
}
] }
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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
}
]
})
};
fetch('https://api.illocution.ai/segment/conversation', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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>",
"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>"
}
]
}
}{
"detail": "Invalid or missing API key"
}{
"detail": "Invalid or missing API key"
}Authorizations
API key for authentication. Can also be passed as query parameter: api_key=
Body
application/json
Response
Segmentation complete
Show child attributes
Show child attributes
⌘I