@tiktool/live 2.6.4 → 2.6.6

package/README.md

@@ -41,6 +41,81 @@ await live.connect();
 
 ---
 
+## 🚀 Try It Now — 60-Second Live Demo
+
+Copy-paste this into a file and run it. Connects to a live TikTok stream, prints every event for 60 seconds, then exits. Works on the free Sandbox tier.
+
+**Save as `demo.mjs` and run with `node demo.mjs`:**
+
+```javascript
+// demo.mjs — TikTok LIVE in 60 seconds
+// npm install @tiktool/live
+import { TikTokLive } from '@tiktool/live';
+
+const API_KEY       = 'YOUR_API_KEY';        // Get free key → https://tik.tools
+const LIVE_USERNAME = 'tv_asahi_news';       // Any live TikTok username
+
+const live = new TikTokLive({ uniqueId: LIVE_USERNAME, apiKey: API_KEY });
+let events = 0;
+
+live.on('chat',        e => { events++; console.log(`💬 ${e.user.uniqueId}: ${e.comment}`); });
+live.on('gift',        e => { events++; console.log(`🎁 ${e.user.uniqueId} sent ${e.giftName} (${e.diamondCount}💎)`); });
+live.on('like',        e => { events++; console.log(`❤️  ${e.user.uniqueId} liked × ${e.likeCount}`); });
+live.on('member',      e => { events++; console.log(`👋 ${e.user.uniqueId} joined`); });
+live.on('follow',      e => { events++; console.log(`➕ ${e.user.uniqueId} followed`); });
+live.on('share',       e => { events++; console.log(`🔗 ${e.user.uniqueId} shared`); });
+live.on('roomUserSeq', e => { events++; console.log(`👀 Viewers: ${e.viewerCount}`); });
+live.on('subscribe',   e => { events++; console.log(`⭐ ${e.user.uniqueId} subscribed`); });
+live.on('battle',      e => { events++; console.log(`⚔️  Battle update`); });
+
+live.on('connected',   () => console.log(`\n✅ Connected to @${LIVE_USERNAME} — listening for 60s...\n`));
+live.on('disconnected', () => console.log(`\n📊 Done! Received ${events} events.\n`));
+
+await live.connect();
+setTimeout(() => { live.disconnect(); }, 60_000);
+```
+
+<details>
+<summary><strong>🔌 Pure WebSocket version (no SDK, any language)</strong></summary>
+
+Works with any WebSocket client. No dependencies except `ws` (Node.js) or your language's WebSocket library.
+
+```javascript
+// ws-demo.mjs — Pure WebSocket, zero SDK
+// npm install ws
+import WebSocket from 'ws';
+
+const API_KEY       = 'YOUR_API_KEY';
+const LIVE_USERNAME = 'tv_asahi_news';
+
+const ws = new WebSocket(`wss://api.tik.tools?uniqueId=${LIVE_USERNAME}&apiKey=${API_KEY}`);
+let events = 0;
+
+ws.on('open', () => console.log(`\n✅ Connected to @${LIVE_USERNAME} — listening for 60s...\n`));
+ws.on('message', (raw) => {
+  const msg = JSON.parse(raw);
+  events++;
+  const d = msg.data || {};
+  const user = d.user?.uniqueId || d.uniqueId || '';
+  switch (msg.event) {
+    case 'chat':        console.log(`💬 ${user}: ${d.comment}`); break;
+    case 'gift':        console.log(`🎁 ${user} sent ${d.giftName} (${d.diamondCount}💎)`); break;
+    case 'like':        console.log(`❤️  ${user} liked × ${d.likeCount}`); break;
+    case 'member':      console.log(`👋 ${user} joined`); break;
+    case 'roomUserSeq': console.log(`👀 Viewers: ${d.viewerCount}`); break;
+    case 'roomInfo':    console.log(`📡 Room: ${msg.roomId}`); break;
+    default:            console.log(`📦 ${msg.event}`); break;
+  }
+});
+ws.on('close', () => console.log(`\n📊 Done! Received ${events} events.\n`));
+
+setTimeout(() => ws.close(), 60_000);
+```
+
+</details>
+
+---
+
 ## How It Works
 
 ```
@@ -202,24 +277,15 @@ wss://api.tik.tools/captions?uniqueId=USERNAME&apiKey=YOUR_KEY&translate=en&diar
 
 ### Caption Credits
 
-Every API key includes a **60-minute free trial** for live captions (speech-to-text with auto-detect to any language).
-
-| Tier | Included Credits | Additional Top-Ups |
-|------|-----------------|-------------------|
-| **Free** | 60 min free trial | — |
-| **Pro** | 2,000 min/month | Available |
-| **Ultra** | 10,000 min/month | Available |
-
-**Top-Up Packages:**
+Caption credits are **pay-as-you-go add-ons** — no credits are included in the base subscription. Requires Basic tier or higher.
 
 | Package | Credits | Price | Per Credit |
 |---------|---------|-------|------------|
-| Starter | 150 min | $4.99 | $0.033/min |
-| Growth | 600 min | $14.99 | $0.025/min |
-| Scale | 2,000 min | $39.99 | $0.020/min |
-| Whale | 10,000 min | $149.99 | $0.015/min |
+| **Starter** | 1,000 min | $10 | $0.010/min |
+| **Creator** | 5,000 min | $35 | $0.007/min |
+| **Agency** | 20,000 min | $100 | $0.005/min |
 
-> **1 credit = 1 minute** of audio transcribed/translated into one language.
+> **1 credit = 1 minute** of audio transcribed/translated into one language. If translating to 2 languages simultaneously, it burns 2 credits per minute.
 
 Try the live demo at [tik.tools/captions](https://tik.tools/captions) — see real-time transcription and translation on actual TikTok LIVE streams.
 
@@ -263,13 +329,19 @@ Try the live demo at [tik.tools/captions](https://tik.tools/captions) — see re
 
 All API requests require an API key. Get yours at [tik.tools](https://tik.tools).
 
-| Tier | Rate Limit | WS Connections | Bulk Check | Feed Discovery | Caption Credits | Price |
-|------|-----------|----------------|------------|----------------|-----------------|-------|
-| **Free** | 30/min | 3 | 5 | ✕ | 60 min trial | Free |
-| **Pro** | 120/min | 50 | 50 | 100/day | 2,000/month | Paid |
-| **Ultra** | Unlimited | 10,000 | 500 | 2,000/day | 10,000/month | Paid |
+| Tier | Requests/Day | Rate Limit | WS Connections | WS Duration | WS Connects | Bulk Check | CAPTCHA | Feed Discovery | Price |
+|------|-------------|-----------|----------------|-------------|-------------|------------|---------|----------------|-------|
+| **Sandbox** | 50 | 5/min | 1 | 60 sec | 10/hr · 30/day | 1 | ✕ | ✕ | Free |
+| **Basic** | 10,000 | 60/min | 3 | 8 hours | 60/hr · 200/day | 10 | ✕ | ✕ | From $7/wk |
+| **Pro** | 75,000 | Unlimited | 50 | 8 hours | Unlimited | 50 | 50/day | 100/day | From $15/wk |
+| **Ultra** | 300,000 | Unlimited | 500 | 8 hours | Unlimited | 500 | 500/day | 2,000/day | From $45/wk |
+
+**Caption Credits** are available as pay-as-you-go add-ons (1 credit = 1 min of audio in 1 language):
+- **Starter**: 1,000 credits — $10
+- **Creator**: 5,000 credits — $35
+- **Agency**: 20,000 credits — $100
 
-The SDK calls the sign server **once per connection**, then stays connected via WebSocket. A free key is sufficient for most use cases.
+The SDK calls the sign server **once per connection**, then stays connected via WebSocket. Sandbox is for API verification only — use Basic or higher for production.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tiktool/live",
-    "version": "2.6.4",
+    "version": "2.6.6",
     "description": "TikTok LIVE API Client — Real-time chat, gifts, viewers, live captions (speech-to-text), AI transcription & translation from any TikTok livestream.",
     "author": "tiktool",
     "license": "MIT",
@@ -74,4 +74,4 @@
     "engines": {
         "node": ">=18"
     }
-}
+}