Troubleshoot FigRay Generation, Saving, and Export
Resolve credit, OCR, vectorization, upscaling, cloud save, and export problems.
Start With These Four Steps
- Keep the project tab open and do not repeatedly trigger the same operation.
- Refresh, sign in again, and confirm that the account email is verified.
- Check the credit balance, active plan, and network connection.
- Retry once. If it still fails, record the time, project name, and error text.
Do Not Share Secrets
Support does not need your password, API keys, payment card details, or full database URL. A project name, error text, time, browser, and safe screenshot are normally enough.
Common Errors
| Symptom or message | Common cause | What to do |
|---|---|---|
| Not enough credits | Balance is below the operation cost | Review the credit cost table, upgrade, or buy a credit pack |
| FigRay is busy | Provider or application rate limit | Wait briefly and retry once instead of submitting repeatedly |
| Generation failed | Provider timeout, reference problem, or network interruption | Shorten the prompt or remove a problematic reference and retry |
| 4K/8K unavailable | Active plan is not Plus or Pro | Use 2K or upgrade to Plus or Pro |
| Text scan failed | OCR limit, large image, small text, or low contrast | Wait for limits to reset, try a 2K image, or use a clearer version |
| No text detected | Text is small, rotated, blurred, or merged into the background | Upscale and retry, or state the exact replacement in a normal revision prompt |
| Region redraw failed | Selection is too small, request is unclear, or provider timed out | Expand the selection and request one specific local change |
| Vectorization failed | Unsupported input, provider timeout, or excessive complexity | Use PNG/JPEG, retry later, or simplify the image first |
| Upscaling failed | Current asset is SVG, plan is ineligible, or provider timed out | SVG does not need raster upscaling; check the plan and retry |
| Cloud sync failed | Storage, database, or network problem | Keep the tab open and retry saving; do not immediately clear browser data |
| Storage limit reached | Current usage plus the new file exceeds the plan limit | Check usage in Billing, delete unused projects, or upgrade |
| PPTX is not fully editable | SVG contains complex paths, filters, or unrecognized text | Simplify in the SVG editor, keep the SVG, and export a PNG fallback |
Credit Charges and Refunds
Operations that use a model or processing provider check and charge credits before work starts. Generation, text editing, region redraw, upscaling, white background, and vectorization automatically attempt to refund the charge when provider processing fails. If the balance does not update, refresh the credit page before contacting support with the operation time and project name.
OCR Usage Limits
Text scanning does not use model credits, but it has separate limits. Users without a subscription can scan up to 2 times per minute, 5 times per day, and 10 times in total. Paid users can scan up to 5 times per minute and 30 times per day. Wait for the applicable window to reset instead of repeatedly refreshing.
When Cloud Saving Fails
FigRay uses browser data as a temporary fallback, but local data is not a replacement for cloud backup.
- Do not close the tab or clear site data.
- Retry saving after the connection recovers.
- Export PNG or SVG as a temporary backup when possible.
- Reopen the project and confirm that the latest revision synchronized.
Information for Support
- the FigRay account email;
- the project name, without confidential research content;
- the date and approximate time;
- the complete error message;
- browser and operating system;
- the action immediately before the error, such as "save after 4K upscale."