Skip to main content

Builder Hub: Developer Mode

Everything the Builder Hub does goes through the same public APIs you can use from your own application. Developer mode shows you those calls on every tool and demo page, in order, so you can build the same thing yourself.

Turn it on​

  1. Open any tool or demo page. Developer mode is not on Home or the entry page.
  2. Switch on Developer mode at the top right of the page.

The developer panel opens above the page. It stays on as you move between pages, and the next time you visit, until you switch it off.

The Developer mode switch at the right of the bar above a tool page

The switch sits at the top right of every tool page.

What it shows​

The panel is headed Developer · <what the page does>, for example Developer · Adaptive Bitrate Streaming, with one line on how the page works in API terms. Then come the calls behind the page, numbered in the order the page makes them.

The developer panel on Set up Adaptive Bitrate: three numbered calls, the role row on each, the language switch, and the player code at the end

Set up Adaptive Bitrate in Developer mode: read the qualities, create the stream, read the group, then play it.

Each call shows:

PartWhat it is
Name and routeWhat the call does, for example Create the stream, with its method and address, for example POST bintu.nanocosmos.de/stream
RolesWhich account roles may make the call: ✓ or ✗ for nanoAdmin, nanoUser and nanoReadOnly
CodeThe full request, ready to copy with Copy
Example responseFolded under Example response, with a line on how to read it

After the calls, pages that play a stream end with the player code for your web page (marked ▶ and HTML): Play it on your page, Play and switch cameras on the multi-camera pages, or Play it with the token on Manage tokens.

Roles​

The role row tells you which logins can make a call before you try it:

RoleTypical use
nanoAdminFull access, including creating playback tokens. An admin login comes with an API key.
nanoUserCreates and changes streams, but can't create playback tokens with the Cloud Token Service
nanoReadOnlyReads streams and settings only

A call in the developer panel with the role row showing ✓ nanoAdmin, ✓ nanoUser and ✗ nanoReadOnly

Creating a stream needs nanoAdmin or nanoUser.

Six languages​

Pick a language at the top of the panel: TypeScript, cURL, JavaScript, Python, Go or PHP. Every call on the page switches together, and the hub remembers your choice for the next page. Example responses you've opened stay open when you switch.

The language switch with Python selected, and a call written in Python

The same call in Python. Every language makes exactly the same request.

Your stream, never your credentials​

The code is filled in with the stream you selected on Home, so you can run it against that stream. Your API key and tokens are never filled in. Every example reads them from an environment variable, for example BINTU_API_KEY for nanoStream Cloud calls and NANO_API_TOKEN for Analytics calls.

Keep keys on your server

API keys and playback tokens belong on your server, never in a web page. An API key comes with a nanoAdmin login; nanoUser and nanoReadOnly sign in with email and password and send the token they get back as x-bintu-token.

The panel ends with links to the full reference: the nanocosmos docs and the bintu API.

Pages with Developer mode​

PageWhat the panel shows
StreamsList every stream, newest first; read a stream back
Live wallList your live streams; play one
Create a streamSee the qualities your account offers; create the stream; play it
Set up Adaptive BitrateThe qualities; create the stream with them; see every quality in the group; play it
Record on demandSwitch on recording; read the stream back
Add AI Live Captions, Live Captions demoTurn captions on; read them back; turn them off
Set up multi-camera, Multi-Camera Preview, Multi-PlayerList your live streams; play them and switch cameras
View analyticsConcurrent viewers and traffic from the Analytics API
Manage tokensCreate a playback token; play the stream with it
Set up chroma key, Watch branded outputs, the Multi-Branding demosRead the chroma key setup; read the stream; play the branded outputs
Live & Replay PlayerSwitch on recording

For some features, for example revoking tokens or the nanoStudio API, the panel links to the docs instead.

Next steps​