Skip to main content

Bintu API

Bintu is the stream-management system at the core of nanoStream Cloud. It ties together encoders, CDN playout, recordings, and playback clients into a single managed workflow so you can deliver ultra-low-latency live streaming globally. If you are new to nanoStream Cloud, start with the Core Concepts.

You can work with Bintu in two ways:

Both interfaces operate on the same underlying system: API-created streams appear in the Dashboard instantly, and Dashboard changes are reflected via the API.

Bintu REST API Reference

The complete API specification, all endpoints, parameters, workflows, and response schemas, is available at doc.pages.nanocosmos.de/bintuapi-docs.
Use this when you need full request samples, field descriptions, and advanced configuration.

When to use Dashboard vs API​

The dashboard and API serve different but complementary purposes. The choice depends on your workflow, your level of automation, and your operational requirements. Use the comparison below to choose the right interface for each task:

DashboardREST API
Use the Dashboard when you want a visual management experience. It is ideal for quickly creating streams, adjusting configurations, inspecting ingest/playout URLs, validating transcoding results, or monitoring status.
Non-technical team members (operations, editorial, event managers) typically use the Dashboard for day-to-day handling.		Use the API when you need automation, scaling, or integration.
Typical use cases include backend-driven event creation, stream provisioning in CMS/CRM systems, dynamically creating streams per customer session, or triggering workflows such as ABR setup, tagging, and metadata injection.

Most users combine both: Dashboard for visibility and operations, API for automation.

Prerequisite​

Account (Trial or Paid)​

To use Bintu (Dashboard or API), you need a nanoStream Cloud account.
If you do not have one yet, create it here: dashboard.nanostream.cloud/signup.

If you need guidance regarding plans, multi-region distribution, SLA options or larger configurations, feel free to reach out via nanocosmos.net/contact oder per mail sales(at)nanocosmos.net . We're happy to assist you in finding the best setup for your use case.

getting started

Wir haben einen Docs Eintrag nur für die drei Wege, das nanoStream Cloud Dashboard zu accessen:

API Key​

To work with the Dashboard, no additional credentials are required beyond your account login. If you want to use the REST API directly, you need the API key of your organization. You can find and copy it on your organization overview page: dashboard.nanostream.cloud/organisation.

Use this key in the X-BINTU-APIKEY header for all API requests.

Streaming Setup​

If you want to start streaming quickly, the Getting Started guide shows how to:

  • create and configure streams
  • ingest live content using nanoStream Webcaster, OBS, Osprey Talon, or any RTMP/RTSP encoder
  • validate ultra-low-latency playback using the H5Live Player

API Basics​

The Bintu REST API provides programmatic access to stream management.

URL
API Entry pointhttps://bintu.nanocosmos.de
Official Documentationhttps://doc.pages.nanocosmos.de/bintuapi-docs/

API Examples​

The following examples illustrate how to interact with the Bintu API. Each example includes a cURL command and a JavaScript snippet for direct use in backend applications.

For additional languages, advanced configuration options, and complete request/response samples, please refer to the official bintu API documentation: doc.pages.nanocosmos.de/bintuapi-docs. The API reference provides full details on all available endpoints and workflows.

Get latest live stream​

Retrieves the newest stream(s) in your organization (default is 50). This is useful for dashboards, monitoring tools, or backend systems that need quick access to recently created streams.

API Reference
doc.pages.nanocosmos.de/bintuapi-docs/#operation/Stream%20Collection%20Info

Parameters

  • X-BINTU-APIKEY: your API key for authentication
  • QUANTITY: number of returned stream objects

cURL

bintu/get_latest_stream.sh
curl -X GET "https://bintu.nanocosmos.de/stream?quantity=1" \
-H 'content-type: application/json' \
-H 'x-bintu-apikey: YOUR_BINTU_API_KEY'

JavaScript

bintu/get_latest_stream.js
fetch("https://bintu.nanocosmos.de/stream?quantity=1", {
  method: "GET",
  headers: { "x-bintu-apikey": BINTU_API_KEY }
}).then(response => response.json());

Create MBR/ABR Stream including live transcoding​

Creates a new stream with multiple transcoding profiles. MBR/ABR streaming automatically generates multiple output qualities inside nanoStream Cloud, enabling ultra-low-latency playback even in low-bandwidth environments.

Good to know

A multi-bitrate stream (MBR) is transcoded into streams of varying quality to enable the playback of streams with extremely low latency at low bandwidth.

To understand what multi-bitrate streams are and how adaptive bitrate and live transcoding work, take a look at our dedicated explanation page.

API Reference
doc.pages.nanocosmos.de/bintuapi-docs/#operation/Create%20Stream

Parameters

  • YOUR_STREAM_ID: the unique ID of your stream in nanoStream Cloud
  • X-BINTU-APIKEY: your API key for authentication

Body

  • TRANSCODES: transcoding profiles you want to enable
  • TAGS: useful for grouping, filtering, or searching streams

cURL

bintu/create_stream.sh
curl 'https://bintu.nanocosmos.de/stream' \
  -H 'content-type: application/json' \
  -H 'accept: application/json' \
  -H 'x-bintu-apikey: YOUR_BINTU_API_KEY' \
  --data-raw '{
    "transcodes": [
      { "profile": "vtrans2-852x480x800x25", "tags": ["foo", "bar"] },
      { "profile": "vtrans2-640x360x400x25", "tags": [] }
    ]
  }'

JavaScript

bintu/create_stream.js
fetch("https://bintu.nanocosmos.de/stream", {
  method: "POST",
  headers: { "x-bintu-apikey": BINTU_API_KEY },
  body: JSON.stringify({
    transcodes: [
      { profile: "vtrans2-852x480x800x25", tags: ["foo", "bar"] },
      { profile: "vtrans2-640x360x400x25", tags: [] }
    ]
  })
});

Support​

If you have questions, need assistance with integration, or want help designing the right workflow for your use case, our support team is ready to assist you:

For operational questions or issues with an existing project, please include your stream id or organization name to help us assist you more efficiently.

Last updated on