Black Forest Labs Flux 3 Image To Video Draft

Black Forest Labs Flux 3 Image To Video Draft

Playground

FLUX 3 Image-to-Video Draft quickly animates a required reference image into a draft clip with prompt-guided motion, optional synchronized audio, and flexible 5-20 second duration for rapid visual iteration.

Features

FLUX 3 Draft Image-to-Video quickly animates a required reference image into a motion preview. Use the image to anchor the subject, character, product, scene, or style, then test different actions and camera directions before creating a final-quality video.

Key Capabilities

• Animate a reference image into a draft video.
• Test subject motion, camera movement, scene atmosphere, and visual continuity quickly.
• Optionally generate synchronized audio for early sound and storytelling tests.
• Choose a duration from 5 to 20 seconds.
• Support landscape, portrait, square, and cinematic aspect ratios.

Parameters

How to Use

1. Provide a clear reference image with the subject or composition you want to animate.
2. Describe the motion, camera path, environment, and style change in the prompt.
3. Choose an aspect ratio and duration for the draft preview.
4. Enable generate_audio when you want to test matching ambience, effects, music, or dialogue.
5. Review the motion and refine the prompt before moving to a final production workflow.

Prompting Tips

• State what must remain consistent from the image and what should change through motion.
• Use specific actions such as turning, walking, rotating, opening, flowing, or drifting.
• Add camera language such as slow push-in, tracking shot, orbit, handheld movement, or fixed frame.
• Start with a simple motion direction, then add more detail after the first draft is stable.

Pricing

Billing Rules

• The billed duration is rounded up to the next whole second.
• The minimum billed duration is 5 seconds.
• The maximum billed duration is 20 seconds.
• Audio generation does not add a separate charge in the current pricing formula.
• Example: a 5-second draft costs $0.30.
• Example: a 10-second draft costs $0.60.

Best Use Cases

• Fast animation tests for portraits, products, and illustrations.
• Character motion and pose exploration.
• Product-video concept development.
• Social content ideation and visual style testing.
• Comparing alternative actions from the same reference image.

Notes

• A reference image and prompt are both required.
• Use a clear image with the subject visible and enough detail for motion planning.
• Draft outputs are intended for exploration and iteration.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
  "aspect_ratio": "21:9",
  "duration": 5,
  "generate_audio": true
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/black-forest-labs/flux-3/image-to-video-draft" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters