Video REST API

POST /v1/generations/video
 
{
  "url": "https://assets-secured.imgix.net/docs/examples/building-01.jpg",
  "prompt": "walking towards building POV",
  "model": "veo3",
  "duration": 8
}

{
  "data": {
    "type": "job",
    "id": "3f98a9b2c4d5e6f7a8b9c0d1",
    "attributes": {
      "status": "started",
      "created_at": 1760074634
    }
  }
}

{
  "data": {
    "type": "job",
    "id": "3f98a9b2c4d5e6f7a8b9c0d1",
    "attributes": {
      "status": "preparing",
      "created_at": 1760074634
    }
  }
}

{
  "data": {
    "type": "job",
    "id": "3f98a9b2c4d5e6f7a8b9c0d1",
    "attributes": {
      "status": "ready",
      "created_at": 1760074634,
      "updated_at": 1760074710,
      "result": {
        "url": "https://assets-secured.imgix.net/docs/examples/building-01.jpg?motion=walking%20towards%20building%20POV&motion-model=veo3&s=42a5973f0c47b2fbb9fcdd5bb8c194ed"
      }
    }
  }
}

{
  "data": {
    "type": "job",
    "id": "3f98a9b2c4d5e6f7a8b9c0d1",
    "attributes": {
      "status": "errored",
      "created_at": 1760074634,
      "updated_at": 1760074710,
      "error": {
        "code": 500,
        "message": "Processing failed"
      }
    }
  }
}

async function pollJobStatus(jobId) {
  const maxAttempts = 60;
  const pollInterval = 5000; // 5 seconds
  for (let i = 0; i < maxAttempts; i++) {
    const response = await fetch(
      `https://api.imgix.com/v1/generations/video/${jobId}`,
      {
        headers: {
          Authorization: "Bearer YOUR_API_KEY",
        },
      },
    );
    const data = await response.json();
    const status = data.data.attributes.status;
    if (status === "ready") {
      return data.data.attributes.result.url;
    } else if (status === "errored") {
      throw new Error(data.data.attributes.error.message);
    }
    // Wait before next poll
    await new Promise((resolve) => setTimeout(resolve, pollInterval));
  }
  throw new Error("Job timed out");
}

# 1. Create job
curl -X POST https://api.imgix.com/v1/generations/video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-domain.imgix.net/image.jpg",
    "prompt": "A gentle zoom in with subtle camera movement",
    "model": "veo2",
    "duration": 5
  }'
# Response:
# {
#   "data": {
#     "type": "job",
#     "id": "3f98a9b2c4d5e6f7a8b9c0d1",
#     "attributes": {
#       "status": "started",
#       "created_at": 1760074634
#     }
#   }
# }
# 2. Check status (repeat until status is "ready" or "errored")
curl -X GET https://api.imgix.com/v1/generations/video/3f98a9b2c4d5e6f7a8b9c0d1 \
  -H "Authorization: Bearer YOUR_API_KEY"
# Response when ready:
# {
#   "data": {
#     "type": "job",
#     "id": "3f98a9b2c4d5e6f7a8b9c0d1",
#     "attributes": {
#       "status": "ready",
#       "created_at": 1760074634,
#       "updated_at": 1760074710,
#       "result": {
#         "url": "https://your-domain.imgix.net/image.jpg?itv=b3de39caf7&variant=189b0525"
#       }
#     }
#   }
# }

// To run:
// $ node demo.js
// Ensure to export your API into your environment
const IMGIX_API_KEY = process.env.IMGIX_API_KEY;
if (!IMGIX_API_KEY) {
  throw new Error(`
An Imgix API Key is required, export it or
use dotenv to load it from an .env file
`);
}
 
async function main() {
  // Initial POST request to start video generation
  const resp = await fetch(
    "https://api.imgix.com/v1/generations/video",
    {
      method: "POST",
      headers: {
        Authorization: `Bearer ${IMGIX_API_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        url: "https://ptd.imgix.net/rehearsal.jpg",
        prompt: "rock band practice",
        model: "klingai",
        duration: 7,
      }),
    },
  );
 
  if (resp.status === 401 || resp.status === 403) {
    throw new Error(
      "You do not have permission, ensure source capability is enabled.",
    );
  }
 
  const data = await resp.json();
  console.log(`response: ${resp.status} ${resp.statusText} data:`);
  console.dir(data, { depth: null, colors: true });
 
  // Poll for the result using the API
  const job_id = data.data.id;
  console.log(`job_id: ${job_id}`);
 
  while (true) {
    const status_resp = await fetch(
      `https://api.imgix.com/v1/generations/video/${job_id}`,
      {
        headers: {
          Authorization: `Bearer ${IMGIX_API_KEY}`,
        },
      },
    );
 
    const status_data = await status_resp.json();
    console.log("checking job status...");
    console.dir(status_data, { depth: null, colors: true });
 
    if (status_data.data.attributes.status === "ready") {
      console.log("DONE");
      break;
    }
 
    // Wait 15 seconds before checking again
    await new Promise((resolve) => setTimeout(resolve, 15000));
  }
}
 
main().catch((error) => {
  console.error("Error:", error.message);
  process.exit(1);
});

# To run
# $ python3 demo.py
import os
import time
import requests
 
# Ensure to export your API into your environment
IMGIX_API_KEY = os.environ.get("IMGIX_API_KEY")
if not IMGIX_API_KEY:
    raise ValueError(
r"""
An Imgix API Key is required, export it or
use dotenv to load it from an .env file
""")
 
resp = requests.post(
    url="https://api.imgix.com/v1/generations/video",
    headers={"Authorization": f"Bearer {IMGIX_API_KEY}"},
    json={
      "url": "https://ptd.imgix.net/rehearsal.jpg",
      "prompt": "rock band practice",
      "model": "veo3" # "veo2", "klingai"
   },
)
 
if resp.status_code in [401, 403]:
    raise ValueError(
        "You do not have permission, ensure source capability is enabled."
    )
 
data = resp.json()
print(f"response: {resp} data: {data}")
 
## Poll for the result using the API
job_id = data.get("data").get("id")
while True:
    status_resp = requests.get(
        url=f"https://api.imgix.com/v1/generations/video/{job_id}",
        headers={"Authorization": f"Bearer {IMGIX_API_KEY}"},
    )
 
    status_data = status_resp.json()
    print(f"checking job status... {status_data}")
    if status_data.get("data").get("attributes").get("status") == "ready":
        print("DONE")
        break
    time.sleep(15)