🧩 FAQ & Troubleshooting

This page summarizes the most common issues and solutions when using NextAI,
helping you quickly diagnose and fix problems.

🔌 Network & Connectivity

• Cannot connect or request timeout

  • Ensure your device is connected to the Internet (Wi-Fi or cellular).
  • If the connection is fine but still times out, the provider’s server may be temporarily unavailable — try again later.
  • Accessing overseas APIs (like OpenAI) may be restricted in some regions; configure a proxy under Settings → General → Network Proxy.

• Proxy not working

  • Confirm NextAI has system permission to access the network;
  • Use HTTP or SOCKS5 proxies, and double-check the host and port configuration.

🔑 Model & API Configuration

• Invalid API Key

  • Re-copy and paste your API Key, ensuring no extra spaces or line breaks.
  • If the issue persists, regenerate your key in the provider’s dashboard.

• Incorrect Base URL

  • Use the model’s API endpoint (e.g., https://api.openai.com/v1),
    not a website or console link.
  • Refer to API Configuration Guide.

• Still shows “Please add a model provider”

  • Ensure the provider is enabled;
  • Verify Base URL and API Key are correct;
  • Check whether your current network can access the provider’s domain (some corporate/school networks restrict external APIs).

---

📦 Export & File Issues

• Failed to export image or PDF

  • Grant NextAI storage permission to read and write files;
  • If the issue persists, restart the app or switch networks;
  • For large conversations, allow several seconds for processing.

• Failed to upload attachment

  • Ensure the file size is below the limit (typically under 10MB);
  • Only image formats JPG or PNG are supported.

⚠️ Error Code Reference

Code	Meaning	Suggested Fix
400	Invalid parameters / bad request format	Check your input or model settings
401	Unauthorized or invalid API Key	Reconfigure your API Key or verify permissions
403	Forbidden (account or region restricted)	Change network or contact the provider
404	Not Found	Ensure the Base URL is complete (includes /v1)
429	Too many requests / rate limited	Reduce request frequency or upgrade your plan
500	Server error	Try again later or switch model
503	Service temporarily unavailable	Wait a few minutes and retry

🌐 Network Diagnostics Tips

1. Open your browser and visit the model API URL (e.g., https://api.openai.com/v1).
2. If it fails to load, your network may be blocked.
3. Switch to a home or mobile network, or enable a proxy in settings.
4. If issues persist, delete and re-add the provider to reset the configuration.

💬 Feedback & Support

If the issue still cannot be resolved, please visit
👉 Feedback Page
and submit details (including error code and screenshots).
Our team will assist you as soon as possible.