Troubleshooting Guide

Solutions to common issues when using WaveSpeedAI.

Generation Failed

What should I do?

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

Failed requests are automatically refunded within 3 hours.

How to report issues

If you believe there’s a technical problem:

1. Go to Predictions
2. Copy the Task ID (shown in the ID column)
3. Provide it to our support team

API Key Issues

My API key doesn’t work. Why?

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

Rate Limit Errors

I’m getting “Too Many Requests” errors.

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

• Wait — Limits reset every minute.
• Upgrade — Add credits to reach the next tier threshold.
• Optimize — Reduce concurrent requests or add delays between calls.

See Account Levels & Rate Limits for tier details.

Output Quality Issues

Why is my output quality poor?

• 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.

Common Error Codes

Get Help

• Live Chat: Click the chat icon in the bottom-right corner of our website
• Email: support@wavespeed.ai
• Discord: Join our community