Generation Errors
Troubleshoot common video generation errors and failures.
Generation Error Types
- INSUFFICIENT_CREDITS
- Your credit balance is too low. Purchase a top-up pack or wait for your monthly allocation to refresh. Failed generations never consume credits — only completed ones do.
- MODEL_UNAVAILABLE
- The selected AI model is temporarily unavailable. Your model choice is never silently swapped — you'll see the error and can retry, or pick a different model via the Custom layout. If the issue persists, try again in a few minutes.
- CONTENT_POLICY
- The AI model flagged your script or configuration for content policy violations. Review your script for potentially problematic content and adjust.
- TIMEOUT
- Generation took too long and timed out. This is rare but can happen with very complex configurations. Try simplifying (fewer products, simpler style) and re-generate.
- GENERATION_FAILED
- A generic error during generation. This is usually transient. Wait 30 seconds and try again. If it persists, check your settings for unusual combinations.
Troubleshooting Steps
When Generation Fails
- 1
Check the error message
Look at the specific error code and message in the Generations Rail. This tells you exactly what went wrong.
- 2
Check your credit balance
Open the credit meter in the header. Make sure you have enough credits for the generation.
- 3
Simplify your configuration
Reduce complexity: try standard resolution, standard model, fewer features. Generate a simple version first.
- 4
Try again
Many errors are transient. Wait 30 seconds and click Generate again.
- 5
Contact support
If the error persists after 3 attempts, contact support with the error code and your video ID.
Note
scriptmotion uses a circuit breaker pattern for AI model calls: if a model fails repeatedly, it's temporarily taken out of rotation so failures surface quickly instead of hanging. Your model choice is never silently swapped — if your model is unavailable, you'll be told so you can retry or pick another model.
Was this article helpful?