REST ClientCalling

live_transcribe

View as MarkdownOpen in Claude

Start live transcription on an active call. Unlike standard transcription, live transcription streams partial results in real time as the caller speaks, enabling display of in-progress speech.

Request

dialobjectRequired
OR
updateobjectRequired
OR
calling.endobjectRequired
OR
calling.disconnectobjectRequired
OR
calling.ai_holdobjectRequired
OR
calling.ai_unholdobjectRequired
OR
calling.ai_messageobjectRequired
OR
calling.ai.stopobjectRequired
OR
calling.playobjectRequired
OR
calling.play.pauseobjectRequired
OR
calling.play.resumeobjectRequired
OR
calling.play.stopobjectRequired
OR
calling.play.volumeobjectRequired
OR
calling.recordobjectRequired
OR
calling.record.pauseobjectRequired
OR
calling.record.resumeobjectRequired
OR
calling.record.stopobjectRequired
OR
calling.collectobjectRequired
OR
calling.collect.stopobjectRequired
OR
calling.collect.start_input_timersobjectRequired
OR
calling.detectobjectRequired
OR
calling.detect.stopobjectRequired
OR
calling.tapobjectRequired
OR
calling.tap.stopobjectRequired
OR
calling.streamobjectRequired
OR
calling.stream.stopobjectRequired
OR
calling.denoiseobjectRequired
OR
calling.denoise.stopobjectRequired
OR
calling.transcribeobjectRequired
OR
calling.transcribe.stopobjectRequired
OR
calling.live_transcribeobjectRequired
OR
calling.live_translateobjectRequired
OR
calling.transferobjectRequired
OR
calling.send_fax.stopobjectRequired
OR
calling.receive_fax.stopobjectRequired
OR
calling.referobjectRequired
OR
calling.user_eventobjectRequired

Response

Call LegobjectRequired
OR
Fabric Subscriber Device LegobjectRequired

Response Example

Response
1{
2  "id": "0e9c80d7-a149-4917-892d-420043709f45",
3  "from": "+12069708643",
4  "to": "+15550198765",
5  "direction": "outbound-api",
6  "source": "realtime_api",
7  "charge": 0,
8  "created_at": "2024-05-06T12:20:00Z",
9  "charge_details": [
10    {
11      "description": "Outbound Voice",
12      "charge": 0.004
13    }
14  ],
15  "status": "queued",
16  "type": "relay_pstn_call"
17}

Example

1from signalwire.rest import RestClient
2
3client = RestClient(
4    project="your-project-id",
5    token="your-api-token",
6    host="your-space.signalwire.com",
7)
8
9client.calling.live_transcribe(
10    call_id="call-id-xxx",
11    action={
12        "start": {
13            "lang": "en-US",
14            "direction": ["local-caller", "remote-caller"],
15            "webhook": "https://example.com/transcription-events",
16            "live_events": True,
17        }
18    },
19)