> For the complete documentation index, see [llms.txt](https://docs.videograph.ai/llms.txt).
> Use it to discover all available pages before exploring further.

# Videograph Documentation

A high-level overview of Videograph for developers getting started with VOD and live streaming using Videograph plug-and-play video APIs.

<Columns cols="2">
  <Card title="Authentication & Access Control" href="/authentication" image="https://blob-cdn.documentation.ai/org-b713c195-07b6-46aa-b0f6-7e28b1a72b11/doc-dbecd5b1-e16f-4af5-9dff-ae113c6cd9de/1765282848167-6ynbk9wcckf-pasted-image-1765282847195.png?q=85&fm=auto&auto=compress%2Cformat" cta="Set up authentication" horizontal="false" target="_self">
    Generate environment-scoped tokens and authenticate API calls.
  </Card>

  <Card title="Content Model & Playback Basics" href="/core-video-pipeline" image="https://blob-cdn.documentation.ai/org-b713c195-07b6-46aa-b0f6-7e28b1a72b11/doc-dbecd5b1-e16f-4af5-9dff-ae113c6cd9de/1765282928507-zxbear8fmf-pasted-image-1765282927313.png?q=85&fm=auto&auto=compress%2Cformat" cta="Learn the content model" horizontal="false" target="_self">
    Understand how content objects and playback identifiers work.
  </Card>

  <Card title="VOD Overview" href="/vod-uploading-ingesting" image="https://blob-cdn.documentation.ai/org-b713c195-07b6-46aa-b0f6-7e28b1a72b11/doc-dbecd5b1-e16f-4af5-9dff-ae113c6cd9de/1765282861351-if74xmdr7t-pasted-image-1765282860317.png?q=85&fm=auto&auto=compress%2Cformat" cta="Upload your first VOD" horizontal="false" target="_self">
    Upload your first VOD asset using a file or remote URL.
  </Card>

  <Card title="Live Streaming Overview" href="/live-stream-basics" image="https://blob-cdn.documentation.ai/org-b713c195-07b6-46aa-b0f6-7e28b1a72b11/doc-dbecd5b1-e16f-4af5-9dff-ae113c6cd9de/1765282900915-ejbcb7rx4nj-pasted-image-1765282900000.png?q=85&fm=auto&auto=compress%2Cformat" cta="Create a live stream" horizontal="false" target="_self">
    Create your first live stream, connect an encoder, and publish using HLS.
  </Card>
</Columns>

## What Videograph provides

Videograph offers plug-and-play APIs for adding video on demand (VOD) and live streaming to your application. With a single API call, you can upload, stream, or publish content across devices using adaptive HLS playback.

You work inside an organization environment, where each environment holds its own content and access credentials.

<Callout kind="info" collapsed="false">
  To begin, create a free Videograph account and generate access tokens in your environment. All API calls use Basic authentication. See [Authentication & Access Control](/authentication).
</Callout>

## Core getting-started flow

Videograph centers on three essential flows that every developer uses when integrating video:

<Steps>
  <Step title="Authenticate your requests" icon="key" title-type="p">
    Generate an access token and secret within your environment.\
    Use them as Basic auth credentials in every API call.\
    Follow the setup steps in [Authentication & Access Control](/authentication).
  </Step>

  <Step title="Add video on demand" icon="upload" title-type="p">
    Create VOD content by supplying a title and a `content` array containing at least one source URL.\
    Videograph processes the file and returns a playback identifier for HLS delivery.\
    Start with [Uploading Videos (Dashboard & API)](/vod-uploading-ingesting).
  </Step>

  <Step title="Create live streams" icon="cast" title-type="p">
    Create a live stream with fields such as `title`, `region`, and `record`.\
    Videograph returns ingest URLs and a stream key for your encoder.\
    Once active, the stream exposes an HLS playback URL.\
    Learn more in [Live Streaming Overview](/live-stream-basics).
  </Step>
</Steps>

<Callout kind="info" collapsed="false">
  For details on how Videograph handles ingest, processing, and playback identifiers across VOD and live, see [Content Model & Playback Basics](/core-video-pipeline).
</Callout>

## Environments

Each organization environment maintains separate VOD content, live streams, and API credentials. This makes it easy to keep development, staging, and production isolated.

## Dashboard overview

The Videograph dashboard provides a visual interface for managing resources in your environment.

<Columns cols="3">
  <Card title="Content management" href="/vod-uploading-ingesting" icon="video" horizontal="false">
    Upload VOD assets, monitor processing, and retrieve playback identifiers.
  </Card>

  <Card title="Live streaming" href="/live-stream-basics" icon="cast" horizontal="false">
    Create live streams, obtain ingest URLs, and access playback endpoints.
  </Card>

  <Card title="API credentials" href="/authentication" icon="key" horizontal="false">
    Generate access tokens and secrets for authenticated API requests.
  </Card>
</Columns>

## VOD and live at a glance

<Tabs>
  <Tab title="Video on Demand" icon="film">
    - Submit a title and a `content` array with one or more source URLs.

    - Videograph processes the file into adaptive streaming formats.

    - Use the returned playback identifier with any HLS player.

    - Start with [Uploading Videos (Dashboard & API)](/vod-uploading-ingesting).
  </Tab>

  <Tab title="Live streaming" icon="cast">
    - Create a live stream with minimal required fields.

    - Push RTMP or RTMPS input using the provided ingest endpoints.

    - Retrieve the `playbackUrl` once the stream becomes active.

    - Learn more in [Live Streaming Overview](/live-stream-basics).
  </Tab>
</Tabs>