🎬 3Speak Embed Upload

✨ Features

📖 Integration Guide

Quick Start

Upload videos using the TUS protocol with instant embed URL generation:

import * as tus from 'tus-js-client';

const file = document.getElementById('video-input').files[0];

const upload = new tus.Upload(file, {
  endpoint: 'https://embed.3speak.tv/uploads',
  headers: {
    'X-API-Key': 'your-api-key-here'
  },
  metadata: {
    filename: file.name,
    owner: 'username',
    frontend_app: 'your-app-name',
    short: 'false'  // 'true' for 60s clips
  },
  onError: (error) => {
    console.error('Upload failed:', error);
  },
  onProgress: (bytesUploaded, bytesTotal) => {
    const percent = (bytesUploaded / bytesTotal * 100).toFixed(2);
    console.log(\`Progress: \${percent}%\`);
  },
  onSuccess: () => {
    console.log('Upload complete!');
  },
  onAfterResponse: (req, res) => {
    const embedUrl = res.getHeader('X-Embed-URL');
    console.log('Embed URL:', embedUrl);
    // Use this URL immediately in your app!
  }
});

upload.start();

Embed URL Format

Videos are instantly accessible via:

https://play.3speak.tv/embed?v={username}/{videoId}

For Blog Composers (Peakd/Ecency)

Simple HTML5 video tag:

<video src="play.3speak.tv/watch?v={username}/{videoId}" controls></video>

For Websites (Full Iframe)

Full featured player with controls:

<iframe 
  src="https://play.3speak.tv/embed?v={username}/{videoId}" 
  width="100%" 
  height="500" 
  frameborder="0" 
  allowfullscreen>
</iframe>

Video Types

• Standard Videos: Set short: 'false' - Full length, multiple qualities (1080p, 720p, 480p)
• Short Videos: Set short: 'true' - Max 60 seconds, 480p only, faster encoding

API Endpoints

• POST /uploads - TUS upload endpoint (requires API key)
• GET /video/:permlink - Get video metadata
• POST /video/:permlink/thumbnail - Update video thumbnail (requires API key)
• GET /health - Service health check

Update Thumbnail

Set a custom thumbnail for your video after upload:

fetch('https://embed.3speak.tv/video/ABC123XY/thumbnail', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'your-api-key'
  },
  body: JSON.stringify({
    thumbnail_url: 'https://your-cdn.com/thumbnail.jpg'
  })
});

Required Metadata

• owner (string) - Username of video owner
• frontend_app (string) - Your application identifier
• short (string) - 'true' or 'false'
• filename (string, optional) - Original file name

🔐 Getting Access

To integrate this service into your application:

1. Contact the 3Speak development team
2. Provide your application name and use case
3. Receive your unique API key
4. Start uploading videos!