Render API guide

function watchRender(sseUrl) {
  return new Promise((resolve, reject) => {
    const events = new EventSource(sseUrl);
    events.onmessage = (event) => {
      const job = JSON.parse(event.data);
      console.log(job.status, job.progress);

      if (job.status === "done") { events.close(); resolve(job.output); }
      if (job.status === "failed" || job.status === "not_found") { events.close(); reject(new Error(job.error)); }
    };
  });
}

await fetch(urls.executionUrl);                 // 1. start (or re-attach to) the job
const output = await watchRender(urls.sseStatusUrl);   // 2. wait for it to finish
console.log(output.url, output.sizeText);

import json, requests

def watch_render(sse_url):
    with requests.get(sse_url, stream=True, timeout=900) as stream:
        for line in stream.iter_lines(decode_unicode=True):
            if not line or not line.startswith("data:"):
                continue
            job = json.loads(line[5:])
            print(job["status"], job.get("progress"))
            if job["status"] == "done":
                return job["output"]
            if job["status"] in ("failed", "not_found"):
                raise RuntimeError(job.get("error"))

requests.get(urls["executionUrl"], timeout=60)    # 1. start (or re-attach to) the job
output = watch_render(urls["sseStatusUrl"])        # 2. wait for it to finish
print(output["url"], output["sizeText"])

<?php
function watchRender(string $sseUrl): array
{
    $buffer = "";
    $final = null;

    $ch = curl_init($sseUrl);
    curl_setopt_array($ch, [
        CURLOPT_HTTPHEADER => ["Accept: text/event-stream"],
        CURLOPT_TIMEOUT => 900,
        CURLOPT_WRITEFUNCTION => function ($ch, string $chunk) use (&$buffer, &$final) {
            $buffer .= $chunk;
            while (($pos = strpos($buffer, "\n\n")) !== false) {
                $event = substr($buffer, 0, $pos);
                $buffer = substr($buffer, $pos + 2);

                foreach (explode("\n", $event) as $line) {
                    if (!str_starts_with($line, "data:")) {
                        continue;
                    }
                    $job = json_decode(trim(substr($line, 5)), true);
                    echo $job["status"], " ", $job["progress"] ?? "", PHP_EOL;

                    if (in_array($job["status"], ["done", "failed", "not_found"], true)) {
                        $final = $job;
                        return 0; // stop reading, the job has finished
                    }
                }
            }
            return strlen($chunk);
        },
    ]);
    curl_exec($ch);

    if ($final === null) {
        throw new RuntimeException("Status stream ended unexpectedly");
    }
    if ($final["status"] !== "done") {
        throw new RuntimeException($final["error"] ?? "Render failed");
    }
    return $final["output"];
}

file_get_contents($urls["executionUrl"]);             // 1. start (or re-attach to) the job
$output = watchRender($urls["sseStatusUrl"]);         // 2. wait for it to finish
echo $output["url"], " ", $output["sizeText"], PHP_EOL;

# 1. Start (or re-attach to) the job
curl "$EXECUTION_URL"

# 2. Follow progress as Server-Sent Events
curl -N "$SSE_STATUS_URL"

const res = await fetch("https://api-host/api/v1/render/execute", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_RENDER_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    id: `merge-${crypto.randomUUID()}`,
    inputs: [
      { url: "https://cdn.example.com/video-only.mp4", ext: "mp4" },
      { url: "https://cdn.example.com/audio-only.m4a", ext: "m4a" },
    ],
    output: { ext: "mp4", downloadName: "My video (1080p).mp4" },
    operation: { type: "join_streams" },
    ttl: 3600000,
  }),
});
const job = await res.json();   // { jobId, status, message, statusUrl, sseStatusUrl }; 202 = new, 200 = existing
console.log(job);

import uuid, requests

res = requests.post(
    "https://api-host/api/v1/render/execute",
    headers={"Authorization": "Bearer YOUR_RENDER_KEY"},
    json={
        "id": f"merge-{uuid.uuid4()}",
        "inputs": [
            {"url": "https://cdn.example.com/video-only.mp4", "ext": "mp4"},
            {"url": "https://cdn.example.com/audio-only.m4a", "ext": "m4a"},
        ],
        "output": {"ext": "mp4", "downloadName": "My video (1080p).mp4"},
        "operation": {"type": "join_streams"},
        "ttl": 3600000,
    },
    timeout=60,
)
job = res.json()
print(job)

<?php
$body = [
    "id" => "merge-" . bin2hex(random_bytes(16)),
    "inputs" => [
        ["url" => "https://cdn.example.com/video-only.mp4", "ext" => "mp4"],
        ["url" => "https://cdn.example.com/audio-only.m4a", "ext" => "m4a"],
    ],
    "output" => ["ext" => "mp4", "downloadName" => "My video (1080p).mp4"],
    "operation" => ["type" => "join_streams"],
    "ttl" => 3600000,
];

$ch = curl_init("https://api-host/api/v1/render/execute");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode($body),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_RENDER_KEY",
        "Content-Type: application/json",
    ],
]);
$job = json_decode(curl_exec($ch), true);
print_r($job);

curl -X POST "https://api-host/api/v1/render/execute" \
  -H "Authorization: Bearer YOUR_RENDER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "merge-3f6c2a1e-5b8d-4c1f-9e2a-7d4b6c8e0f12",
    "inputs": [
      { "url": "https://cdn.example.com/video-only.mp4", "ext": "mp4" },
      { "url": "https://cdn.example.com/audio-only.m4a", "ext": "m4a" }
    ],
    "output": { "ext": "mp4", "downloadName": "My video (1080p).mp4" },
    "operation": { "type": "join_streams" },
    "ttl": 3600000
  }'