Troubleshooting Guide

Solutions to common issues when using Get3W.

API Issues

401 Unauthorized

Symptoms: API returns 401 Unauthorized

Solutions:

1. Verify your API key is correct
2. Check header format: Authorization: Bearer YOUR_API_KEY
3. Ensure you've made at least one top-up
4. Try generating a new API key

429 Too Many Requests

Symptoms: API returns 429 Too Many Requests

Solutions:

1. Wait 60 seconds for rate limits to reset
2. Reduce concurrent requests
3. Upgrade your account level for higher limits
4. Implement exponential backoff in your code

500 Internal Server Error

Symptoms: API returns 500 Internal Server Error

Solutions:

1. Retry the request after a few seconds
2. Check if the model is available
3. Try a different model
4. Contact support if the issue persists

Generation Issues

Task Stuck in "Processing"

Symptoms: Task status remains processing for too long

Expected wait times:

• Images: < 30 seconds
• Videos: < 5 minutes
• 3D models: < 10 minutes

Solutions:

1. Wait — some tasks take longer during high load
2. Check the model's typical processing time
3. Delete the task and retry
4. Contact support if consistently slow

Poor Quality Output

Symptoms: Generated content doesn't match expectations

Solutions:

1. Improve your prompt — see Write Better Prompts
2. Try a different model — see Choose the Right Model
3. Increase resolution or quality parameters
4. Use the Prompt Enhancer in the web interface
5. Try different seed values

Task Failed

Symptoms: Task status is failed with an error message

Common causes:

Error	Solution
Invalid prompt	Check prompt format and content
Invalid image URL	Ensure the URL is accessible and valid
Unsupported dimensions	Check supported sizes for the model
Content policy violation	Modify your prompt to comply with policy
Model unavailable	Try later or use a different model

SDK Issues

Python SDK: ModuleNotFoundError

pip install --upgrade get3w

JavaScript SDK: Authentication Error

Ensure your API key is set:

export GET3W_API_KEY="your-api-key"

Timeout Errors

Increase the timeout in your client:

output = get3w.run(
    "model-id",
    {"prompt": "..."},
    timeout=60000,
)

Web Interface Issues

Cannot Log In

1. Clear browser cache and cookies
2. Try a different browser
3. Check if your account is active
4. Contact support

Generation Not Starting

1. Check your credit balance
2. Verify you haven't hit rate limits
3. Try refreshing the page
4. Check browser console for errors

Still Need Help?

• Check the FAQ for common questions
• Contact support for personalized help