Skip to main content
The agent gets most things right end-to-end, but if something is off, the fastest path is usually to try a quick manual fix in the editor before regenerating. Because every scene and asset is parametric, almost everything — joints, materials, dimensions, collision settings — is editable in the right-hand inspector after generation.

​
Joint Moves in the Wrong Direction in MuJoCo, Isaac Sim, or Gazebo

Try fixing it manually first — this is usually a 30-second adjustment.
  1. Select the problematic joint in the right-hand inspector.
  2. Compare the axis (X / Y / Z), anchor point, and limits against the convention in Joints and Physics.
  3. Flip the axis or adjust the anchor as needed.
  4. Re-export and re-test in the target simulator.
If the joint still behaves incorrectly after a manual axis fix, regenerate the asset with a more specific prompt about the articulation (e.g., “front-loading washing machine with circular door hinged on the left side”).

​
Joint Behaves Correctly in the Gizmo Preview but Incorrectly After Export

Re-export the scene first — the export pipeline may have been updated since the asset was generated. If the issue persists, regenerate the affected asset; older assets may predate specific joint-export fixes.

​
USD Opens but Joints or Bodies Look Wrong in Isaac Sim

Open the asset in Gizmo and check the inspector. If joints, masses, or collision shapes are present in Gizmo but missing in the export, re-export. If they are missing in Gizmo too, fix them manually in the inspector — add a joint, set mass, assign a collision approximation — and then re-export. Regenerate only if the asset is structurally too far off to repair.

​
MJCF Fails to Compile in MuJoCo

Re-export the scene first. If it still fails, the MuJoCo error usually points to a specific body or joint — open that part in the inspector and adjust the offending field (often a missing inertia, an out-of-range joint limit, or a collision shape that needs a different approximation). Regenerate as a last resort.

​
SDF Fails to Load in Gazebo

Re-export with the latest pipeline. Common issues: missing mesh references (re-export resolves this), unsupported joint types in older Gazebo versions, or sensor configuration mismatches. Check the Gazebo terminal output for specific element errors.

​
Glass Renders as Plastic (or Any Material Appears Wrong)

Open the asset, find the primitive in the inspector, and change its surface type or material directly. This is faster than regenerating for a small material correction. If many primitives are affected, regenerate the asset.

​
Generated Scene Looks Different from the Reference Image

Try editing in place first — move or rotate primitives, swap materials, or adjust dimensions in the inspector. If the issue is structural (missing components, incorrect overall layout), regenerate with a more detailed prompt that specifies counts, materials, and layout cues.

​
Asset Generation Seems Stuck

Long runs can take several minutes. Watch the stage progress in the editor — each stage prints a status update. If you see no progress for an extended period, refresh the page and retry the prompt.

​
API Returns 402 Insufficient Credits

Your generation credit balance is depleted. Add credits or upgrade your plan in Settings. The API will not start new generation jobs until credits are available.

​
API Returns 429 Rate Limit Exceeded

You’ve exceeded your per-key rate limit. Back off and retry after the X-RateLimit-Reset timestamp. Consider spreading requests across multiple keys if you need higher throughput.