Documentation

About AI Generators for the Unity CLI

Learn what AI Generators for the Unity CLI do, which platforms they support, how they charge Unity Credits, and how to use them with an AI agent.
Read time 3 minutesLast updated 10 hours ago

AI Generators for the Unity CLI are a set of
unity ai
commands that generate assets with Unity AI from Unity CLI. They ship as a Unity CLI plugin named
ai
, and Unity CLI handles the plugin's installation, updates, sign-in, and organization selection.
The recommended way to use the commands is through an AI agent, such as Claude, Codex, or Grok, because the agent chooses the commands and models for you. You can also run the commands yourself in a terminal.
Note
The following concerns a product or service (each a “Third Party Product”) that's not developed, owned, or operated by Unity. This information may not be up-to-date or complete, and is provided to you for your information and convenience only. Your access and use of any Third Party Product is governed solely by the terms and conditions of such Third Party Product. Unity makes no express or implied representations or warranties regarding such Third Party Products, and will not be responsible or liable, directly or indirectly, for any actual or alleged damage or loss arising from your use thereof (including damage or loss arising from any content, advertising, products or other materials on or available from the provider of any Third Party Products).

What you can do

You can use AI Generators for the Unity CLI to generate assets from a text prompt and, where the model supports them, input files and reference images. For example, you can generate images, sprites, textures, sound effects, 3D models, rigging and character motion, skyboxes, and video.
You can run each task yourself in a terminal, or ask an AI agent to run it for you. The following table compares the two options:

Task

In a terminal

With an AI agent

Choose a modelList the models available to your organization and what each model accepts.The agent reads the live model catalog and helps you choose the best model for your use case.
Check the costGet a quote with the estimated cost before you generate.The agent shows you the quote and asks for your approval, unless the generation fits spending limits or a budget you set.
Set spending limitsRun
unity ai consent set
.
Ask the agent to set your limits.
Generate assetsRun one generation command for each asset.The agent coordinates several generation steps in one flow, for example, a concept image converted to a rigged and animated 3D model.
Validate assetsValidate a generated asset to find defects before you use it in a Unity project.The agent validates each result before it replies to you, and offers to regenerate an asset that has a defect.
Preview assetsRun
unity ai preview
to inspect an asset outside a Unity project.
Ask the agent to open the asset in the previewer.
To find the current commands for each task, run
unity ai help
. To use an AI agent, install the agent skills that AI Generators for the Unity CLI include. These skills guide your agent through these workflows. For more information, refer to Get started with AI Generators for the Unity CLI.

Generated assets

The plugin saves each generated asset to a local file with a provenance record beside it. Generated assets aren't imported into a Unity project automatically. To use an asset, ask your agent to import it through Unity CLI into your project, or into a new project. You can also import it yourself through your usual Unity CLI or Unity Editor workflow.

Supported platforms

AI Generators for the Unity CLI run on the following platforms:
  • Windows (x64)
  • macOS (Apple silicon and Intel)
  • Linux (x64) with glibc 2.34 or later, for example, Ubuntu 22.04 or RHEL 9

Cost and spending limits

Each generation consumes Unity Credits from your organization. Before a generation runs, you receive a quote with its estimated cost and the organization that pays. Unity charges your organization only after you confirm the generation, or when the generation runs within spending limits you set. When the generation ends, a summary shows what Unity charged.
To avoid confirming every routine generation, you can set a spending limit per generation and per day. Generations within your limits run without a confirmation prompt, and generations that exceed them need your approval. Spending limits are especially useful when an AI agent runs generations for you. To set limits, refer to Get started with AI Generators for the Unity CLI.
For more information about Unity Credits, refer to About Unity Credits.

Additional resources