Troubleshooting

Common issues and how to fix them.

API errors during generation

401 Unauthorized

Your API key is invalid, missing, or has been revoked.

  • Double-check you copied the full key with no leading or trailing spaces
  • Click Save key after pasting or changing the key
  • Make sure the active connection is the one you intend to use
  • Log in to your provider’s dashboard and verify the key is active
  • Generate a new key if needed and update it on the active connection

403 Forbidden

Your account does not have permission to use the selected model.

  • Some providers require billing before accessing certain models
  • Try switching to a different model in AI Provider Settings
  • Check your provider dashboard for account restrictions

429 Too Many Requests

You have hit your provider’s rate limit.

  • Free tier accounts often have strict request-per-minute limits
  • Reduce your batch size and run in smaller chunks
  • Wait a few minutes and try again
  • Switch to a provider or paid tier with higher rate limits

500 / 503 Server Error

The provider’s servers are having issues.

  • Wait a few minutes and retry
  • Check your provider’s status page for ongoing incidents
  • Switch to a different provider temporarily

Connection test fails

“Test connection” shows an error but my key looks correct:

  1. Make sure you clicked Save key after entering the key
  2. Make sure the Base URL matches your provider - see Finding Your Base URL
  3. Check that you selected the right provider preset
  4. Try copying the API key again directly from your provider dashboard
  5. Check whether your provider requires a specific model name

Content list issues

CSV file not loading:

  • Make sure the first row is a header row with column names such as title, theme, keywords, and notes
  • If your fields contain commas, wrap them in double quotes: "Sleep, rest, and recovery"
  • Try saving the file as UTF-8 if you are using non-English characters

YAML file not loading:

  • YAML is indent-sensitive - use 2 spaces, not tabs
  • Each item must start with - (dash + space)
  • Validate your YAML at yamllint.com if you are unsure

Items generating with wrong titles:

  • The app accepts title, topic, or subject as column names - make sure one of them is present
  • Check for hidden characters or BOM markers if copying from Excel

Sample analysis issues

No samples found:

  • Confirm the file type is supported for sample analysis: .txt, .md, .pdf, or .docx
  • If using a folder, remember the scan is capped at 10 supported files
  • Make sure the selected files contain readable text

Local scan only:

This means AI analysis was not available, usually because there is no saved API key or the connection is not ready. The app can still count the sample content and use it as raw guidance, but style inference needs an AI connection.

Generation stops mid-batch

If one item fails, the app logs the error and continues with the next item where possible. Open the generation log from the Generate page to see failed items and provider messages.

To retry only failed items, create a new content list with just those titles and run again.

Output files are empty or missing

  • Check that the output folder path exists and the app has write permission to it
  • If using a network drive or OneDrive-synced folder, try switching to a local path such as Documents\BatchGenText
  • Single X posts may be collected into one text file depending on the selected template settings

App won’t start or crashes on launch

  • Try running the app as Administrator once - this can help with initial Windows secure storage setup
  • Check that Windows is up to date; the app requires Windows 10 or later
  • Reinstall the app from the Microsoft Store if the issue persists

Still stuck?

Email hello@3thousand30.com or open an issue with the error message, provider, content-list format, and selected template.