API quickstart

// Node.js 20+: node quickstart.mjs interview.mp4
import { createWriteStream, openAsBlob } from 'node:fs';
import { stat } from 'node:fs/promises';
import { basename } from 'node:path';
import { randomUUID } from 'node:crypto';
import { Readable } from 'node:stream';
import { pipeline } from 'node:stream/promises';

const API = 'https://api.slicer.media/v1';
const TOKEN = process.env.SLICER_TOKEN;
const file = process.argv[2] ?? 'interview.mp4';
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function api(method, path, body, headers = {}) {
  const response = await fetch(`${API}${path}`, {
    method,
    headers: {
      Authorization: `Bearer ${TOKEN}`,
      ...(body ? { 'Content-Type': 'application/json' } : {}),
      ...headers,
    },
    body: body ? JSON.stringify(body) : undefined,
  });
  const json = await response.json();
  if (!json.ok) throw new Error(`${response.status} ${json.error.code}: ${json.error.message}`);
  return json.data;
}

// 1. Upload: create it and send the file to the one-time link (no token)
const { size } = await stat(file);
const created = await api('POST', '/uploads', { fileName: basename(file), size });
const put = await fetch(created.uploadUrl, { method: 'PUT', body: await openAsBlob(file) });
const putJson = await put.json();
if (!putJson.ok) throw new Error(`Upload: ${putJson.error.message}`);

let upload = putJson.data;
while (upload.status !== 'ready') {
  if (upload.status === 'failed' || upload.status === 'aborted') throw new Error(`File rejected: ${upload.error}`);
  await sleep(2000);
  upload = await api('GET', `/uploads/${upload.id}`);
}

// 2. Price: nothing starts without confirmCost
const request = { uploadIds: [upload.id], title: 'A reel in 3 minutes', settings: { templateId: 'bold' } };
const quote = await api('POST', '/projects', request);
console.log(`Price: ${quote.cost} tokens, available: ${quote.available}`);
if (!quote.enough) throw new Error('Not enough tokens — top up your balance in the Slicer app');

// 3. Start with the confirmed price
let project = await api('POST', '/projects', { ...request, confirmCost: quote.cost }, { 'Idempotency-Key': randomUUID() });

// 4. Wait
while (project.status === 'queued' || project.status === 'processing') {
  console.log(`${project.stage ?? 'queued'}: ${project.progress}%`);
  await sleep(5000);
  project = await api('GET', `/projects/${project.id}`);
}
if (project.status !== 'succeeded') throw new Error(`Montage did not finish: ${project.error?.message ?? project.status}`);

// 5. Stream the download
const output = `reel.${project.result.container}`;
const video = await fetch(project.result.url, { headers: { Authorization: `Bearer ${TOKEN}` } });
if (!video.ok) throw new Error(`Download: ${video.status}`);
await pipeline(Readable.fromWeb(video.body), createWriteStream(output));
console.log(`Done: ${output}. Project in the app: ${project.appUrl}`);

# Python 3.9+: pip install requests && python quickstart.py interview.mp4
import os
import sys
import time
import uuid

import requests

API = "https://api.slicer.media/v1"
session = requests.Session()
session.headers["Authorization"] = f"Bearer {os.environ['SLICER_TOKEN']}"


def api(method, path, json=None, headers=None):
    response = session.request(method, API + path, json=json, headers=headers, timeout=60)
    body = response.json()
    if not body["ok"]:
        error = body["error"]
        raise RuntimeError(f"{response.status_code} {error['code']}: {error['message']}")
    return body["data"]


path = sys.argv[1] if len(sys.argv) > 1 else "interview.mp4"

# 1. Upload: create it and send the file to the one-time link (no token)
created = api("POST", "/uploads", {"fileName": os.path.basename(path), "size": os.path.getsize(path)})
with open(path, "rb") as file:
    put = requests.put(created["uploadUrl"], data=file, timeout=3600)
put_body = put.json()
if not put_body["ok"]:
    raise RuntimeError(f"Upload: {put_body['error']['message']}")

upload = put_body["data"]
while upload["status"] != "ready":
    if upload["status"] in ("failed", "aborted"):
        raise RuntimeError(f"File rejected: {upload['error']}")
    time.sleep(2)
    upload = api("GET", f"/uploads/{upload['id']}")

# 2. Price: nothing starts without confirmCost
request = {"uploadIds": [upload["id"]], "title": "A reel in 3 minutes", "settings": {"templateId": "bold"}}
quote = api("POST", "/projects", request)
print(f"Price: {quote['cost']} tokens, available: {quote['available']}")
if not quote["enough"]:
    raise RuntimeError("Not enough tokens — top up your balance in the Slicer app")

# 3. Start with the confirmed price
project = api(
    "POST",
    "/projects",
    {**request, "confirmCost": quote["cost"]},
    headers={"Idempotency-Key": str(uuid.uuid4())},
)

# 4. Wait
while project["status"] in ("queued", "processing"):
    print(f"{project['stage'] or 'queued'}: {project['progress']}%")
    time.sleep(5)
    project = api("GET", f"/projects/{project['id']}")
if project["status"] != "succeeded":
    raise RuntimeError(f"Montage did not finish: {(project['error'] or {}).get('message', project['status'])}")

# 5. Stream the download
output = f"reel.{project['result']['container']}"
with session.get(project["result"]["url"], stream=True, timeout=600) as video:
    video.raise_for_status()
    with open(output, "wb") as out:
        for chunk in video.iter_content(chunk_size=1 << 20):
            out.write(chunk)
print(f"Done: {output}. Project in the app: {project['appUrl']}")