API Reference

Streams

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Add transcript

POST/v1/streams/{namespace}/transcripts

Ingest a single transcript segment for a livestream using a relative timestamp in milliseconds. The stream does not need to be created beforehand. Transcript timestamps are relative milliseconds from stream start and should be monotonically increasing within a stream so transcript context lines up correctly with later frames. This method returns immediately after the transcript has been accepted for processing.

Path ParametersExpand Collapse

namespace: string

The namespace to ingest stream data into

Body ParametersJSONExpand Collapse

stream_id: string

text: string

timestamp: number

minimum0

ReturnsExpand Collapse

requestId: string

status: "accepted"

Add transcript

HTTP

HTTP

TypeScript

Python

curl https://api.safetykit.com/v1/streams/$NAMESPACE/transcripts \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $SAFETYKIT_API_KEY" \
    -d '{
          "stream_id": "YOUR_STREAM_ID",
          "text": "This is an example transcript segment.",
          "timestamp": 5000
        }'

200 example

{
  "requestId": "req_01h2m7qdmdjckc30e1mnq6xqfd",
  "status": "accepted"
}

Returns Examples

200 example

{
  "requestId": "req_01h2m7qdmdjckc30e1mnq6xqfd",
  "status": "accepted"
}