Troubleshooting
Common issues and solutions when using turnip. Can't find your answer? Open an issue on GitHub.
Image Generation Issues
Error: Invalid API Key
Your OpenAI API key is missing or invalid.
# Check your .env file OPENAI_API_KEY="sk-..." # Verify key works curl https://api.openai.com/v1/models \ -H "Authorization: Bearer $OPENAI_API_KEY"
Error: Rate Limited
You've exceeded OpenAI's rate limits for image generation.
✓Wait a few minutes before retrying
✓Upgrade your OpenAI plan for higher limits
✓Use
--quality low for faster generationError: Content Policy Violation
Your prompt triggered OpenAI's content moderation.
✓Rephrase your prompt to be less explicit
✓Avoid copyrighted characters or real people
✓Focus on abstract or artistic descriptions
Generation Takes Too Long
High-quality images can take up to 2 minutes. For faster results:
✓Use
--quality medium for 3-5x faster generation✓Use square images (1024x1024) instead of portraits
✓Use
--format jpeg instead of PNGToken Deployment Issues
Error: Insufficient SOL Balance
Your wallet doesn't have enough SOL for deployment.
# Check wallet balance turnip config --check # You need at least 0.05 SOL for deployment # Plus additional SOL for dev buy if enabled
Error: Transaction Failed
The Solana transaction didn't confirm.
✓Check Solana network status at status.solana.com
✓Increase slippage with
--slippage 15✓Try again - network congestion is often temporary
Error: Invalid Wallet Key
Your wallet private key format is incorrect.
✓Ensure you're using base58 format (not hex)
✓Export from Phantom: Settings → Security → Export Private Key
✓Check for extra whitespace or quotes in .env
IPFS Upload Failed
Image or metadata failed to upload to IPFS.
✓Check your internet connection
✓Ensure image is under 50MB
✓Retry - IPFS gateways occasionally timeout
Configuration Issues
Helius RPC Connection Failed
Cannot connect to Helius RPC endpoint.
✓Verify HELIUS_API_KEY is correct
✓Check Helius dashboard for usage limits
✓Try a different network (mainnet vs devnet)
.env File Not Loading
Environment variables aren't being read.
# Ensure .env is in the current directory ls -la .env # Run turnip from the directory containing .env cd /path/to/project turnip generate "..."