Skip to content

Cloud models

List the models you can run, with their prices, and run text or media models.

These commands follow the output contract: JSON when stdout is not a terminal, failures as JSON on stderr, and exit codes 0 to 6.

Generated from dexto 2.0.0-beta.0.

dexto cloud models list

List the models you can run, text and media, with their prices.

dexto cloud models list
Option What it does
--for <for> Recommend media models for what you want to make.
--type <type> Only models of this kind: text, image, video, audio, file.

JSON when stdout is not a terminal, failures as JSON on stderr, exit codes 0 to 6. Also takes the shared options below.

dexto cloud models get

Show a model: its kind, price, and what it takes.

dexto cloud models get <model>

JSON when stdout is not a terminal, failures as JSON on stderr, exit codes 0 to 6. Also takes the shared options below.

dexto cloud models run

Run any model. A text model replies to the prompt (or stdin); a media model is priced, confirmed, then run.

dexto cloud models run <model> [prompt...]
Option What it does
--data <data> The request body as JSON.
--file <file> Read the request body from a JSON file, or - for stdin.
--no-wait Start a media run and print its id instead of waiting for it.
--overwrite With --save-to, replace a file already there.
--save-to <save-to> Keep a media run's outputs as project files: a path, or a prefix ending in /.
--system <system> A system prompt, for a text model.
--yes Run a media model without confirming its estimated price. Pass it only once your person has agreed.

JSON when stdout is not a terminal, failures as JSON on stderr, exit codes 0 to 6. Also takes the shared options below.

dexto cloud models runs list

List recent media runs in the Cloud project.

dexto cloud models runs list
Option What it does
--after <after> Start after this cursor, from the previous page.
--limit <limit> How many to return.

JSON when stdout is not a terminal, failures as JSON on stderr, exit codes 0 to 6. Also takes the shared options below.

dexto cloud models runs get

Show a media run, its status and its outputs.

dexto cloud models runs get <run_id>

JSON when stdout is not a terminal, failures as JSON on stderr, exit codes 0 to 6. Also takes the shared options below.

Shared options

Commands on this page that follow the JSON contract take these.

Option What it does
--api-base-url <api-base-url> The API origin (default https://api.dexto.ai, or DEXTO_API_BASE_URL).
--api-key <api-key> Use this key instead of DEXTO_API_KEY or the saved sign-in.
--profile <profile> The saved sign-in to use for this run (or DEXTO_PROFILE); see dexto accounts list.
--project <project> The Cloud project to act in when you're signed in (or DEXTO_CLOUD_PROJECT).
--json Print JSON, failures included (on stderr). The default when stdout isn't a terminal.
--table Print tables for people even when stdout isn't a terminal.