Quickstart

From zero to embedded player in five minutes.

Quickstart

You’ll generate an API key, upload one video from the dashboard, then drop a single <script> + <ansdev-player> pair into any HTML page.

1. Sign in & generate an API key

   1. Sign in at ansix.ansdev.cloud.
   2. Open Profile → API Keys (/dashboard/api-keys).
   3. Click Generate New Key, give it a name, leave the default video:read scope checked.
   4. Copy the key now. It will not be shown again. Format: ak_live_ + 32 hex characters.
2. Upload a video

   1. Open Creative Tools → Smart Stream Console (/dashboard/creative).
   2. Drop a file (up to 2 GB). The Console will lock escrow on your CREATIVE wallet bucket, then transcode the file in the background.
   3. When the job hits COMPLETED, copy its public vid_… ID from the Gallery tab.
3. Make your first API call

   curl -H "x-ansdev-key: ak_live_YOUR_KEY" \
     https://api.ansdev.cloud/v1/video
   

   You should get back a JSON list containing the video you just uploaded.

4. Embed the player

   Add two lines to any HTML page:

   <script type="module" src="https://streem.ansdev.cloud/sdk/v1/player.js"></script>
   
   <ansdev-player
     api-key="ak_live_YOUR_KEY"
     video-id="vid_YOUR_VIDEO_ID">
   </ansdev-player>
   

   That’s it. The SDK fetches a 5-minute playback token, exchanges it for a CDN manifest URL, and starts streaming via hls.js. The token auto-refreshes 30 seconds before it expires.

5. (Optional) Use React

   npm install @ansdev/player-sdk hls.js
   

   import { AnsdevPlayer } from '@ansdev/player-sdk/react';
   
   export default function VideoPage() {
     return (
       <AnsdevPlayer
         apiKey="ak_live_YOUR_KEY"
         videoId="vid_YOUR_VIDEO_ID"
         onReady={(durationSec) => console.log('Ready:', durationSec)}
       />
     );
   }
   

Never commit your ak_live_… key to a public repo. Treat it like a database password — keep it in .env, secrets manager, or rotate immediately from the dashboard if it leaks.

Next steps

Authentication

Scopes, expiry, rate limits, revocation.

Player customization

JSON theming, branding, control-bar toggles.