Black Forest Labs Flux 3 Text To Video Draft

Black Forest Labs Flux 3 Text To Video Draft

Playground

FLUX 3 Text-to-Video Draft generates short draft videos from text prompts with coherent motion, prompt-guided camera direction, optional synchronized audio, and pricing optimized for rapid iteration.

Features

FLUX 3 Draft Text-to-Video turns a written prompt into a quick video preview with coherent motion and prompt-guided scene composition. It is designed for rapid ideation, storyboarding, prompt iteration, and testing creative directions before producing a final-quality clip.

Key Capabilities

• Generate draft videos directly from text prompts.
• Explore subject behavior, scene structure, camera movement, lighting, pacing, and visual style quickly.
• Optionally generate synchronized audio for early sound and storytelling tests.
• Choose a duration from 5 to 20 seconds.
• Use landscape, portrait, square, or cinematic aspect ratios for different concepts.

Parameters

How to Use

1. Write a concise prompt describing the main subject, action, setting, and camera direction.
2. Select an aspect ratio that matches the intended format.
3. Set a duration from 5 to 20 seconds.
4. Enable generate_audio when you want to test ambience, sound effects, music, or dialogue.
5. Generate several variations, compare the motion and composition, then refine the prompt for production use.

Prompting Tips

• Start with one clear action so the draft has a focused motion target.
• Add camera instructions such as tracking shot, dolly-in, orbit, zoom, tilt, or locked-off frame.
• Use short timing cues when the scene has multiple beats.
• Treat the draft as a visual test: refine subject identity, action, pacing, and framing before adding secondary details.

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

• Rapid prompt and motion experimentation.
• Storyboards and pre-visualization.
• Social video concept testing.
• Early advertising and product-video drafts.
• Comparing multiple camera or pacing directions.

Notes

• This draft model generates video from text prompts and does not require an input image.
• Draft outputs are intended for exploration and iteration.
• Generated audio may vary with the prompt and visual action.

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",
  "aspect_ratio": "16: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/text-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