Troubleshooting and recovery

CAD Scene checks requirements before sending. Fix every item in the requirements dialog, then send again.

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.

If a region sits outside the image, move or repaint it. The mask must overlap the source.

Label every region

Describe the intended change on every marked region. Use separate labels for separate changes. The global prompt can add context, but it does not replace region labels.

Keep the Edit panel open while sending. The canvas must remain mounted so CAD Scene can export the mask.

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

Reduce image count, choose a lower-cost model or quality, or top up. An insufficient-credit rejection rolls back the transaction. It creates no renders or jobs.

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 recovery paths.

Retry creates one new render with the original prompt, mode, model, quality, and attachments.

Retry with model keeps the prompt, mode, and attachments. Choose a compatible model and quality before submitting.

Both actions use the project's current Composition for the replacement render. They do not restore the original five-field snapshot.

Retry and Retry with model create a new charged submission. The failed original is refunded separately.

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

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.