Skip to content
Projects

SamurAIGPT/flux-3-video-api

View on GitHub

SamurAIGPT/flux-3-video-api has 98 GitHub stars and 12 forks. GitHot measured 0 stars in 24 hours and 0 in 7 days. Last checked 2026-11-15 16:23 UTC. Last push 2026-10-01.

How these counts are measured

What you can do

  • Native Synchronized Audio: generate_audio produces dialogue, sound effects, and music matched to the visuals — no separate audio pipeline required, no extra charge.
  • Seven Live Endpoints: Text-to-Video, Image-to-Video, Start-End-to-Video, Video Extend, Video Upscaler, plus fast draft modes of Text-to-Video and Video Extend.
  • 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, seven FLUX 3 video endpoints.

Measured star growth

in 24h
0
in 7 days
0
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Python wrapper for Black Forest Labs' FLUX 3 video API — Text-to-Video and Image-to-Video with native synchronized audio.

AI

README.md

Original

FLUX 3 Video API: Python Wrapper for Black Forest Labs' FLUX 3 Video Family

Powered by MuAPI

PyPI version GitHub stars License: MIT Python 3.7+

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), from a static image (Image-to-Video), between two keyframes (Start-End-to-Video), or continue an existing clip (Video Extend) — plus fast draft modes and a video upscaler. All seven FLUX 3 video endpoints are live now.

🌌 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. The full FLUX 3 video API is live now on MuAPI — no waitlist required, just an API key.

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

📺 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 Video Extend (continuing an existing clip)
  • flux-3-video-upscaler — Python SDK for upscaling FLUX 3 (or any) video output beyond its native resolution
  • 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
  • muapi-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, no extra charge.
  • Seven Live Endpoints: Text-to-Video, Image-to-Video, Start-End-to-Video, Video Extend, Video Upscaler, plus fast draft modes of Text-to-Video and Video Extend.
  • 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, seven FLUX 3 video endpoints.

🌟 Key Features

  • ✅ FLUX 3 Text-to-Video: Transform a text prompt into a cinematic video clip, 5–20 seconds long.
  • ✅ FLUX 3 Text-to-Video Draft: Fast, lower-cost draft mode for rapid prompt iteration before a final-quality render.
  • ✅ FLUX 3 Image-to-Video: Animate a static image into a video clip using image_url, with motion physically consistent with the source frame.
  • ✅ FLUX 3 Start-End-to-Video: Generate a controlled transition between a start keyframe and an end keyframe you supply.
  • ✅ FLUX 3 Video Extend: Continue an existing clip with new prompt-guided motion and scene development.
  • ✅ FLUX 3 Video Extend Draft: Fast, lower-cost draft mode for testing continuity before a final extension.
  • ✅ FLUX 3 Video Upscaler: Upscale any video (FLUX 3 output or otherwise) beyond its native resolution.
  • ✅ Native Audio Generation: generate_audio=True produces synchronized voice, sfx, and music from the same generation call, no extra charge.
  • ✅ Flexible Resolutions: 720p or 1080p output on the standard endpoints.
  • ✅ Flexible Aspect Ratios: 21:9, 2:1, 16:9, 9:16 (TikTok/Reels/Shorts), 4:3, 1:1, 3:4.
  • ✅ File Upload: Upload local images or videos directly via upload_file for use as start frames or source clips.

🛠 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",
    image_url="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")]))
# 4. Continue an existing clip (Video Extend)
submission = api.video_extend(
    prompt="The camera pulls back to reveal a sunrise breaking over the skyline",
    video_url="https://example.com/clip.mp4",
    resolution="720p",
    duration=5,
)
result = api.wait_for_completion(submission["request_id"])
print(result.get("outputs", [result.get("url")]))

📡 API Endpoints & Reference

All endpoints are async: the POST call returns {"request_id": "...", "status": "processing"} immediately; poll GET https://api.muapi.ai/api/v1/predictions/{request_id}/result until status is completed or failed, then read the video URL from outputs.

1. FLUX 3 Text-to-Video

Endpoint: POST https://api.muapi.ai/api/v1/flux-3-text-to-video · $0.25/sec @720p, $0.42/sec @1080p

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 Text-to-Video Draft

Endpoint: POST https://api.muapi.ai/api/v1/flux-3-text-to-video-draft · $0.09/sec flat

Fast, lower-cost draft mode for rapid ideation, storyboarding, and prompt iteration before rendering a final-quality clip with Text-to-Video. Same fields minus resolution.

3. FLUX 3 Image-to-Video

Endpoint: POST https://api.muapi.ai/api/v1/flux-3-image-to-video · $0.25/sec @720p, $0.42/sec @1080p

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",
      "image_url": "https://example.com/mountain.jpg",
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "duration": 5,
      "generate_audio": true
  }'

4. FLUX 3 Start-End-to-Video

Endpoint: POST https://api.muapi.ai/api/v1/flux-3-start-end-to-video · $0.25/sec @720p, $0.42/sec @1080p

curl --location --request POST "https://api.muapi.ai/api/v1/flux-3-start-end-to-video" \
  --header "Content-Type: application/json" \
  --header "x-api-key: YOUR_API_KEY" \
  --data-raw '{
      "prompt": "The scene morphs from a busy daytime street to the same street quiet at night",
      "image_url": "https://example.com/start.jpg",
      "end_image_url": "https://example.com/end.jpg",
      "resolution": "720p",
      "duration": 5,
      "generate_audio": true
  }'

5. FLUX 3 Video Extend

Endpoint: POST https://api.muapi.ai/api/v1/flux-3-video-extend · $0.25/sec @720p, $0.42/sec @1080p

Continues an existing clip (source video_url must be under 50MB and under 15 seconds) with new prompt-guided motion.

curl --location --request POST "https://api.muapi.ai/api/v1/flux-3-video-extend" \
  --header "Content-Type: application/json" \
  --header "x-api-key: YOUR_API_KEY" \
  --data-raw '{
      "prompt": "The camera pulls back to reveal a sunrise breaking over the skyline",
      "video_url": "https://example.com/clip.mp4",
      "resolution": "720p",
      "duration": 5,
      "generate_audio": true
  }'

6. FLUX 3 Video Extend Draft

Endpoint: POST https://api.muapi.ai/api/v1/flux-3-video-extend-draft · $0.09/sec flat

Fast, lower-cost draft mode for testing continuity before a final extension. Same fields as Video Extend minus resolution.

7. FLUX 3 Video Upscaler

Endpoint: POST https://api.muapi.ai/api/v1/flux-3-video-upscaler · $1.43/run (Precise), $2.00/run (Creative)

curl --location --request POST "https://api.muapi.ai/api/v1/flux-3-video-upscaler" \
  --header "Content-Type: application/json" \
  --header "x-api-key: YOUR_API_KEY" \
  --data-raw '{
      "video_url": "https://example.com/clip.mp4",
      "upscale_factor": 2,
      "creativity": 0
  }'

📖 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 (5-20s), with optional native synchronized audio.
text_to_video_draft prompt, aspect_ratio, duration, generate_audio Fast, lower-cost draft mode of text_to_video.
image_to_video prompt, image_url, aspect_ratio, resolution, duration, generate_audio Animate a static image into a video clip.
start_end_to_video prompt, image_url, end_image_url, aspect_ratio, resolution, duration, generate_audio Generate a transition between a start and end keyframe.
video_extend prompt, video_url, aspect_ratio, resolution, duration, generate_audio Continue an existing clip with new prompt-guided motion.
video_extend_draft prompt, video_url, aspect_ratio, duration, generate_audio Fast, lower-cost draft mode of video_extend.
video_upscale video_url, prompt, upscale_factor, creativity Upscale any video beyond its native resolution.
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

📄 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, FLUX 3 Start-End-to-Video, FLUX 3 Video Extend, FLUX 3 Video Upscaler, 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.