Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
WAVESPEED_API_KEYYesYour WaveSpeed API key (required)
WAVESPEED_API_HOSTNoAPI host URLhttps://api.wavespeed.ai
WAVESPEED_LOG_FILENoOptional log file path
WAVESPEED_LOG_LEVELNoLogging level: DEBUG, INFO, WARNING, ERRORINFO
WAVESPEED_MCP_BASE_PATHNoBase path for saving generated files~/Desktop
WAVESPEED_REQUEST_TIMEOUTNoPer-HTTP request timeout in seconds300
WAVESPEED_API_RESOURCE_MODENoResource output mode: url, local, or base64url
WAVESPEED_API_VIDEO_ENDPOINTNoCustom endpoint for video generation/wavespeed-ai/wan-2.1/i2v-480p-lora
WAVESPEED_WAIT_RESULT_TIMEOUTNoTotal timeout for waiting/polling results in seconds600
WAVESPEED_API_TEXT_TO_IMAGE_ENDPOINTNoCustom endpoint for text-to-image generation/wavespeed-ai/flux-dev
WAVESPEED_API_IMAGE_TO_IMAGE_ENDPOINTNoCustom endpoint for image-to-image generation/wavespeed-ai/flux-kontext-pro

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
text_to_imageA

Generate an image from text prompt using WaveSpeed AI.

Args:
    prompt (str): Required. Text description of the image to generate. MUST BE IN ENGLISH. Non-English prompts will be rejected or result in poor quality outputs.
    model (str, optional): Model to use for image generation.
    loras (list, optional): List of LoRA models to use, each with a path and scale. Format: [{"path": "model_path", "scale": weight_value}]. Default model used if not provided.
    size (str, optional): Size of the output image in format "width*height", e.g., "512*512". Default: 1024*1024.
    num_inference_steps (int, optional): Number of denoising steps. Higher values improve quality but increase generation time. Default: 30.
    guidance_scale (float, optional): Guidance scale for text adherence. Controls how closely the image matches the text description. Default: 7.5.
    num_images (int, optional): Number of images to generate. Default: 1.
    seed (int, optional): Random seed for reproducible results. Set to -1 for random. Default: -1.
    enable_safety_checker (bool, optional): Whether to enable safety filtering. Default: True.
    output_directory (str, optional): Directory to save the generated images. Uses a temporary directory if not provided.
    request_id (str, optional): Request correlation ID for tracing the entire request chain. Strongly recommended to provide a unique ID (e.g., UUID) to correlate logs across the request lifecycle.

Returns:
    WaveSpeedResult object with the result of the image generation, containing:
    - status: "success" or "error"
    - urls: List of image URLs if successful
    - base64: List of base64 encoded images if resource_mode is set to base64
    - local_files: List of local file paths if resource_mode is set to local
    - error: Error message if status is "error"
    - processing_time: Time taken to generate the image(s)
    
Examples:
    Basic usage: text_to_image(prompt="A golden retriever running on grass")
    Advanced usage: text_to_image(
        prompt="A golden retriever running on grass", 
        size="1024*1024", 
        num_inference_steps=50,
        seed=42
    )
    
Note: 
    For optimal results, always provide prompts in English, regardless of your interface language.
    Non-English prompts may result in lower quality or unexpected images.
image_to_imageA

Generate an image from an existing image using WaveSpeed AI.

Args:
    image (str): Required. URL, base64 string, or local file path of the input image to modify.
    images (List[str]): Required. List of URLs to images to modify.
    prompt (str): Required. Text description of the desired modifications. MUST BE IN ENGLISH. Non-English prompts will be rejected or result in poor quality outputs.
    model (str, optional): Model to use for image generation.
    guidance_scale (float, optional): Guidance scale for text adherence. Controls how closely the output follows the prompt. Range: [1.0-10.0]. Default: 3.5.
    enable_safety_checker (bool, optional): Whether to enable safety filtering. Default: True.
    output_directory (str, optional): Directory to save the generated images. Uses a temporary directory if not provided.
    request_id (str, optional): Request correlation ID for tracing the entire request chain. Strongly recommended to provide a unique ID (e.g., UUID) to correlate logs across the request lifecycle.

Returns:
    WaveSpeedResult object with the result of the image generation, containing:
    - status: "success" or "error"
    - urls: List of image URLs if successful
    - base64: List of base64 encoded images if resource_mode is set to base64
    - local_files: List of local file paths if resource_mode is set to local
    - error: Error message if status is "error"
    - processing_time: Time taken to generate the image(s)
    
Examples:
    Single image: image_to_image(image="https://example.com/image.jpg", images=[], prompt="Make it look like winter")
    Multiple images: image_to_image(image="", images=["https://example.com/img1.jpg", "https://example.com/img2.jpg"], prompt="Convert to oil painting style")
    Both parameters: image_to_image(image="https://example.com/main.jpg", images=["https://example.com/ref1.jpg"], prompt="Apply style transfer")
    
Note: 
    For optimal results, always provide prompts in English, regardless of your interface language.
    Non-English prompts may result in lower quality or unexpected images.
generate_videoA

Generate a video using WaveSpeed AI.

Args:
    image (str): Required. URL, base64 string, or local file path of the input image to animate.
    prompt (str): Required. Text description of the video to generate. MUST BE IN ENGLISH. Non-English prompts will be rejected or result in poor quality outputs.
    model (str, optional): Model to use for video generation.
    negative_prompt (str, optional): Text description of what to avoid in the video. Default: "".
    loras (list, optional): List of LoRA models to use, each with a path and scale. Format: [{"path": "model_path", "scale": weight_value}]. Default: [].
    size (str, optional): Size of the output video in format "width*height". Default: "832*480".
    num_inference_steps (int, optional): Number of denoising steps. Higher values improve quality but increase generation time. Default: 30.
    duration (int, optional): Duration of the video in seconds. Must be either 5 or 10. Default: 5.
    guidance_scale (float, optional): Guidance scale for text adherence. Controls how closely the video matches the text description. Default: 5.
    flow_shift (int, optional): Shift of the flow in the video. Affects motion intensity. Default: 3.
    seed (int, optional): Random seed for reproducible results. Set to -1 for random. Default: -1.
    enable_safety_checker (bool, optional): Whether to enable safety filtering. Default: True.
    output_directory (str, optional): Directory to save the generated video. Uses a temporary directory if not provided.
    request_id (str, optional): Request correlation ID for tracing the entire request chain. Strongly recommended to provide a unique ID (e.g., UUID) to correlate logs across the request lifecycle.

Returns:
    WaveSpeedResult object with the result of the video generation, containing:
    - status: "success" or "error"
    - urls: List of video URLs if successful
    - base64: List of base64 encoded videos if resource_mode is set to base64
    - local_files: List of local file paths if resource_mode is set to local
    - error: Error message if status is "error"
    - processing_time: Time taken to generate the video(s)
    
Examples:
    Basic usage: generate_video(image="https://example.com/image.jpg", prompt="The dog running through a forest")
    Advanced usage: generate_video(
        image="/path/to/local/image.jpg", 
        prompt="The dog running through a forest", 
        duration=10,
        negative_prompt="blurry, low quality"
    )
    
Note: 
    IMPORTANT: Prompts MUST be in English. The system only processes English prompts properly.
    Non-English prompts will be rejected or produce low-quality results. If user input is not in English,
    you MUST translate it to English before passing to this tool.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/WaveSpeedAI/mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server