Troubleshooting and recovery
Resolve input, credit, limit, image, provider, and cancellation problems.
Updated Aug 10, 2026 · 8 min read
Enter a search term.
CAD Scene can catch requirements before submission. A collapsed Edit panel defers source, region, and name checks until it is opened. User-fixable server failures after Send populate the same requirements dialog. The draft stays available so you can fix every listed item and send again.
Input requirements and the credit check remain blocking and run before the brief check. If the brief-check provider, timeout, schema, or network request fails, CAD Scene silently sends the original prompt and stores no clarification. For a clarification question, Skip and Send Now follows the same original-prompt path. For a mode conflict, Continue with Create, Continue with Enhance, or Continue with Edit uses that path under the selected mode's rules. Neither action can bypass a missing source, invalid Edit regions or names, unsupported settings, ownership, credits, or quota.
Recovery flow
Check requirements
Available client checks can list unmet requirements before upload or charge.
Open collapsed Edit
When Edit is collapsed, source, region, and label checks wait until the panel opens.
Review after Send
A user-fixable server failure can populate the same requirements dialog after Send.
If the render reaches a final failure
The failed job is refunded. Any replacement is a new charged submission.
- Retry
- Keep valid stored settings. Invalid settings keep the original valid model and use its defaults. A retired or invalid model uses the global default selection.
- Retry with model
- Choose another compatible model and output settings.
- New Composer send
- Correct the inputs in a new draft, then send through the normal checks.
Edit requirements
Pick an image to edit
Open the Edit panel and choose a source image. A Composer reference does not count as the source.
If a retry says the source is no longer available, the stored original was removed or cannot be signed. Choose or upload a current source.
Mark a region
Paint at least one region on the source. Keep every mark on the image. One Edit can contain up to eight regions with every current model.
If a region sits outside the image, move or repaint it. The mask must overlap the source.
The wrong regions merged
Select Undo once. Redraw the mark, then choose Create new region when the overlap choice opens. This keeps the named regions separate even when their bounds overlap.
If nearby strokes merge without asking, clear Group nearby strokes automatically in the footer. The next ambiguous mark opens the choice again.
The selected model supports fewer regions
CAD Scene preserves every region when a model switch lowers the available cap. The footer and Send requirement state the exact number to remove. Delete or undo regions, or choose a model whose Edit capability supports the current count.
Overlapping instructions conflict
Overlapping regions share editable pixels. Tighten one or both marks when the requested changes cannot coexist. Otherwise rewrite the instructions so every named change can apply in the shared area.
Add an Edit prompt
The Edit prompt cannot be empty. Write one instruction that mentions every region name and states what changes there.
In Region A, replace the paving with dark basalt. In Region B, add a slim black steel frame.
Name every region
Every marked region needs a non-empty, unique name. CAD Scene fills Region A, Region B, and the later names automatically. You can edit them.
If two names still match after case, spacing, and character-width normalization, rename one. For example, Region A and region A are duplicates.
Overlapping names need separate prompt occurrences. If the names are Wall and North Wall, the phrase North Wall cannot satisfy both. Write both names: Replace North Wall with oak. Keep Wall unchanged.
Reference every region name
Each unique name needs its own whole-phrase occurrence outside quoted text. If Region A appears only inside "Region A", remove the quotes around the reference. Then describe the area's change.
If one name is missing, use the inline error or Update the prompt. Add the exact missing name as a separate reference. Do not rename every region to work around one missing reference.
Use straight double quotes only for exact new readable scene text:
In Region A, change the sign to "Library".
Existing scene text stays unless the prompt asks to change or remove it. Region names are controls, not requested scene text.
Keep the Edit panel open while sending. The canvas must remain mounted so CAD Scene can export the mask.
Safe spatial recovery
Edit can use a marked area's spatial placement when an instruction cannot be prepared safely. The same source and union mask continue through the render. You do not need to repaint the regions. Review the result and revise the prompt only when the intended change is missing.
References not supported
GPT Image 2 Edit accepts only the source image and mask. Remove Composer references or switch to a Nano Banana model.
Every model supports up to five Composer references in Create and Enhance.
Credits and limits
Not enough credits
CAD Scene shows input requirements before credit options. When credits are the only remaining blocker, it preserves the draft or action selection and opens the available plans and top-ups.
Reduce image count, choose a lower-cost model or output setting, or purchase credits. An insufficient-credit rejection rolls back the transaction. It creates no renders or jobs.
Canceling checkout charges nothing and returns to the same offers. A completed return succeeds when Stripe reports paid or no_payment_required. After that verification, Continue returns to the blocked control with its state restored. Select the action again when you are ready. CAD Scene does not submit it automatically.
See quality and cost for the current per-image rates.
Daily limit reached
The error includes an estimated reset time for the rolling 24-hour window. Wait for that time or contact support for a higher cap.
Render, Composition, and field generation have separate limits. See credits and limits.
Too many requests
A short rate limiter can reject a burst even when the daily limit remains. Wait briefly, then submit once.
A provider rate limit is different. The worker retries a retryable provider failure once before showing a final failed tile.
Project is in Trash
Restore the project before sending another render. Trashed projects remain readable but reject new render writes.
Image and dimension problems
The image cannot be read
Remove the image, then re-export or re-upload it. The file may be corrupt or its contents may not match its declared format.
Use PNG or JPEG when browser format support is uncertain. If HEIC or HEIF cannot be decoded, convert it before upload.
Source dimensions are invalid
Use a normal architectural frame with readable pixel detail. Avoid a tiny thumbnail.
GPT Image 2 supports aspect ratios up to 3:1. Crop a more extreme source before retrying with that model.
For Edit, the source and generated mask must describe the same canvas. This input requirement does not guarantee identical output dimensions. Every output remains subject to its model's size constraints. GPT Image 2 can scale and round the source to its nearest valid dimensions.
Too many references
Remove Composer references until five or fewer remain. Source and mask images do not count toward that reference limit.
Retry a render
A failed tile offers two direct recovery actions. The failed original is refunded before any replacement is submitted.
Retry creates one new render with the original prompt, mode, and attachments. It keeps the stored model and output settings when they remain valid. If the stored settings are invalid but the original model remains valid, Retry keeps that model and uses its current defaults. A retired or invalid model uses the global default model and its defaults.
Retry with model keeps the prompt, mode, and attachments. Choose a compatible model and supported output settings before submitting. Changing the model resets the settings to the chosen model's defaults before you adjust them.
If the prompt or attachments need correction, prepare a new Composer draft. Then send it through the normal preflight flow.
Both retry actions and any new Composer send use the project's current Composition. They do not restore the original five-field snapshot. Each replacement is a new charged submission.
Content policy rejection
Rephrase the prompt without strong identifying or violent terms. Do not repeat the same rejected prompt. Content-policy failures are terminal and are not retried automatically.
Unexpected provider error
CAD Scene retries an unexpected provider failure once. If the second attempt fails, the tile becomes final and its credits are refunded.
Use Retry for the same settings. Use Retry with model when another model is compatible. If the inputs need correction, prepare a new Composer draft.
Cancellation did not stop the render
Cancellation is accepted only while a job is queued or generating. Once upload starts, the render is allowed to finish.
An accepted cancellation refunds that job. A late, refused cancellation does not refund a result that completes successfully.
Contact support
From a signed-in workspace, open Help, then select Contact Support. CAD Scene opens support chat with your current account details on desktop and smaller screens. If chat is unavailable, the same action opens this contact section instead.
Contact [email protected] when:
- A refund does not appear after a final failure or accepted cancellation.
- A reproducible provider error remains after one careful retry.
- A project or stored render cannot be opened.
- You need a higher daily cap.
Include the project name, study name, approximate time, and the visible error code. Do not send account passwords or private API keys.
