flux_generate_image
Generate AI images from a text prompt using Flux.
Flux is a family of fast, high-quality image generation models by Black Forest Labs.
Different models offer different tradeoffs between speed, quality, and capabilities.
Use this when:
- You want to create new images from a text description
- You need high-quality AI-generated artwork or photos
- You want fast image generation with good prompt following
For editing existing images, use flux_edit_image instead.
Returns:
Task ID and generated image information including URLs.
flux_edit_image
Edit an existing image using Flux with a text prompt.
This allows you to modify an existing image based on a text description.
The kontext models (flux-kontext-pro, flux-kontext-max) are specifically
designed for high-quality image editing and style transfer.
Use this when:
- You want to modify or transform an existing image
- You want to change specific elements in an image
- You want to apply style changes or artistic effects
- You want to add, remove, or replace objects in an image
For generating new images from scratch, use flux_generate_image instead.
Returns:
Task ID and edited image information including URLs.
flux_list_models
List all available Flux models and their capabilities.
Reference guide for choosing the right Flux model for your use case.
Returns:
Detailed list of all Flux models with descriptions and recommendations.
flux_list_actions
List all available Flux tools and their use cases.
Reference guide for what each tool does and when to use it.
Returns:
Categorized list of all tools with descriptions.
flux_get_task
Query the status and result of a Flux image generation task.
Use this to check if a generation is complete and retrieve the resulting
image URLs and metadata.
Use this when:
- You want to check if an image generation has completed
- You need to retrieve image URLs from a previous generation
- You used async callback and want to check results later
- The initial generation returned a task_id without immediate results
Returns:
Task status and generation result including image URLs.
flux_get_tasks_batch
Query multiple Flux image generation tasks at once.
Efficiently check the status of multiple tasks in a single request.
More efficient than calling flux_get_task multiple times.
Use this when:
- You have multiple pending generations to check
- You want to get status of several images at once
- You're tracking a batch of generations
Returns:
Status and result information for all queried tasks.