curl -X POST https://renderio.dev/api/v1/ytdlp-download \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: ffsk_your_api_key_here" \
  -d '{
    "input_urls": {
      "in_video": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
    },
    "format_selector": "720p",
    "metadata": {
      "source": "youtube",
      "project": "archive"
    }
  }'

import os, time, requests

API_KEY = os.environ["RENDERIO_API_KEY"]
BASE = "https://renderio.dev"

# Submit download
res = requests.post(
    f"{BASE}/api/v1/ytdlp-download",
    headers={"X-API-KEY": API_KEY, "Content-Type": "application/json"},
    json={
        "input_urls": {"in_video": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"},
        "metadata": {"source": "youtube"},
    },
)
res.raise_for_status()
command_id = res.json()["command_id"]

# Poll until done
while True:
    time.sleep(2)
    result = requests.get(
        f"{BASE}/api/v1/commands/{command_id}",
        headers={"X-API-KEY": API_KEY},
    ).json()
    if result["status"] == "SUCCESS":
        # input key in_video → output key out_video
        output = result["output_files"]["out_video"]
        location = (
            output.get("storage_url")
            or output.get("external_uri")
            or output.get("external_object_key")
        )
        print(location)
        break
    if result["status"] == "FAILED":
        raise RuntimeError(result.get("error_message"))

const API_KEY = process.env.RENDERIO_API_KEY!;
const BASE = "https://renderio.dev";

interface CommandResult {
  command_id: string;
  status: "QUEUED" | "PROCESSING" | "SUCCESS" | "FAILED";
  output_files: Record<string, {
    storage_url: string | null;
    storage_location?: "INTERNAL" | "EXTERNAL";
    external_uri?: string;
    external_object_key?: string;
    status: string;
  }>;
  error_message?: string;
}

async function downloadVideo(url: string): Promise<string> {
  const submitRes = await fetch(`${BASE}/api/v1/ytdlp-download`, {
    method: "POST",
    headers: { "X-API-KEY": API_KEY, "Content-Type": "application/json" },
    body: JSON.stringify({ input_urls: { in_video: url } }),
  });

  if (!submitRes.ok) throw new Error(`Submit failed: ${await submitRes.text()}`);
  const { command_id } = await submitRes.json();

  while (true) {
    await new Promise((r) => setTimeout(r, 2000));
    const pollRes = await fetch(`${BASE}/api/v1/commands/${command_id}`, {
      headers: { "X-API-KEY": API_KEY },
    });
    const result: CommandResult = await pollRes.json();
    // input key in_video → output key out_video
    if (result.status === "SUCCESS") {
      const output = result.output_files.out_video;
      const location = output.storage_url ?? output.external_uri ?? output.external_object_key;
      if (!location) throw new Error("Completed output has no storage location");
      return location;
    }
    if (result.status === "FAILED") throw new Error(result.error_message);
  }
}

const location = await downloadVideo("https://www.youtube.com/watch?v=dQw4w9WgXcQ");
console.log("Output:", location);

const API_KEY = process.env.RENDERIO_API_KEY;
const BASE = "https://renderio.dev";

async function downloadVideo(url) {
  const submitRes = await fetch(`${BASE}/api/v1/ytdlp-download`, {
    method: "POST",
    headers: { "X-API-KEY": API_KEY, "Content-Type": "application/json" },
    body: JSON.stringify({ input_urls: { in_video: url } }),
  });

  const { command_id } = await submitRes.json();

  while (true) {
    await new Promise((r) => setTimeout(r, 2000));
    const result = await fetch(`${BASE}/api/v1/commands/${command_id}`, {
      headers: { "X-API-KEY": API_KEY },
    }).then((r) => r.json());

    // input key in_video → output key out_video
    if (result.status === "SUCCESS") {
      const output = result.output_files.out_video;
      const location = output.storage_url ?? output.external_uri ?? output.external_object_key;
      if (!location) throw new Error("Completed output has no storage location");
      return location;
    }
    if (result.status === "FAILED") throw new Error(result.error_message);
  }
}

const location = await downloadVideo("https://www.tiktok.com/@username/video/7123456789");
console.log("Output:", location);