TwinToneTwinToneAPI Docs

Resources

Support & FAQ

Getting help

  • Email: info@twintone.ai — include your brand id (from any API response) and the stream_id / webhook_id you're asking about. We reply within one business day.
  • Dashboard: twintone-customer-app.vercel.app/dashboard — keys, billing, wallet, streams.
  • Sales / Enterprise (24/7 always-on, custom rate limits): same email, subject "Enterprise".

Frequently asked questions

Do API calls use my plan minutes? No. API usage bills per streamed minute from your credit wallet, which is separate from the plan minutes you use in the dashboard. See API pricing.

What plan do I need for API access? Growth ($799/mo) or above. Keys can be created on any signed-in account, but POST /streams returns 402 plan_required on Starter.

What's the difference between tt_test_ and tt_live_ keys? Same endpoints, same response shapes. Test keys never dispatch an agent and never bill — streams return status: "live" immediately with "test": true so you can exercise the full lifecycle (including DELETE) for free. Go live by swapping in a live key — no other code changes.

How many streams can I run at once? 3 concurrent (preparing + live) per brand. A 4th returns 429 concurrency_limit. Need more? Email us — Enterprise is always-on.

My key leaked / I lost my key. What now? Revoke it immediately in Billing → API keys — it stops working instantly. We store only a SHA-256 hash, so lost keys can't be recovered; create a new one.

Can I get notified when a stream starts/ends instead of polling? Yes — register a webhook (POST /api/v1/webhooks) and we'll push stream.started / stream.ended / stream.error with an HMAC signature you can verify. See Webhooks.

Do you have an SDK? Not yet — the API is 4 endpoint groups and curl-friendly by design. When we ship one it will be JavaScript/TypeScript first. The OpenAPI spec generates a client in any language today.

Which platforms can I stream to? YouTube, TikTok, Twitch, Kick, Facebook, Instagram. iGaming brands: see the iGaming guide for the compliance checklist.

Where's my data? Streams, keys, and analytics live in our Supabase project (ap-south-1). We never store plaintext API keys — only SHA-256 hashes.

Was this page helpful?