FLUX 3 Video API: Python Wrapper for Black Forest Labs' Text-to-Video & Image-to-Video

A focused Python wrapper for the FLUX 3 video API — Black Forest Labs' unified multimodal frontier model, delivered via muapi.ai. Generate cinematic video clips with native synchronized audio from a text prompt (Text-to-Video) or from a static image (Image-to-Video), using the same architecture that jointly produces image, video, and audio.

🌌 FLUX 3 was announced by Black Forest Labs on July 23, 2026 as a unified multimodal frontier model — one architecture generates image, video, and native synchronized audio, and extends to action-prediction for robotics. MuAPI activates each FLUX 3 endpoint automatically for existing API keys as Black Forest Labs opens general availability — no separate waitlist required.

📺 FLUX 3 API: Image & Video Generation from One Multimodal Model →

Related Projects

• MiniMax-H3-API — Python SDK for MiniMax H3 text-to-video, image-to-video, and first/last-frame video generation.
• Flux-3-Dev-API — Python SDK covering the full FLUX 3 family, including image endpoints
• awesome-flux-3-api-prompts — Curated FLUX 3 API guide, prompts, parameters, and examples
• flux-3-video-edit — Python SDK for FLUX 3's instruction-driven video editing mode (coming soon)
• flux-3-video-upscaler — Python SDK for upscaling FLUX 3 (or any) video output beyond its native resolution (coming soon)
• flux-3-omni — Python SDK for FLUX 3's multi-reference Omni Reference mode (coming soon)
• Seedance-2.5-API — Python wrapper for ByteDance's Seedance 2.5 video model
• veo4-video-generator — Ready-made video generator built on Google's Veo 4
• Generative-Media-Skills — Skills runtime for generative media API prompts
• muapi-cli — CLI for running MuAPI generation tasks, including FLUX 3

🚀 Why Use the FLUX 3 Video API?

FLUX 3 is Black Forest Labs' unified multimodal frontier model — the same weights that generate images also generate video and native synchronized audio in a single request.

• Native Synchronized Audio: generate_audio produces dialogue, sound effects, and music matched to the visuals — no separate audio pipeline required.
• Text-to-Video & Image-to-Video: Generate a clip from a prompt alone, or animate an existing still image with physically consistent motion.
• Unified Model Architecture: Same frontier model family as FLUX 3's image endpoints — consistent visual style across image and video outputs.
• Developer-First: Simple Python SDK backed by MuAPI's infrastructure — one API key, five FLUX 3 endpoints (image and video).

🌟 Key Features

• ✅ FLUX 3 Text-to-Video: Transform a text prompt into a cinematic video clip, 4–10 seconds long.
• ✅ FLUX 3 Image-to-Video: Animate a static image into a video clip using images_list, with motion physically consistent with the source frame.
• ✅ Native Audio Generation: generate_audio=True produces synchronized voice, sfx, and music from the same generation call.
• ✅ Flexible Resolutions: 480p, 720p, or 1080p output.
• ✅ Flexible Aspect Ratios: 16:9, 9:16 (TikTok/Reels/Shorts), 1:1, 4:3, 3:4.
• ✅ File Upload: Upload local images directly via upload_file for use as Image-to-Video start frames.

---

🛠 Installation

Via Pip (Recommended)

pip install flux-3-video-api

From Source

# Clone the FLUX 3 Video API repository
git clone https://github.com/SamurAIGPT/flux-3-video-api.git
cd flux-3-video-api

# Install required dependencies
pip install -r requirements.txt

Configuration

Create a .env file in the root directory and add your MuAPI API key:

MUAPI_API_KEY=your_muapi_api_key_here

---

🤖 FLUX 3 Video MCP Server

You can use FLUX 3 video generation as an MCP (Model Context Protocol) server, so AI models (like Claude Desktop or Cursor) can directly invoke the tools.

Running the MCP Server

1. Ensure MUAPI_API_KEY is set in your environment.
2. Run the server:

   python3 mcp_server.py

3. To test with the MCP Inspector:

   npx -y @modelcontextprotocol/inspector python3 mcp_server.py

---

💻 Quick Start (Python)

from flux3_video_api import Flux3VideoAPI

# Initialize the FLUX 3 Video client
api = Flux3VideoAPI()

# 1. Generate Video from Text (Text-to-Video)
print("Generating AI video using FLUX 3...")
submission = api.text_to_video(
    prompt="A cinematic slow-motion shot of a cyberpunk city in the rain, neon lights reflecting on puddles",
    aspect_ratio="16:9",
    resolution="720p",
    duration=5,
    generate_audio=True,
)

# 2. Wait for completion
result = api.wait_for_completion(submission["request_id"])
print(f"Success! View your FLUX 3 video here: {result.get('outputs', [result.get('url')])}")

# 3. Animate a static image (Image-to-Video)
submission = api.image_to_video(
    prompt="The clouds drift slowly and the water ripples",
    images_list=["https://example.com/landscape.jpg"],
    aspect_ratio="16:9",
    resolution="720p",
    duration=5,
)
result = api.wait_for_completion(submission["request_id"])
print(result.get("outputs", [result.get("url")]))

---

📡 API Endpoints & Reference

1. FLUX 3 Text-to-Video

Endpoint: POST https://api.muapi.ai/api/v1/flux-3-text-to-video

curl --location --request POST "https://api.muapi.ai/api/v1/flux-3-text-to-video" \
  --header "Content-Type: application/json" \
  --header "x-api-key: YOUR_API_KEY" \
  --data-raw '{
      "prompt": "A majestic eagle soaring over the snow-capped Himalayas",
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "duration": 5,
      "generate_audio": true
  }'

2. FLUX 3 Image-to-Video

Endpoint: POST https://api.muapi.ai/api/v1/flux-3-image-to-video

curl --location --request POST "https://api.muapi.ai/api/v1/flux-3-image-to-video" \
  --header "Content-Type: application/json" \
  --header "x-api-key: YOUR_API_KEY" \
  --data-raw '{
      "prompt": "The clouds move slowly across the sky",
      "images_list": ["https://example.com/mountain.jpg"],
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "duration": 5,
      "generate_audio": true
  }'

---

📖 Documentation & Guides

For prompt engineering and advanced use cases across the full FLUX 3 model family (image and video), see awesome-flux-3-api-prompts.

Method	Parameters	Description
text_to_video	prompt, aspect_ratio, resolution, duration, generate_audio	Generate a video clip from a text prompt (4-10s), with optional native synchronized audio.
image_to_video	prompt, images_list, aspect_ratio, resolution, duration, generate_audio	Animate a static image into a video clip.
upload_file	file_path	Upload a local file (image or video) to MuAPI for use in generation tasks.
get_result	request_id	Check task status for a FLUX 3 video generation task.
wait_for_completion	request_id, poll_interval, timeout	Blocking helper for FLUX 3 video generation tasks.

---

🔗 Official Resources

• API Provider: MuAPI.ai
• Early Access: Get a FLUX 3 API key

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Keywords: FLUX 3 Video API, FLUX 3 Text-to-Video, FLUX 3 Image-to-Video, Black Forest Labs Video AI, FLUX 3 Python SDK, MuAPI, AI Video Generation API, Text-to-Video API, Image-to-Video API, FLUX Video Generator, Native Audio Video Generation, Cinematic AI Video, FLUX 3 API Documentation.