Quickstart

import { readFile, stat, writeFile } from 'node:fs/promises';
import { basename } from 'node:path';
import { execFileSync } from 'node:child_process';

const API = 'https://app.subtitle.ai/api/v1';
const auth = { Authorization: `Bearer ${process.env.SUBTITLE_AI_KEY}` };
const file = process.argv[2];

async function call(path, options = {}) {
  const response = await fetch(`${API}${path}`, { ...options, headers: { ...auth, ...options.headers } });
  if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
  return response;
}

const { size } = await stat(file);
const durationSeconds = Number(
  execFileSync('ffprobe', ['-v', 'error', '-show_entries', 'format=duration', '-of', 'csv=p=0', file]),
);

// 1. Create the job.
const job = await (
  await call('/jobs', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      filename: basename(file),
      contentType: 'audio/wav', // match your file: audio/mpeg, audio/mp4, video/mp4 ...
      sizeBytes: size,
      durationSeconds,
    }),
  })
).json();

// 2. Upload the media. fetch sets Content-Length from the body.
const put = await fetch(job.upload.url, {
  method: 'PUT',
  headers: { 'Content-Type': job.upload.headers['Content-Type'] },
  body: await readFile(file),
});
if (!put.ok) throw new Error(`Upload failed: ${put.status}`);

// 3. Wait until it is ready.
let status;
do {
  await new Promise((resolve) => setTimeout(resolve, 15_000));
  status = await (await call(`/jobs/${job.id}`)).json();
  console.log(status.status);
} while (!['ready', 'failed'].includes(status.status));
if (status.status === 'failed') throw new Error(status.error);

// 4. Download the subtitles.
const srt = await (await call(`/jobs/${job.id}/subtitles?format=srt`)).text();
await writeFile('subtitles.srt', srt);
console.log(`Saved subtitles.srt. Review it at ${job.editorUrl}`);

import os
import subprocess
import sys
import time

import requests

API = "https://app.subtitle.ai/api/v1"
AUTH = {"Authorization": f"Bearer {os.environ['SUBTITLE_AI_KEY']}"}
path = sys.argv[1]

size = os.path.getsize(path)
duration = float(
    subprocess.check_output(
        ["ffprobe", "-v", "error", "-show_entries", "format=duration", "-of", "csv=p=0", path]
    )
)

# 1. Create the job.
response = requests.post(
    f"{API}/jobs",
    headers=AUTH,
    json={
        "filename": os.path.basename(path),
        "contentType": "audio/wav",  # match your file: audio/mpeg, audio/mp4, video/mp4 ...
        "sizeBytes": size,
        "durationSeconds": duration,
    },
)
response.raise_for_status()
job = response.json()

# 2. Upload the media. requests sets Content-Length from the body.
with open(path, "rb") as media:
    put = requests.put(
        job["upload"]["url"],
        headers={"Content-Type": job["upload"]["headers"]["Content-Type"]},
        data=media,
    )
put.raise_for_status()

# 3. Wait until it is ready.
while True:
    time.sleep(15)
    status = requests.get(f"{API}/jobs/{job['id']}", headers=AUTH).json()
    print(status["status"])
    if status["status"] in ("ready", "failed"):
        break
if status["status"] == "failed":
    raise SystemExit(status["error"])

# 4. Download the subtitles.
srt = requests.get(f"{API}/jobs/{job['id']}/subtitles", params={"format": "srt"}, headers=AUTH)
srt.raise_for_status()
with open("subtitles.srt", "wb") as out:
    out.write(srt.content)
print(f"Saved subtitles.srt. Review it at {job['editorUrl']}")