Ai Video Generation

Auth: "Authorization: Key $FAL_KEY" (NOT Bearer)

Use --fail-with-body — response is JSON with request_id

echo "Submitting video generation job..." SUBMIT=$(curl --fail-with-body -s
-X POST "https://queue.fal.run/${MODEL}"
-H "Authorization: Key $FAL_KEY"
-H "Content-Type: application/json"
-d "{"prompt": "${PROMPT}", "duration": "${DURATION}", "aspect_ratio": "${ASPECT_RATIO}"}")

if [ $? -ne 0 ]; then echo "ERROR: Failed to submit video generation job." echo "Response: $SUBMIT" echo "Check FAL_KEY in ~/.claude/.env and run /pocket-knife:setup to reconfigure." exit 1 fi

REQUEST_ID=$(echo "$SUBMIT" | python3 -c "import sys,json; print(json.load(sys.stdin)['request_id'])" 2>/dev/null)

if [ -z "$REQUEST_ID" ]; then echo "ERROR: Could not extract request_id from response." echo "Response: $SUBMIT" exit 1 fi

echo "Job submitted. request_id: $REQUEST_ID" echo "Polling for completion (typically 1-3 minutes)..." (end bash)

Step 3 — Poll for completion:

(bash)

Status values: IN_QUEUE, IN_PROGRESS, COMPLETED (all uppercase)

CRITICAL: check for exactly "COMPLETED"; also check for error field

MAX_WAIT=300 (5 min) — videos take 60-120s; polling every 10s to avoid rate limiting

MAX_WAIT=300 ELAPSED=0 POLL_INTERVAL=10

while [ $ELAPSED -lt $MAX_WAIT ]; do sleep $POLL_INTERVAL ELAPSED=$((ELAPSED + POLL_INTERVAL))

STATUS_RESP=$(curl -f -s
"https://queue.fal.run/${MODEL}/requests/${REQUEST_ID}/status"
-H "Authorization: Key $FAL_KEY")

if [ $? -ne 0 ]; then echo "WARNING: Status poll failed. Retrying... (${ELAPSED}/${MAX_WAIT}s)" continue fi

STATUS=$(echo "$STATUS_RESP" | python3 -c "import sys,json; print(json.load(sys.stdin).get('status',''))" 2>/dev/null) HAS_ERROR=$(echo "$STATUS_RESP" | python3 -c "import sys,json; d=json.load(sys.stdin); print('yes' if d.get('error') else 'no')" 2>/dev/null)

if [ "$HAS_ERROR" = "yes" ]; then echo "ERROR: Video generation failed." echo "$STATUS_RESP" exit 1 fi

echo "Status: $STATUS — ${ELAPSED}/${MAX_WAIT}s elapsed"

if [ "$STATUS" = "COMPLETED" ]; then echo "Video generation complete!" break fi done

if [ $ELAPSED -ge $MAX_WAIT ] && [ "$STATUS" != "COMPLETED" ]; then echo "ERROR: Video generation timed out after ${MAX_WAIT} seconds." echo "request_id: $REQUEST_ID — job may still be running" exit 1 fi (end bash)

Step 4 — Fetch result and download video:

(bash)

Get result JSON to extract video URL

RESULT=$(curl --fail-with-body -s
"https://queue.fal.run/${MODEL}/requests/${REQUEST_ID}/response"
-H "Authorization: Key $FAL_KEY")

if [ $? -ne 0 ]; then echo "ERROR: Failed to fetch video result." echo "Response: $RESULT" exit 1 fi

VIDEO_URL=$(echo "$RESULT" | python3 -c "import sys,json; print(json.load(sys.stdin)['video']['url'])" 2>/dev/null)

if [ -z "$VIDEO_URL" ]; then echo "ERROR: Could not extract video URL from result." echo "Result: $RESULT" exit 1 fi

echo "Downloading video from: $VIDEO_URL" curl -f -s "$VIDEO_URL" --output "$OUTPUT_FILE"

if [ $? -ne 0 ] || [ ! -s "$OUTPUT_FILE" ]; then echo "ERROR: Video download failed or file is empty." echo "Video URL was: $VIDEO_URL" rm -f "$OUTPUT_FILE" exit 1 fi

echo "Video saved to: $OUTPUT_FILE" (end bash)

Report to the user:

• The path where the video was saved
• The prompt, duration, and aspect ratio used
• Total time taken
• If any error: missing FAL_KEY run /pocket-knife:setup; timeout with request_id for manual check