Quickstart

# Upload source video
curl -X POST https://api.beeble.ai/v1/uploads \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "source.mp4"}'

# Upload alpha mask
curl -X POST https://api.beeble.ai/v1/uploads \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "alpha.mp4"}'

# Upload reference image
curl -X POST https://api.beeble.ai/v1/uploads \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "reference.png"}'

curl -X PUT "${SOURCE_UPLOAD_URL}" \
  -H "Content-Type: video/mp4" \
  --data-binary @source.mp4

curl -X PUT "${ALPHA_UPLOAD_URL}" \
  -H "Content-Type: video/mp4" \
  --data-binary @alpha.mp4

curl -X PUT "${REFERENCE_UPLOAD_URL}" \
  -H "Content-Type: image/png" \
  --data-binary @reference.png

curl -X POST https://api.beeble.ai/v1/switchx/generations \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "generation_type": "video",
    "source_uri": "'"${SOURCE_BEEBLE_URI}"'",
    "reference_image_uri": "'"${REFERENCE_BEEBLE_URI}"'",
    "alpha_uri": "'"${ALPHA_BEEBLE_URI}"'",
    "alpha_mode": "custom",
    "prompt": "Subject: A young female racing driver with long, wavy red hair and light skin. She is wearing a red, black, and white racing suit featuring prominent sponsor logos like Red Bull, Ferrari, and Mercedes-Benz. She stands with her arms crossed, facing the camera with a confident, pleasant smile. Lighting: The lighting in this image is defined by a dramatic, warm golden sunset, emanating from the upper left behind the subject. This powerful backlighting creates a striking rim light that catches the subject'"'"'s vibrant red hair, making it appear almost fiery and glowing around her head. Her face is softly shadowed, with a beautiful, natural gradient from the bright, warm highlights on her left cheekbone, nose, and forehead to the deeper, softer shadows across her right side, emphasizing her features. The light source casts long, warm shadows across the pit lane, highlighting the texture of the asphalt and the metallic surfaces of the race car and equipment in the background, which are also bathed in this warm, golden glow. The overall atmosphere is warm, dramatic, and rich with deep golden and orange tones. Mood: Extremely high-energy, adrenaline-fueled, and intense, capturing the raw speed and danger of professional motorsports. The atmosphere is cinematic and dramatic. Background: The background is a high-speed blur of a Formula 1 race track straight. Multiple F1 cars are visible only as streaks of color and motion, hurtling past at speeds exceeding 400 km/h. The entire background, including the track surface, barriers, and distant grandstands, is heavily motion-blurred horizontally, creating a powerful sense of extreme velocity. Colors: A warm palette dominated by the vibrant red of the subject'"'"'s hair and racing suit, contrasting with the black of the uniform. The lighting adds golden/ivory hues. The overall color grading is cinematic and gritty, like a scene from the movie F1, with rich saturation, high contrast, and a sense of dust and heat. Composition: She is positioned off-center to the right and remains in sharp focus. The perspective and the intense motion blur in the background create a dynamic, high-stakes environment, emphasized by the implied slow shutter speed of 1/60th of a second."
  }'

curl https://api.beeble.ai/v1/switchx/generations/swx_abc123 \
  -H "x-api-key: YOUR_API_KEY"

curl -o render.mp4 "https://cdn.beeble.ai/.../render.mp4"