Quickstart

const API_KEY = process.env.HOOKED_API_KEY;
const BASE_URL = "https://api.hooked.so/v1";
const headers = { "x-api-key": API_KEY, "Content-Type": "application/json" };

async function api(path, options = {}) {
  const res = await fetch(`${BASE_URL}${path}`, { headers, ...options });
  const body = await res.json();
  if (!res.ok) throw new Error(`${res.status}: ${body.message}`);
  return body;
}

const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

async function main() {
  // 1. Pick an avatar
  const { data: avatars } = await api("/avatar/list?type=library&limit=10");
  const avatar = avatars.avatars[0];

  // 2. Create the project
  const created = await api("/project/create/talking-avatar", {
    method: "POST",
    body: JSON.stringify({
      avatarId: avatar.id,
      script: "Hey! I tried this app for a week and it completely changed how I plan my day.",
    }),
  });
  const projectId = created.data.projectId;
  console.log("Project:", projectId);

  // 3. Poll until the video is ready or something failed
  while (true) {
    await sleep(15000);
    const { data: project } = await api(`/project/${projectId}`);
    const video = project.video;
    console.log(project.status, project.progress, project.message);

    if (project.status === "failed" || video?.status === "FAILED") {
      throw new Error(`Failed: ${video?.message ?? project.message}`);
    }
    if (video?.status === "COMPLETED") {
      // 4. Download
      const file = await fetch(video.url);
      const { writeFile } = await import("node:fs/promises");
      await writeFile("video.mp4", Buffer.from(await file.arrayBuffer()));
      console.log("Saved video.mp4");
      return;
    }
  }
}

main().catch((error) => {
  console.error(error.message);
  process.exit(1);
});

import os
import time
import requests

API_KEY = os.environ["HOOKED_API_KEY"]
BASE_URL = "https://api.hooked.so/v1"
HEADERS = {"x-api-key": API_KEY, "Content-Type": "application/json"}


def api(method, path, **kwargs):
    res = requests.request(method, f"{BASE_URL}{path}", headers=HEADERS, timeout=60, **kwargs)
    body = res.json()
    if not res.ok:
        raise RuntimeError(f"{res.status_code}: {body.get('message')}")
    return body


# 1. Pick an avatar
avatar = api("GET", "/avatar/list?type=library&limit=10")["data"]["avatars"][0]

# 2. Create the project
created = api("POST", "/project/create/talking-avatar", json={
    "avatarId": avatar["id"],
    "script": "Hey! I tried this app for a week and it completely changed how I plan my day.",
})
project_id = created["data"]["projectId"]
print("Project:", project_id)

# 3. Poll until the video is ready or something failed
while True:
    time.sleep(15)
    project = api("GET", f"/project/{project_id}")["data"]
    video = project["video"]
    print(project["status"], project["progress"], project["message"])

    if project["status"] == "failed" or (video and video["status"] == "FAILED"):
        raise RuntimeError(f"Failed: {(video or project)['message']}")
    if video and video["status"] == "COMPLETED":
        # 4. Download
        with requests.get(video["url"], stream=True, timeout=300) as file:
            file.raise_for_status()
            with open("video.mp4", "wb") as out:
                for chunk in file.iter_content(chunk_size=1 << 20):
                    out.write(chunk)
        print("Saved video.mp4")
        break