ORIGINAL TRANSCRIPT
Yes, I was just saying that the meeting was moved to Thursday afternoon.
TRANSLATED TRANSCRIPT
Sí, justo estaba diciendo que la reunión se trasladó al jueves por la tarde.
---
## (b) Streaming / Real-Time Translation
Streaming sessions are designed for low-latency, real-time use cases.
In this approach:
- audio is streamed in real-time
- transcripts + translated audio is returned in real-time
This example intentionally leaves playback or storage to the user's preference.
#### Create a streaming session:
```python
from pinch import PinchClient
from pinch.session import SessionParams
client = PinchClient()
session = client.create_session(
SessionParams(
source_language="en-US",
target_language="es-ES",
)
)
```
This session represents a live translation context.
#### Connect a streaming transport:
```python
stream = await client.connect_stream(
session,
audio_output_enabled=True,
)
```
Once connected:
- the stream accepts incoming audio
- transcripts and translated audio are emitted as events
#### Stream audio into Pinch:
Audio is sent as raw PCM16 frames (for example, 20 ms chunks).
```python
await stream.send_pcm16(
pcm_bytes,
sample_rate=16000,
channels=1,
)
```
You can send audio from:
- a microphone
- a WAV file
- another real-time source
Pinch processes audio incrementally as it arrives.
#### Receive streaming outputs:
Pinch returns results as asynchronous events.
```python
async for event in stream.events():
if event.type == "transcript":
# Transcript metadata + text
print(
event.kind, # "original" | "translated"
event.is_final, # True/False for final vs interim
event.language_detected, # e.g. "en-US" when available
event.text,
)
elif event.type == "audio":
# Translated speech as raw PCM16 bytes
pcm_bytes = event.pcm16_bytes
sample_rate = event.sample_rate
# Forward, buffer, save, or play this audio as needed
```
> Audio is returned as data, not played automatically. Applications decide how to handle playback or storage.
#### Detected language in transcript events
For `event.type == "transcript"`, the SDK includes:
- `event.language_detected` - language code detected for that segment (for example, `en-US`)
- `event.kind` - whether the transcript is `original` or `translated`
- `event.is_final` - whether the transcript segment is final or interim
#### Close the stream:
```python
await stream.aclose()
```
Closing the stream signals that no more audio will be sent.
---
## Input audio requirements
- Input must be **16-bit PCM WAV**
- Supported sample rates:
- **16,000 Hz** (recommended)
- **48,000 Hz**
- Other sample rates require resampling helpers: