Troubleshooting Guide

Solutions to common issues when using WaveSpeedAI.

Generation Failed

Check your parameters — Some models have specific requirements (e.g., image dimensions, file formats). Read the model’s README.
Check your balance — Ensure you have sufficient credits.
Try again — Temporary issues may resolve on retry.
Report the issue — Copy the Task ID from Predictions and contact support.

Eligible inference failures are refunded automatically. If your balance does not update, provide the Task ID to support.

If you believe there’s a technical problem:

History Page - Task ID

API keys require a top-up to activate. Keys generated before your first top-up will not work. Add credits to your account, then try again.

Also check:

The key is copied correctly (no extra spaces)
The key hasn’t been deleted or regenerated
You’re using the correct header format: Authorization: Bearer YOUR_API_KEY
Network issues may also cause authentication failures — try again or check your network connection

You’ve hit your tier’s rate limit. Options:

Use Prompt Enhancer — It optimizes your prompt for better results ($0.001/use).
Check model parameters — Resolution, steps, and other settings affect quality.
Choose the right model — Different models excel at different tasks. Try a few to find the best fit.
Provide clear prompts — Be specific and descriptive.