AIVE ONE Beta Documentation

Quick Start

Get from zero to your first export in under five minutes. AIVE ONE Beta runs on macOS, Windows, iOS, and the web.

1. Download AIVE ONE Beta

   Grab the latest installer from aive.one/download. The Mac build requires macOS 14 Sonoma or later; Windows requires Windows 11 22H2+.

2. Sign in or create an account

   Launch the app and sign in with your AIVE ID. Free accounts include 3 projects and local export. Pro unlocks cloud render and AI features.

3. Create a new project

   Press Cmd + N (Mac) or Ctrl + N (Windows) to create a new project. Choose a resolution preset or let AIVE auto-detect from your first imported clip.

4. Import media

   Drag files into the Browser panel or press Cmd + I. AIVE supports H.264, H.265, ProRes, DNxHR, AV1, and all common audio formats.

5. Edit and export

   Drag clips to the Timeline, trim with B (blade), and hit Cmd + E to export. Choose a preset (YouTube, Instagram, ProRes Master) and go.

Installation

System Requirements

Install via Terminal (macOS)

# Install via Homebrew
brew install --cask aive-one

# Verify installation
aive --version
# AIVE ONE Beta v4.2.0 (build 12847)

Install via Terminal (Windows)

# Install via winget
winget install AiveTech.AIVE-ONE

# Verify
aive --version

Your First Project

Projects in AIVE use a library-based structure. Each project contains events, which contain clips organized in a magnetic timeline.

Project structure

My Project.aive/
  Original Media/          -- Imported source files
  Render Files/            -- Generated proxies & caches
  Events/
    Main Event/
      timeline.json        -- Connected storyline data
      clips/               -- Clip metadata
  Exports/                 -- Rendered output files
  project.aive.json        -- Project manifest

Creating a project via CLI

# Create a 4K project at 24fps
aive project create \
  --name "My Short Film" \
  --resolution "3840x2160" \
  --fps 24 \
  --color-space "rec709"

# Import an entire folder
aive import ~/Desktop/Footage/ --project "My Short Film"

Timeline

The AIVE magnetic timeline uses a connected-storyline model. Clips snap together automatically, preventing gaps and sync errors. Key concepts:

• Primary Storyline — The main track at the bottom of the timeline. All other clips connect relative to it.
• Connected Clips — B-roll, titles, and audio that attach to a point on the primary storyline and move with it.
• Compound Clips — Group multiple clips into a single container. Double-click to expand and edit internally.
• Multicam — Sync up to 64 camera angles by timecode, audio waveform, or markers. Switch angles in real time during playback.

Inspector

The Inspector panel shows properties for the selected clip, transition, or effect. It includes tabs for Video, Audio, Info, and AI analysis. Adjustments are non-destructive and keyframeable — every numeric field supports animation curves.

Browser

The Browser is where you organise, preview, and search your media. It supports filmstrip thumbnails, list view, and AI-powered smart collections. Use Keyword tags, Favourites, and Ratings to quickly locate the clips you need. Smart Collections auto-group by metadata like camera, date, or scene.

Viewer

The Viewer displays your video output with real-time effects. It supports dual-viewer mode (source vs. programme), video scopes overlay, safe margins, and transform on-screen controls. Press Shift + F for full-screen playback or V to toggle between event viewer and project viewer.

Smart Edit

Smart Edit uses on-device AI to analyse your footage and suggest cuts. It detects scene changes, speaker turns, and pacing issues. Available modes:

• Auto-Cut — Removes silences, filler words, and bad takes.
• Pacing Coach — Analyses rhythm and suggests tightening or breathing room.
• Gap Filler — Automatically finds and inserts relevant B-roll from your library.
• Draft Review — AI watches your edit and provides editorial notes in a panel.

AI Color Grade

Describe the look you want in natural language and AIVE generates a color grade. It analyses each shot for exposure, white balance, and skin tones to produce consistent results across your timeline. You can also match the look of a reference image or film.

AI Audio

AIVE includes on-device audio AI for noise removal, voice isolation, de-breath, and loudness normalisation. No cloud upload required. The audio pipeline processes in real time on Apple Silicon and near-real-time on supported GPUs.

AI Generation

Generate titles, lower thirds, transitions, and background music using AI. Describe what you need in the AI Bar and AIVE creates it on your timeline. All generated assets are editable and non-destructive.

Export Formats

Export Presets

AIVE ships with optimized presets for every major platform. Presets auto-configure resolution, bitrate, frame rate, and metadata. Custom presets can be saved and shared across your team.

• YouTube — 4K HDR, 1080p, Shorts (9:16)
• Instagram — Reels, Stories, Feed Square
• Broadcast — ProRes 422 HQ, IMF package
• Archive — ProRes 4444 XQ, uncompressed audio

Cloud Render Pro

Offload heavy renders to AIVE Cloud. Upload your project, choose a preset, and receive a download link when the render completes. Cloud Render supports up to 8K resolution and multi-format batch export. Typical render times are 3-5x faster than local hardware.

Authentication

All API requests require a Bearer token. Obtain one by exchanging your API key at the token endpoint. Tokens expire after 24 hours.

# Exchange API key for a bearer token
curl -X POST https://api.aive.one/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "aive_sk_live_...",
    "grant_type": "api_key"
  }'

// Response
{
  "access_token": "eyJhbGciOiJFZERTQSIs...",
  "token_type": "Bearer",
  "expires_in": 86400,
  "scope": "projects:read projects:write ai:jobs"
}

Projects API

List projects

const response = await fetch('https://api.aive.one/v1/projects', {
  headers: {
    'Authorization': `Bearer ${token}`,
  },
});

const { projects, pagination } = await response.json();
// projects: [{ id, name, created_at, resolution, fps, duration_ms }]

Create a project

import requests

resp = requests.post(
    "https://api.aive.one/v1/projects",
    headers={"Authorization": f"Bearer {token}"},
    json={
        "name": "Campaign Q3",
        "resolution": "1920x1080",
        "fps": 30,
        "color_space": "rec709",
    },
)
project = resp.json()
# project["id"] = "proj_a1b2c3d4"

AI Jobs API

Submit AI processing jobs (auto-cut, color grade, noise removal, transcription) via the API. Jobs run asynchronously; poll or use webhooks for status updates.

Submit an AI job

const job = await fetch('https://api.aive.one/v1/ai/jobs', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    project_id: 'proj_a1b2c3d4',
    type: 'auto_cut',
    params: {
      remove_silences: true,
      silence_threshold_db: -40,
      min_silence_ms: 500,
      remove_filler_words: true,
    },
  }),
}).then(r => r.json());

// job.id = "job_x7y8z9"
// job.status = "queued"

Poll job status

curl https://api.aive.one/v1/ai/jobs/job_x7y8z9 \
  -H "Authorization: Bearer $TOKEN"

# Response: { "id": "job_x7y8z9", "status": "completed", "result": { ... } }

Available job types

Webhooks

Register webhook endpoints to receive real-time notifications for project events, render completions, and AI job status changes.

Register a webhook

const webhook = await fetch('https://api.aive.one/v1/webhooks', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    url: 'https://yourapp.com/webhooks/aive',
    events: [
      'job.completed',
      'job.failed',
      'render.completed',
      'project.updated',
    ],
    secret: 'whsec_...',
  }),
}).then(r => r.json());

// webhook.id = "wh_m4n5o6"

Verify webhook signatures

import crypto from 'node:crypto';

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected),
  );
}

Keyboard Shortcuts

Essential shortcuts for fast editing. Press Cmd + / in the app to view the full list.

Troubleshooting

Playback is choppy or laggy

Switch to proxy editing mode: View > Playback Quality > Proxy. Ensure proxies have been generated for your media (check the Background Tasks panel). On Mac, verify that Metal acceleration is enabled in Preferences > Playback.

Export fails with "Codec not available"

This usually means the required codec pack is missing. Run aive codecs install --all from the terminal to install all supported codecs. Restart AIVE after installation.

AI features are greyed out

AI features require a Pro subscription and a minimum of 8 GB RAM. Verify your subscription status in Account > Subscription. If using the web editor, ensure you are on a supported browser (Chrome 120+ or Edge 120+).

Cloud Render job stuck in "queued"

During peak hours, jobs may queue for up to 15 minutes. If a job has been queued for over 30 minutes, cancel and resubmit. Contact support@aive.one if the issue persists.

Cannot connect to AIVE Cloud

Ensure your firewall allows outbound HTTPS traffic to *.aive.one on port 443. If behind a corporate proxy, configure proxy settings in Preferences > Network.