Python SDK

pip install wavespeed

import wavespeed
 
output = wavespeed.run(
    "wavespeed-ai/z-image/turbo",
    {"prompt": "Cat in space, cinematic lighting"},
)
 
print(output["outputs"][0])  # Output URL

export WAVESPEED_API_KEY="your-api-key"

from wavespeed import Client
 
client = Client(api_key="your-api-key")
result = client.run("wavespeed-ai/z-image/turbo", {"prompt": "Cat"})

output = wavespeed.run(
    "wavespeed-ai/z-image/turbo",
    {"prompt": "Cat"},
    timeout=36000.0,      # Max wait time in seconds (default: 36000)
    poll_interval=1.0,    # Status check interval (default: 1.0)
)

output = wavespeed.run(
    "wavespeed-ai/z-image/turbo",
    {"prompt": "Cat"},
    enable_sync_mode=True,  # No polling, faster for supported models
)

from wavespeed import Client
 
client = Client(
    api_key="your-api-key",
    max_retries=3,              # Task-level retries (default: 0)
    max_connection_retries=5,   # HTTP connection retries (default: 5)
    retry_interval=1.0,         # Delay between retries (default: 1.0)
)

import wavespeed
 
url = wavespeed.upload("/path/to/image.png")
print(url)  # Use this URL as input for models