Models

Choose a model

Read the live catalog, match references to slots and quote the configured request.

Choose from the live catalog, not from a remembered model id or settings object. The catalog is account-aware and is the one contract shared by the web controls, MCP and the command line.

Read before creating

Call list_models and narrow by media kind when useful. Each available entry tells you:

  • what kind of asset it creates;
  • which settings it accepts and their bounds;
  • which reference slots it accepts;
  • what its configured request costs;
  • typical completion time and known failure codes.

Preview and unavailable entries say so. Do not select an unavailable entry or assume that a historical id still routes to a current model.

Match the intent

Start with the output you need. Use an image model for a still or image set, a video model for motion, and an audio model for speech, music or sound. Compare available models by the controls and reference slots the task needs, then use the catalog's default only when those needs do not choose for you.

References must fit named slots. For example, a video model may accept a start frame, an end frame or another video, while an image model may accept several images for subject or visual direction. list_models names the accepted kinds, minimums and maximums.

Quote the configured request

Call estimate_credits after choosing settings, references and quantity. The quote covers the request as configured, including duration or resolution rules. Show it to the person before calling create_asset.

On the web, Use current model prefills the recorded prompt, compatible settings and references against today's catalog. Use recorded model fixes the recorded provider model and inputs when that route remains configured. Through MCP or the CLI, pass from_asset_id and recipe_mode; an exact quote also requires space_id. Neither mode guarantees identical pixels.

Continue with the image, video or audio guide.