Understaning Errors
Solutions to common issues users may encounter. Includes diagnosis tips and recommended fixes to ensure a smooth experience.
1. General Errors
These errors can occur during normal operation—when BringScript is communicating with the server, generating code, or running scripts in After Effects/Illustrator.
Error Message | Meaning | How to Fix |
|---|---|---|
Failed to connect to network. | BringScript cannot reach the AI server. | • Check your internet connection. • Verify firewall or proxy settings. |
No API key set. | You haven’t provided an API key in Settings. | • Open Settings and paste a valid Gemini or OpenRouter key. • Save and retry. |
No prompt provided. | You clicked “Generate” without writing a prompt. | • Enter a clear, descriptive prompt in the input field. |
Error generating JSX. | The server failed to produce usable ExtendScript code. | • Check your prompt for clarity. • Ensure your API key has available credits. • Retry generating. |
Error fixing JSX. | BringScript couldn’t automatically resolve a script error. | • Use the Preview feature to inspect the broken code. • Refine your prompt or edit manually. |
Error previewing JSX. | The server returned code that couldn’t be previewed in After Effects/Illustrator. | • Check for unsupported expressions. • Simplify your prompt and try again. |
Failed to execute JSX. | After Effects/Illustrator rejected the generated script at runtime. | • Inspect the code in Preview mode. • Correct syntax errors or unsupported API calls. |
Invalid API response. | The server’s JSON response was malformed or missing expected fields. | • Wait a moment and retry. • If persistent, contact support with the response details. |
Something went wrong. | A catch-all error for unexpected failures. | • Try again. • If issue remains, restart the app and reproduce the error for support. |
2. API Response Errors
These errors come directly from the AI provider (Gemini/OpenRouter) when they detect issues in your request or account.
Server Response (JSON) | Displayed Message | What It Means | What You Can Do |
|---|---|---|---|
{ error: "Missing prompt." } | Missing prompt | You sent a request without any prompt text. | • Add a descriptive prompt and try again. |
{ error: "Invalid API key." } | Invalid API key | The key you provided is incorrect or expired. | • Re-enter your API key in Settings. • Verify the key on your AI provider’s site. |
{ error: "Subscription expired." } | Subscription expired | Your AI service subscription is no longer active. | • Renew your subscription with the provider. • Switch to a different key. |
{ message: "Internal server error"} | Internal server error | The AI provider’s backend encountered an unexpected issue. | • Wait a few minutes and retry. • If it persists, contact the provider’s support. |
{ message: "Unauthorized" } | Unauthorized | Your key lacks permission for this endpoint. | • Check your provider account settings. • Ensure you have the correct access. |
{ message: "Rate limit exceeded"} | Rate limit exceeded | You’ve sent too many requests in a short time. | • Pause and retry after a minute. • Upgrade your plan if needed. |
3. Handling and Reporting Errors
When you encounter an error, follow these steps to troubleshoot and report the issue:
Check the Status Dot
Red: Indicates a blocking error.
Yellow: Flags a warning or soft failure.
Use the Fix Error Button
For generated script errors, click Fix Error.
BringScript’s AI will attempt an automatic correction.
Review in Preview Mode
Always preview before execution.
Manually tweak any code that doesn’t meet your needs.
Validate Settings
Ensure your API key is correct and has available credits.
Verify your After Effects/Illustrator version matches the panel’s settings.
Reproduce & Report
If an error persists, note the exact message and steps to reproduce.
Send these details to support@pilotfront.com for fast assistance.
By understanding these errors and their solutions, you’ll maintain a smooth, productive workflow with BringScript—turning potential roadblocks into quick learning moments.
Join our Community Forum
Any other questions? Get in touch