Documentation

AI

Unity's AI tools

Open Unity Dashboard

AI

Troubleshooting AI Generators for the Unity CLI

Solve common issues with AI Generators for the Unity CLI, such as failed setup checks and interrupted generations.
Read time 2 minutesLast updated 12 hours ago
When a 
unity ai
command doesn't work, use 
unity ai doctor
to find the cause and the fix.

Diagnose your setup

unity ai doctor
is free, read-only, and never prints your sign-in token. To run it:
unity ai doctor
The command checks the following items, and shows the command that fixes each failed check:
  • Unity CLI and 
    ai
    plugin installation, including available updates.
  • Sign-in and the organization in use.
  • Access to AI Generators for your organization, acceptance of the terms of service, and the Unity Credits balance.
  • Agent skill installation.
  • Preview prerequisites, such as Node.js.
  • Spending limits.
Fix the first failed check first, because later checks often depend on it. Then run 
unity ai doctor
again.
If you work through an AI agent, ask the agent to run 
unity ai doctor
. The agent can often fix the issue for you.

Fix command errors

Most errors include a code, a message, and the steps that fix them. If a generation fails after you submit it, the output says whether Unity might still charge you and how to save the result without paying again.
If you stop a command after it submits a generation, for example by pressing Ctrl+C, the generation keeps running and might still consume Unity Credits.
Don't run the same request again, because Unity charges for it again. To save the output without paying again, follow these steps:
  1. Find the job ID on the 
    submitted:
    line that the command printed.
  2. Run the 
    unity ai jobs status
    command that the output printed when you stopped the original command. For example:
    unity ai jobs status <job-id> --org <org-id> --model <model-id> --wait --out <path>

Additional resources