⚠️
This page is not yet translated, showing English version

Common Errors & Solutions

This page compiles common errors you may encounter while using Chatbox and their solutions.

Connection Errors

Network Error

Symptoms: "Network Error" message or connection failure when sending messages.

Solutions:

  1. Check network connection

    • Confirm your device is connected to the internet
    • Try visiting other websites to verify network is working

  2. Try creating a new conversation

    • Close the current conversation and create a new one
    • This can sometimes resolve temporary connection issues

  3. Check proxy/firewall settings

    • If using VPN or proxy, try switching nodes or temporarily disabling it
    • Confirm firewall isn't blocking Chatbox network access
    • Corporate networks may require IT department to whitelist the app

Server Error 500

Symptoms: Server returns a 500 error.

Solutions:

  • This is usually a temporary server-side issue
  • Wait a few minutes and retry
  • If it persists, please let us know through in-app feedback

Activation Failures

Ensure Correct Model Provider is Selected

When using a Chatbox AI License Key, you must select "Chatbox AI" as the model provider.

Steps to check:

  1. Open Settings
  2. Find "Model Provider" or "Provider" option
  3. Ensure "Chatbox AI" is selected
  4. Then enter your License Key

Check if License Key is Complete

Common issues:

  • Missing characters at the beginning or end when copying
  • Extra spaces copied

Solutions:

  • Go back to your purchase confirmation email and copy the License Key completely
  • After pasting, check for extra spaces

Try Switching Network Environment

If the above methods don't work:

  • Try switching to a mobile hotspot
  • Change to a different Wi-Fi network
  • Check for network restrictions

Quota Exhausted

Quota Reset Time

  • Quota resets on your purchase date each month
  • For example: purchased on January 15, quota resets on the 15th of each month

What to Do When Quota Runs Out?

Option 1: Wait for quota reset

  • Wait until the next billing cycle for automatic new quota

Option 2: Purchase an add-on pack

  • Buy additional quota in the app or on the website
  • Add-on quota takes effect immediately

Option 3: Upgrade your plan

Context Too Long

What is Context Too Long?

AI models can only process conversations up to a certain length (called "context window"). Errors may occur when conversations become too long.

Solutions

Method 1: Adjust maximum context messages

  1. Open Settings
  2. Find "Maximum Context Messages" or similar option
  3. Lower the value (e.g., from 20 to 10)
  4. This limits how many history messages are sent to the AI

Method 2: Start a new conversation

  • When current conversation is too long, start a new one
  • If you need to keep important information, manually copy it to the beginning of the new conversation

AI Response is Garbled

Cause Analysis

AI responses appearing garbled, repetitive, or incoherent is usually caused by Temperature setting too high.

The Temperature parameter controls the randomness of AI responses:

  • Higher values mean more random, more creative responses
  • Values too high may cause unstable output

Solutions

  1. Open Settings
  2. Find the "Temperature" parameter
  3. Recommended setting: 0.7 - 0.9
    • 0.7: Relatively stable, suitable for daily conversations
    • 0.9: Slightly varied, suitable for creative writing
  4. Avoid setting to 1.0 or higher

Note: Many newer models (such as o-series reasoning models, some Claude models, etc.) do not support the Temperature parameter. If you encounter errors after setting it, set Temperature to "Not Set" in Chatbox settings.

Other Possible Causes

  • Temporary model issue: Try again later
  • Unstable network: Causes incomplete responses
  • Model choice: Some models may not suit the current task, try switching models