Get started
Introduction
Programmatic access to AI-hosted live streams — start streams, track them in real time, and pull analytics. Built for iGaming operators and live-commerce brands.
Base URL: https://live.twintone.ai/api/v1
Auth: Authorization: Bearer *** (create keys in DEVELOPERS → API Keys)
Access: Growth plan and above (live keys) · Cost: API streams bill from a
separate credit wallet — $0.40/min (Live Commerce) or $0.75/min (iGaming). See
API pricing
Contents
| Doc | What it covers |
|---|---|
| Quickstart | Zero → first stream in <5 minutes (curl). |
| Authentication | Key types (tt_live_/tt_test_), scopes, storage model, rotation. |
| Creators | List available AI creators (avatars). |
| Streams | Start / list / get / end streams. Lifecycle & status enums. |
| Webhooks | Events, HMAC signature verification, retries, idempotency. |
| Analytics | Usage aggregates, period filters, platform breakdown. |
| Errors & rate limits | Error codes, rate limits, retry guidance. |
| API pricing | Plan minutes, live-key plan gate, test keys. |
| Support & FAQ | How to get help, common questions. |
| iGaming guide | The igaming vertical: casino livestreams, platform notes, compliance pointers, test keys. |
| Changelog | Version history and API updates. |
30-second version
# 1. Start a stream
curl -X POST https://live.twintone.ai/api/v1/streams \
-H "Authorization: Bearer ***" \
-H "Content-Type: application/json" \
-d '{"creator_id":"avt_9ww075quzedr","product_name":"Radiance Serum","platform":"youtube","duration_minutes":30}'
# 2. We push stream.started / stream.ended to your webhook (or poll GET /streams/{id})
# 3. End it
curl -X DELETE https://live.twintone.ai/api/v1/streams/{id} -H "Authorization: Bearer ***"
Status: v1 (early access) — endpoints are stable but surface area is small by design. Clips and UGC-generation endpoints land next; webhook event taxonomies are versioned so additions never break existing integrations.
Was this page helpful?