Note: This document contains multiple images stored in the local
assetfolder and referenced using relative paths.Viewing Options:
- Clone the repository and view in a local Markdown viewer
- Read the text descriptions in the document, as most steps include detailed explanations
FLUX.1 Kontext is a professional image-to-image editing model developed by Black Forest Labs, designed for intelligent contextual understanding and precise image manipulation. It supports a wide range of editing tasks without requiring complex prompts, including object modification, style transformation, background replacement, character consistency editing, and text editing.
FLUX.1 Kontext's core strengths lie in its exceptional contextual understanding and ability to maintain character consistency. It ensures that key elements—such as character features and compositional layouts—remain stable even after multiple rounds of editing.
Additionally, both the FLUX.1 Kontext Pro and FLUX.1 Kontext Max versions of the API are now available as paid offerings. Black Forest Labs says it will soon release the open source FLUX.1 Kontext Dev.
- FLUX.1 Kontext Pro: Ideal for editing, compositing, and creative regeneration.
- FLUX.1 Kontext Max: Optimized for advanced typography, prompt precision, and editing speed.
- FLUX.1 Kontext Dev: Coming soon.
WaveSpeedAI is a global leading platform in multimodal AI acceleration, integrating the most advanced AI video and image generation models. We provide efficient, secure, and reliable solutions, empowering developers and enterprises to accelerate creation and commercialization.
WaveSpeed MCP empowers any agent—such as those built on large language models like DeepSeek—to effortlessly gain image and video generation abilities through a standardized interface, enabling truly multimodal interaction.
- High-Quality Images: Rich in detail, diverse in style, and ready for professional creative use.
- Smooth Video Animation: 24fps high frame rate ensures fluid and natural motion.
- Diverse Style Support: From realistic to abstract, Western to Eastern aesthetics—tailored to a variety of creative needs.
Developers don't need to master the complexities of image and video generation. With simple integration via MCP, agents can be instantly equipped with powerful visual creation capabilities.
- Fast Response: The full generation process completes in just a few seconds.
- Stable and Consistent: Standardized interfaces ensure consistent output quality.
- Scalable: Supports multiple models and parameter tuning to fit diverse application scenarios.
Windsurf is a new AI programming assistant developed by the Codeium team, designed to enhance developers' productivity through deep integration with AI technologies. It excels in contextual understanding, toolchain integration, and intelligent code assistance, while also offering a wide range of features and flexible collaboration modes. Like Cursor, Windsurf provides access to GPT-4o and Claude 3.5 Sonnet models — completely free to use.
However, Windsurf still has some limitations. For example, during development, if you want it to fetch a website's logo, generate a product promo video, or connect directly to a database to retrieve user data—tasks that involve multimodal processing or real-world execution—Windsurf often falls short.
This is exactly where MCP makes a difference. It extends Windsurf's capabilities beyond reasoning, enabling it to act. With MCP, Windsurf evolves from a tool that can "think" to one that can also "do," becoming a truly unified AI assistant that helps developers complete the full loop from intelligent inference to real-world execution.
This guide uses Windsurf as an example to demonstrate how to add image and video generation capabilities using WaveSpeed MCP. Before you begin, please ensure you have the following prerequisites:
If you're not already familiar with Windsurf, you can download it from the official website. After installation, log in using your preferred authentication method.
WaveSpeedAI is the world's fastest and most cost-effective AI platform for image and video generation.
If you don't already have an account, you can create one here.
Get Access Key.
Simply install the MCP client provided by WaveSpeedAI. For more details about the implementation, refer to our documentation.
If you're new to MCP, think of it as an AI orchestrator that coordinates multiple large models and tools to automate complex tasks, enabling AI to not just process information but also take action.
pip install wavespeed-mcpYou can check the version information after installation.
pip show wavespeed-mcpStep 1: Launch the Windsurf IDE and click the gear icon in the upper right corner to access the settings panel, then search for 'MCP'.
Step 2: Configure the MCP Server. When redirected to the MCP list, click Add. In the MCP marketplace that appears, locate the "Configure Manually" option below the search box and click it.
Step 3: Configure your WAVESPEED_API_KEY.
On the configuration page, enter the following JSON:
Note: WAVESPEED_API_RESOURCE_MODE accepts one of three values: "url", "base64", or "local". The default is "url".
{
"mcpServers": {
"Wavespeed": {
"command": "wavespeed-mcp",
"env": {
"WAVESPEED_API_KEY": "<YOUR_WAVESPEED_API_KEY>"
}
}
}
}Click Confirm to complete the configuration process.
With your newly configured agent in Windsurf, you can generate images or videos with a single click. The following examples demonstrate the capabilities of FLUX.1 Kontext.
Prompt:
A man dressed in a classic suit, wearing a dark jacket paired with a striped shirt, holding a vintage microphone with a confident and elegant posture and a warm smile on his face. The composition keeps the man in sharp focus, perfectly highlighting his charming retro charisma and strong stage presence. The overall scene incorporates cinematic lighting effects, with meticulously detailed elements, creating a vibrant and joyful atmosphere.
Agent Running Process:
Result:
Prompt: Change the background to a party.
Agent Running Process:
Result:
Note: Images are automatically uploaded and optimized based on the prompt text.
Prompt: Transform to cartoon style.
Agent Running Process:
Result:
Prompt: Add "must-listen-to album" as title.
Agent Running Process:
Result:
Prompt: Change the title to "never gonna give you up"
Agent Running Process:
Result:
Prompt: Change model posture: give a thumbs up, remove the microphone.
Agent Running Process:
Result:
Prompt: Make it an album cover in a music store
Agent Running Process:
Result:
WaveSpeedAI and Windsurf Agent empower developers to unleash their creativity and produce high-quality multimodal content with unprecedented efficiency.
Start creating today!
📲 Connect with us: