TwinToneAPI Docs

Get started

API pricing

There is no separate charge for the API. Streams you start through the API use the streaming minutes included in your plan, the same pool as streams you start from the dashboard.

Plans with API access

PlanPriceStreaming hours / monthLive API keys
Starter$880/mo40Not included
Growth$1,900/mo100✅
Always-On$6,800/mo400✅

Test keys (tt_test_) are free for any account with a confirmed email. Live keys (tt_live_) need an active Growth or Always-On plan.

How minutes are counted

  • A live-key stream counts the duration_minutes you booked, after it has gone live and reached ended or stopped with real start/end timestamps. Ending it early with DELETE does not reduce that final booked-duration amount. While it is live, plan availability includes elapsed in-flight minutes.
  • A stream that never reaches live, or that fails with stream.error, uses no minutes. preparing time is never counted.
  • Test-key (tt_test_) streams never use minutes. They are simulated: up to 3 at a time per brand, counted separately from live streams, and each ends on its own after 30 minutes.
  • Your allowance resets at the start of each billing period.

Running out

When the minutes you've used, plus time on streams running right now, reach your plan's allowance, new live streams are rejected with 402 no_minutes. Upgrade your plan in the dashboard under Settings → Billing.

Checking usage

Plan usage is shown in the dashboard under DEVELOPERS → Usage and Settings → Billing. GET /api/v1/analytics reports total_minutes as actual streamed time, which can be lower than plan minutes used because a live stream counts its booked duration.

Higher volumes

Need more hours or custom terms? Email us for enterprise pricing.

Was this page helpful?