Get started

Introduction

Programmatic access to AI-hosted live streams — start streams, track them in real time, and pull analytics. Built for live-commerce brands.

Base URL: https://live.twintone.ai/api/v1 Auth: Authorization: Bearer *** (create keys in DEVELOPERS → API Keys) Access: test keys free, live keys on Growth and above · Cost: no separate API charge. API streams use your plan's streaming minutes, the same as dashboard streams. See API pricing

Doc	What it covers
Quickstart	Zero → first stream in <5 minutes (curl).
Authentication	Key types (`tt_live_`/`tt_test_`), scopes, storage model, rotation.
Use TwinTone in Muse	Connect TwinTone to Meta's Muse agent via a user-built custom connector.
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.
MCP server	Remote MCP tools (Streamable HTTP) for AI assistants and agents.
Errors & rate limits	Error codes, rate limits, retry guidance.
API pricing	Plans with API access, how minutes are counted, running out.
Support & FAQ	How to get help, common questions.
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.

Quickstart

Was this page helpful?