Video Generation

curl -X POST https://api.imgix.com/api/v1/generations/video \
  -H "Authorization: Bearer $IMGIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-domain.imgix.net/image.jpg",
    "model": "auto"
  }'

{
  "data": {
    "type": "job",
    "id": "66523ecdc9e5a19840c20941",
    "attributes": {
      "status": "started",
      "created_at": 1792783178
    }
  }
}

curl https://api.imgix.com/api/v1/generations/video/66523ecdc9e5a19840c20941 \
  -H "Authorization: Bearer $IMGIX_API_KEY"

{
  "data": {
    "type": "job",
    "id": "66523ecdc9e5a19840c20941",
    "attributes": {
      "status": "ready",
      "created_at": 1792783178,
      "updated_at": 1792783410,
      "result": {
        "url": "https://your-domain.imgix.net/image.jpg?itv=ef22b73a53&variant=542db280"
      }
    }
  }
}

// Node.js 18 or later. Run: IMGIX_API_KEY=... node generate.mjs
const API = "https://api.imgix.com/api/v1/generations/video";
const headers = {
  Authorization: `Bearer ${process.env.IMGIX_API_KEY}`,
  "Content-Type": "application/json",
};
 
async function generateVideo(request) {
  const created = await fetch(API, {
    method: "POST",
    headers,
    body: JSON.stringify(request),
  });
  if (!created.ok) {
    throw new Error(`${created.status}: ${await created.text()}`);
  }
  const { id } = (await created.json()).data;
 
  const deadline = Date.now() + 20 * 60 * 1000;
  while (Date.now() < deadline) {
    await new Promise((resolve) => setTimeout(resolve, 5000));
    const job = await fetch(`${API}/${id}`, { headers });
    const { status, result, error } = (await job.json()).data.attributes;
    if (status === "ready") return result.url;
    if (status === "errored") throw new Error(error.message);
  }
  throw new Error(`job ${id} did not finish within 20 minutes`);
}
 
const videoUrl = await generateVideo({
  url: "https://your-domain.imgix.net/image.jpg",
  model: "auto",
});
console.log(videoUrl);

# Python 3.8 or later with requests. Run: IMGIX_API_KEY=... python3 generate.py
import os
import time
 
import requests
 
API = "https://api.imgix.com/api/v1/generations/video"
HEADERS = {"Authorization": f"Bearer {os.environ['IMGIX_API_KEY']}"}
 
 
def generate_video(request):
    created = requests.post(API, headers=HEADERS, json=request)
    if not created.ok:
        raise RuntimeError(f"{created.status_code}: {created.text}")
    job_id = created.json()["data"]["id"]
 
    deadline = time.time() + 20 * 60
    while time.time() < deadline:
        time.sleep(5)
        attrs = requests.get(f"{API}/{job_id}", headers=HEADERS).json()["data"]["attributes"]
        if attrs["status"] == "ready":
            return attrs["result"]["url"]
        if attrs["status"] == "errored":
            raise RuntimeError(attrs["error"]["message"])
    raise TimeoutError(f"job {job_id} did not finish within 20 minutes")
 
 
print(generate_video({
    "url": "https://your-domain.imgix.net/image.jpg",
    "model": "auto",
}))