FLUX 3 Max Image 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/image-to-video",
  "input": {
    "prompt": "Start on the closed ceramic teapot from the first image. Steam begins to curl from the spout, the lid lifts slightly and settles, and the camera pushes in slowly until it holds on the poured cup shown in the second image. Warm kitchen window light throughout, shallow depth of field. Native audio: quiet kettle hiss, a soft clink of porcelain, distant birdsong. No text, no logos, no watermark.",
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-3-max/image-to-video/v1/01/input-start-frame.webp",
      "https://cdn.vidgo.ai/apis/models/blackforestlabs/flux-3-max/image-to-video/v1/01/input-end-frame.webp"
    ],
    "duration": 6,
    "resolution": "720p",
    "aspect_ratio": "auto",
    "sound": true
  }
}
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