FLUX 3 Max Keyframes to Video API

set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"

REQUEST_BODY=$(cat <<'JSON'
{
  "model": "blackforestlabs/flux-3-max/keyframes-to-video",
  "input": {
    "prompt": "A paper lantern festival on a quiet river at night, filmed as one smooth drifting shot. Follow the three keyframes in order: a single lantern being lit on the bank, the lantern floating among many others mid-river, then a wide view of hundreds of lanterns passing under a stone bridge. Keep the water calm and the lantern colours warm. Native audio: soft water lapping, faint crowd murmur, wooden boat creak. No text, no logos, no watermark.",
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "auto",
    "sound": true,
    "keyframes": [
      {
        "image_url": "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-3-max/keyframes-to-video/v1/01/input-keyframe-01.webp",
        "frame_index": 0
      },
      {
        "image_url": "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-3-max/keyframes-to-video/v1/01/input-keyframe-02.webp",
        "frame_index": 96
      },
      {
        "image_url": "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-3-max/keyframes-to-video/v1/01/input-keyframe-03.webp",
        "frame_index": 192
      }
    ]
  }
}
JSON
)

SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data "$REQUEST_BODY")

TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
if [ -z "$TASK_ID" ]; then
  printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
  exit 1
fi

while true; do
  STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
    --url "https://api.vidgo.ai/api/generate/status/$TASK_ID" \
    --header "Authorization: Bearer $VIDGO_API_KEY")
  STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')

  case "$STATUS" in
    finished)
      printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
      break
      ;;
    failed)
      printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
      exit 1
      ;;
    not_started|running)
      sleep 2
      ;;
    *)
      printf 'Unexpected task status: %s
' "$STATUS" >&2
      exit 1
      ;;
  esac
done