Quick Start: First Frame to Video

#!/usr/bin/env bash
set -euo pipefail

response=$(curl -s "https://apis.viggle.ai/v1/videos" \
  -H "Authorization: Bearer $VIGGLE_API_KEY" \
  -F prompt="camera slowly zooms out" \
  -F quality=high \
  -F first_frame_image_url=https://assets.viggle.ai/samples/first-frame.png)
video_id=$(echo "$response" | jq -r '.id')

for _ in $(seq 1 60); do
  video=$(curl -s "https://apis.viggle.ai/v1/videos/$video_id" \
    -H "Authorization: Bearer $VIGGLE_API_KEY")
  status=$(echo "$video" | jq -r '.status')

  case "$status" in
    ready)
      echo "$video" | jq -r '.video_url'
      exit 0
      ;;
    failed|cancelled)
      echo "Video $status: $(echo "$video" | jq -c '.error')" >&2
      exit 1
      ;;
  esac
  sleep 5
done

echo "Timed out waiting for video $video_id" >&2
exit 1

const baseUrl = "https://apis.viggle.ai/v1";
const headers = { Authorization: `Bearer ${process.env.VIGGLE_API_KEY}` };
const TERMINAL = new Set(["ready", "failed", "cancelled"]);

async function createVideo() {
  const form = new FormData();
  form.append("prompt", "camera slowly zooms out");
  form.append("quality", "high");
  form.append("first_frame_image_url", "https://assets.viggle.ai/samples/first-frame.png");

  const response = await fetch(`${baseUrl}/videos`, {
    method: "POST",
    headers,
    body: form,
  });
  if (!response.ok) {
    const body = await response.json().catch(() => ({}));
    throw new Error(`HTTP ${response.status}: ${JSON.stringify(body.error ?? body)}`);
  }
  return response.json();
}

async function waitForVideo(id) {
  for (let attempt = 0; attempt < 60; attempt++) {
    const response = await fetch(`${baseUrl}/videos/${id}`, { headers });
    if (!response.ok) {
      const body = await response.json().catch(() => ({}));
      throw new Error(`HTTP ${response.status}: ${JSON.stringify(body.error ?? body)}`);
    }
    const video = await response.json();
    if (TERMINAL.has(video.status)) return video;
    await new Promise((resolve) => setTimeout(resolve, 5000));
  }
  throw new Error(`Timed out waiting for video ${id}`);
}

const created = await createVideo();
const video = await waitForVideo(created.id);

if (video.status !== "ready") {
  throw new Error(`Video ${video.status}: ${JSON.stringify(video.error)}`);
}
console.log(video.video_url);

import os
import time
import requests

base_url = "https://apis.viggle.ai/v1"
headers = {"Authorization": f"Bearer {os.environ['VIGGLE_API_KEY']}"}
TERMINAL_STATES = {"ready", "failed", "cancelled"}

response = requests.post(
    f"{base_url}/videos",
    headers=headers,
    data={"prompt": "camera slowly zooms out", "quality": "high"},
    files={"first_frame_image_url": (None, "https://assets.viggle.ai/samples/first-frame.png")},
)
response.raise_for_status()
video = response.json()

for _ in range(60):
    if video["status"] in TERMINAL_STATES:
        break
    time.sleep(5)
    response = requests.get(f"{base_url}/videos/{video['id']}", headers=headers)
    response.raise_for_status()
    video = response.json()
else:
    raise TimeoutError(f"Timed out waiting for video {video['id']}")

if video["status"] != "ready":
    error = video.get("error") or {}
    raise RuntimeError(f"{video['status']}: {error.get('code')} {error.get('message')}")

print(video["video_url"])