Neural4D's 3D Studio runs every generation job through two sequential stages: base mesh synthesis powered by the Direct3D-S2 engine, followed by a separate PBR texture bake. Each stage can surface its own class of errors. Most failures fall into one of five categories: bad input, queue timeout, texture pipeline failure, export restriction, or browser-side cache corruption.
| Error symptom | Most likely cause | First action |
|---|---|---|
| Generation fails immediately after submit | Input image violates size or ratio rules | Ensure resolution >256x256; crop to subject |
| Mesh appears with holes or missing faces | Low-contrast background or complex transparency | Use plain background; describe opaque material in prompt |
| White mesh with no texture | PBR texture step timed out or was skipped | Run the AI Texture tool manually |
| Progress spinner frozen for 3+ minutes | Complex model processing (normal) | Wait patiently. Do not refresh. 3+ mins is normal. |
| Export button greyed out | Session expired or authentication error | Open incognito window or log out/in |
Immediate failures before the progress bar even starts are caused by the input image failing a server-side validation check. The Image to 3D pipeline enforces the following requirements:
| Requirement | Details & fix |
|---|---|
| Aspect ratio | Ratios more extreme than 4:1 or 1:4 are rejected. Crop to a roughly square or standard landscape frame before uploading. |
| Subject coverage | If the subject occupies less than roughly 20% of the frame area, the Direct3D-S2 encoder cannot lock onto it. Zoom in and crop tightly to the object. |
| Resolution | The image resolution is recommended larger than 256 x 256 px. Submissions below this threshold may produce incomplete geometry or fail the validation check outright. |
For 3D printing workflows using SLA or FDM printers, this step matters most. A tightly cropped, high-contrast photo of a furniture component or mechanical part produces a far cleaner watertight mesh than a wide environmental shot where the subject is small.
Mesh gaps occur when the Direct3D-S2 encoder cannot confidently reconstruct geometry from the input signal. Three conditions reliably produce this outcome:
| Root cause | What to do |
|---|---|
| Low-contrast background | A white subject on a white background makes it impossible to locate object boundaries. Switch to a neutral grey or any solid color that contrasts clearly with the subject. |
| Transparent or reflective surfaces | Glass, chrome, and clear acrylic have almost no recoverable depth signal. Describe the material as opaque in your prompt (e.g. "matte white ceramic" instead of "glass vase"). Re-apply the correct texture afterward with AI Texture. |
| Multi-object scenes | When the image contains multiple disconnected objects, the engine may merge or drop individual pieces. Isolate to one subject per generation job. |
If you receive a blank white mesh, it means the texture feature was not enabled during your initial generation. When starting an Image to 3D or Text to 3D job, you can turn on the texture option to generate PBR textures alongside the mesh. A white mesh is not an error; it simply means the model has not been textured yet.
If you already have a generated white mesh, there are two ways to apply textures retroactively:
| Method | How to do it |
|---|---|
| From the model details page | Open the generated model from your library and click the Texture button on its details page. This sends the model directly to the AI Texture tool for processing. |
| From AI Texture directly | Go to AI Texture in the Studio sidebar, select your white mesh from your model library, upload a reference image showing the material you want, then click Generate. Each texture generation costs 10 Power credits. If you need more credits, see Pro plan options. |
A generation that takes longer than 3 minutes is not necessarily stalled. Complex objects with fine surface detail, or jobs submitted at higher quality settings, can require significantly more processing time than a standard submission. The progress indicator may appear static while the engine is still working internally.
A job has likely failed only if the spinner shows no change for an extended period (typically 10 or more minutes) and you receive no completion notification. In that case, follow this recovery sequence:
All users, including free plan users, can generate textures, preview the textured result, and export in all six formats: .OBJ, .FBX, .GLB, .USDZ, .STL, and .BLEND. Free plan results are not marked as "Trial." If the export button appears greyed out or fails, the cause is typically a browser session issue rather than a plan restriction. For higher Power limits and priority processing, see the Pro plan details.
If export fails, try these steps in order:
| Step | What to do |
|---|---|
| 1. Clear browser cache | Open an incognito or private window and attempt the export from there. A corrupted session cache is the most common cause of false export failures on paid accounts. |
| 2. Re-authenticate | Log out and back in if your session token expired mid-session, then retry the export. |
| 3. Try an alternate format | If .GLB fails but .OBJ works, download as OBJ and convert to your target format using Blender's free export pipeline. |
Most of the errors above are avoidable with a short pre-flight checklist before every submission:
| Check | What to verify |
|---|---|
| Image prep | Crop tightly to the subject, remove busy backgrounds, and use an image with a resolution larger than 256 x 256 px. |
| Prompt clarity | Name one specific object and specify the material as opaque. "A ceramic coffee mug with a smooth white glaze, single object, centered" outperforms "a coffee shop table with cups and plates." |
| Power balance | Confirm you have sufficient Power balance before submitting. A job that starts with insufficient credits fails partway through and cannot be auto-recovered. |
| Browser setup | Use Chrome or Edge with ad-blocker extensions disabled. Some aggressive content blockers intercept the WebSocket connection that drives the generation progress tracker. |
If a generation completes but the shape is wrong (incorrect proportions, a missing component, or distorted topology), you do not need to restart from scratch. Neural4D-2.5 is the conversational AI modeling assistant available exclusively for Text to 3D and Image to 3D outputs.
Open the result and type a plain-language correction. For example: "make the legs 20% thinner and extend them downward" or "remove the extra protrusion on the top surface." Neural4D-2.5 applies targeted edits to the mesh without discarding the full geometry, which is faster than a full regeneration and does not require an additional Power deduction for minor shape corrections.
Note: Neural4D-2.5 applies only to 3D generation outputs. It is not available for Text to Image or Text to Video results; for video outputs, adjust the prompt and regenerate.
Still need help? If you encounter other issues, visit the Neural4D Help Center for more detailed guidance pages.
'%3e%3cg%3e%3cpath%20d='M14.22126,2L16.980341,2L10.922359,8.365314L18,17.000000999999997L12.44585,17.000000999999997L8.0973005,11.7527676L3.1189604,17.000000999999997L0.35988006,17.000000999999997L6.7777414,10.1918821L0,2L5.6921029,2L9.6207924,6.7933583L14.22126,2ZM13.255582,15.505536L14.785071,15.505536L4.88837,3.4391145L3.2449181,3.4391145L13.255582,15.505536Z'%20fill='%23ffffff'%20fill-opacity='1'%20style='mix-blend-mode:passthrough'/%3e%3c/g%3e%3c/g%3e%3c/svg%3e)
'%3e%3cg%3e%3cg%3e%3cpath%20d='M17.776579953674315,4.238972914697266C18.530987953674316,2.8357112146972656,17.668764953674316,1.0000038146972656,17.668764953674316,1.0000038146972656C15.728984953674317,1.0000038146972656,14.327326953674316,2.2953194146972655,14.327326953674316,2.2953194146972655C13.572919953674317,1.8635447646972656,11.093512553674316,1.8635447646972656,11.093512553674316,1.8635447646972656C11.093512553674316,1.8635447646972656,8.614197253674316,1.8635447646972656,7.859790753674316,2.2953194146972655C7.859790753674316,2.2953194146972655,6.4587898536743165,1.0000038146972656,4.518257353674317,1.0000038146972656C4.518257353674317,1.0000038146972656,3.6561312536743165,2.8350313146972654,4.410538953674316,4.238972914697266C4.410538953674316,4.238972914697266,2.6862124236743163,5.858135714697266,3.332825653674316,9.312969214697265C3.9408041536743164,12.559363814697265,6.782133553674316,13.415479814697266,8.614197253674316,13.415479814697266C8.614197253674316,13.415479814697266,7.859790753674316,14.063154814697265,7.967603653674316,15.142524814697266C7.967603653674316,15.142524814697266,6.889853453674316,15.790198814697266,5.812196053674317,15.358415814697265C4.734538553674316,14.926723814697265,4.1956536536743165,13.847263814697266,4.1956536536743165,13.847263814697266C4.1956536536743165,13.847263814697266,3.1179590536743165,12.443964814697265,2.0402743556743164,12.983694814697266C2.0402743556743164,12.983694814697266,1.7169677936743164,13.307532814697266,2.9024282136743165,13.847263814697266C2.9024282136743165,13.847263814697266,3.7645722536743165,15.142524814697266,4.087878753674316,15.898144814697266C4.411195253674316,16.653767814697268,6.135446553674316,17.301444814697266,7.860446953674316,16.869661814697267L7.860446953674316,19.352327814697265C7.860446953674316,19.352327814697265,7.860446953674316,19.568219814697265,7.4293847536743165,19.676166814697265C6.998322453674317,19.784110814697264,6.998322453674317,20.000003814697266,7.213853853674316,20.000003814697266L14.974576953674317,20.000003814697266C15.190109953674316,20.000003814697266,15.190109953674316,19.784110814697264,14.759046953674316,19.676166814697265C14.327983953674316,19.568219814697265,14.327983953674316,19.352327814697265,14.327983953674316,19.352327814697265L14.327983953674316,16.869661814697267C14.327983953674316,16.869661814697267,14.337451953674316,15.575053814697265,14.327983953674316,15.142524814697266C14.304263953674317,14.057753814697266,13.573576953674316,13.415479814697266,13.573576953674316,13.415479814697266C15.405640953674316,13.415479814697266,18.246925953674317,12.559363814697265,18.854893953674317,9.312969214697265C19.501579953674316,5.858135714697266,17.777234953674316,4.238972914697266,17.776579953674315,4.238972914697266L17.776579953674315,4.238972914697266Z'%20fill='%23ffffff'%20fill-opacity='1'%20style='mix-blend-mode:passthrough'/%3e%3c/g%3e%3c/g%3e%3c/g%3e%3c/svg%3e)
