> ## Documentation Index > Fetch the complete documentation index at: https://docs.adside.ai/llms.txt > Use this file to discover all available pages before exploring further. # Media > The 38 adside commands for Media. See [Using commands](https://docs.adside.ai/cli/commands.md) for how flags, JSON input, paging and confirmations work. Run `adside media --help` to see what your installed version has. ## media ### media recommend Recommend up to three models for a task described in plain words, with why, ready-to-use parameters, the price and the model family's prompting guide. Beta: this command may still change. ```bash theme={null} adside media recommend --task [flags] ``` | Flag | Value | | - | - | | `--task` (required) | `` | | `--type` | `image\|video` | | `--aspect-ratio` | `` | | `--duration` | `<1-30>` | | `--generate-audio` | `true\|false` | | `--inputs` | `''` | | `--max-price-usd` | `` | | `--priority` | `quality\|balanced\|cost` | ## media avatars ### media avatars cancel Cancel a talking avatar clip job; one a provider already accepted may still finish and is still charged. Beta: this command may still change. ```bash theme={null} adside media avatars cancel --job-id ``` ### media avatars estimate Price a talking avatar clip request without generating or charging. Beta: this command may still change. ```bash theme={null} adside media avatars estimate [flags] ``` | Flag | Value | What it does | | - | - | - | | `--input-image` | `''` | | | `--input-audio` | `''` | | | `--model` | `` | | | `--max-price-usd` | `` | | | `--prompt` | `` | | | `--image` | `` | The still that speaks: a local file (uploaded), an https URL or an asset ID | | `--character` | `` | A workspace character, instead of --image: its cover image speaks | | `--audio` | `` | The line it says, an MP3 or WAV: a local file (uploaded) or an asset ID | ### media avatars generate Generate one talking avatar clip, prepaying its estimate then settling measured cost; the same requestId returns the same job. Beta: this command may still change. ```bash theme={null} adside media avatars generate [flags] ``` | Flag | Value | What it does | | - | - | - | | `--input-image` | `''` | | | `--input-audio` | `''` | | | `--wait-seconds` | `<0-30>=0` | | | `--request-id` | `` | Submission identity (generated automatically if omitted) | | `--model` | `` | | | `--max-price-usd` | `` | | | `--prompt` | `` | | | `--image` | `` | The still that speaks: a local file (uploaded), an https URL or an asset ID | | `--character` | `` | A workspace character, instead of --image: its cover image speaks | | `--audio` | `` | The line it says, an MP3 or WAV: a local file (uploaded) or an asset ID | | `--wait` | | Wait for the job to finish, 30 s per request, up to --wait-timeout | | `--wait-timeout` | `` | How long --wait may take: 90s, 14m or seconds (default 15m) | | `--out` | `` | Download the finished output to a new file (never overwrites one) | ### media avatars get Read a talking avatar clip job, waiting up to waitSeconds for it to finish. Beta: this command may still change. ```bash theme={null} adside media avatars get --job-id [flags] ``` | Flag | Value | What it does | | - | - | - | | `--job-id` (required) | `` | | | `--wait-seconds` | `<0-30>=0` | | | `--wait` | | Wait for the job to finish, 30 s per request, up to --wait-timeout | | `--wait-timeout` | `` | How long --wait may take: 90s, 14m or seconds (default 15m) | | `--out` | `` | Download the finished output to a new file (never overwrites one) | ### media avatars models List the talking avatar clip models, what each is best for, its supported values and prices. Beta: this command may still change. ```bash theme={null} adside media avatars models ``` ## media images ### media images cancel Cancel an image job; one a provider already accepted may still finish and is still charged. Beta: this command may still change. ```bash theme={null} adside media images cancel --job-id ``` ### media images estimate Price an image request without generating or charging. Beta: this command may still change. ```bash theme={null} adside media images estimate --prompt [flags] ``` | Flag | Value | What it does | | - | - | - | | `--prompt` (required) | `` | | | `--model` | `` | | | `--max-price-usd` | `` | | | `--resolution` | `512\|768\|1K\|1.5K\|2K\|4K` | | | `--aspect-ratio` | `auto\|1:1\|2:3\|3:2\|3:4\|4:3\|4:5\|5:4\|9:16\|16:9\|21:9\|9:21\|1:2\|2:1\|1:4\|4:1\|1:8\|8:1` | | | `--input-references` | `''` | | | `--input-reference` (repeatable) | `` | A reference image: a local file (uploaded), an https URL or an asset ID (repeatable) | | `--character` (repeatable) | `` | A workspace character: its reference images, best first, as many as the model takes (repeatable) | ### media images generate Generate one image, prepaying its estimate then settling measured cost; the same requestId returns the same job. Beta: this command may still change. ```bash theme={null} adside media images generate --prompt [flags] ``` | Flag | Value | What it does | | - | - | - | | `--prompt` (required) | `` | | | `--wait-seconds` | `<0-30>=0` | | | `--request-id` | `` | Submission identity (generated automatically if omitted) | | `--model` | `` | | | `--max-price-usd` | `` | | | `--resolution` | `512\|768\|1K\|1.5K\|2K\|4K` | | | `--aspect-ratio` | `auto\|1:1\|2:3\|3:2\|3:4\|4:3\|4:5\|5:4\|9:16\|16:9\|21:9\|9:21\|1:2\|2:1\|1:4\|4:1\|1:8\|8:1` | | | `--input-references` | `''` | | | `--input-reference` (repeatable) | `` | A reference image: a local file (uploaded), an https URL or an asset ID (repeatable) | | `--character` (repeatable) | `` | A workspace character: its reference images, best first, as many as the model takes (repeatable) | | `--wait` | | Wait for the job to finish, 30 s per request, up to --wait-timeout | | `--wait-timeout` | `` | How long --wait may take: 90s, 14m or seconds (default 15m) | | `--out` | `` | Download the finished output to a new file (never overwrites one) | ### media images get Read an image job, waiting up to waitSeconds for it to finish. Beta: this command may still change. ```bash theme={null} adside media images get --job-id [flags] ``` | Flag | Value | What it does | | - | - | - | | `--job-id` (required) | `` | | | `--wait-seconds` | `<0-30>=0` | | | `--wait` | | Wait for the job to finish, 30 s per request, up to --wait-timeout | | `--wait-timeout` | `` | How long --wait may take: 90s, 14m or seconds (default 15m) | | `--out` | `` | Download the finished output to a new file (never overwrites one) | ### media images models List the image models, what each is best for, its supported values and prices. Beta: this command may still change. ```bash theme={null} adside media images models ``` ## media jobs ### media jobs list List the workspace's image, video, audio, avatar and lip-sync jobs, newest first. Beta: this command may still change. ```bash theme={null} adside media jobs list [flags] ``` | Flag | Value | What it does | | - | - | - | | `--type` | `image\|video\|speech\|sound\|music\|avatar\|lipsync` | | | `--status` | `pending\|in_progress\|completed\|failed\|cancelled\|expired` | | | `--cursor` | `` | The next page, from the previous output. | | `--limit` | `<1-50>=20` | | ## media lipsync ### media lipsync cancel Cancel a lip-sync clip job; one a provider already accepted may still finish and is still charged. Beta: this command may still change. ```bash theme={null} adside media lipsync cancel --job-id ``` ### media lipsync estimate Price a lip-sync clip request without generating or charging. Beta: this command may still change. ```bash theme={null} adside media lipsync estimate [flags] ``` | Flag | Value | What it does | | - | - | - | | `--input-video` | `''` | | | `--input-audio` | `''` | | | `--model` | `` | | | `--max-price-usd` | `` | | | `--video` | `` | The MP4 clip to re-voice: a local file (uploaded) or an asset ID | | `--audio` | `` | The line it says, an MP3 or WAV: a local file (uploaded) or an asset ID | ### media lipsync generate Generate one lip-sync clip, prepaying its estimate then settling measured cost; the same requestId returns the same job. Beta: this command may still change. ```bash theme={null} adside media lipsync generate [flags] ``` | Flag | Value | What it does | | - | - | - | | `--input-video` | `''` | | | `--input-audio` | `''` | | | `--wait-seconds` | `<0-30>=0` | | | `--request-id` | `` | Submission identity (generated automatically if omitted) | | `--model` | `` | | | `--max-price-usd` | `` | | | `--video` | `` | The MP4 clip to re-voice: a local file (uploaded) or an asset ID | | `--audio` | `` | The line it says, an MP3 or WAV: a local file (uploaded) or an asset ID | | `--wait` | | Wait for the job to finish, 30 s per request, up to --wait-timeout | | `--wait-timeout` | `` | How long --wait may take: 90s, 14m or seconds (default 15m) | | `--out` | `` | Download the finished output to a new file (never overwrites one) | ### media lipsync get Read a lip-sync clip job, waiting up to waitSeconds for it to finish. Beta: this command may still change. ```bash theme={null} adside media lipsync get --job-id [flags] ``` | Flag | Value | What it does | | - | - | - | | `--job-id` (required) | `` | | | `--wait-seconds` | `<0-30>=0` | | | `--wait` | | Wait for the job to finish, 30 s per request, up to --wait-timeout | | `--wait-timeout` | `` | How long --wait may take: 90s, 14m or seconds (default 15m) | | `--out` | `` | Download the finished output to a new file (never overwrites one) | ### media lipsync models List the lip-sync clip models, what each is best for, its supported values and prices. Beta: this command may still change. ```bash theme={null} adside media lipsync models ``` ## media music ### media music cancel Cancel a music track job; one a provider already accepted may still finish and is still charged. Beta: this command may still change. ```bash theme={null} adside media music cancel --job-id ``` ### media music estimate Price a music track request without generating or charging. Beta: this command may still change. ```bash theme={null} adside media music estimate --prompt [flags] ``` | Flag | Value | | - | - | | `--prompt` (required) | `` | | `--model` | `` | | `--max-price-usd` | `` | | `--duration` | `<3-600>` | | `--instrumental` | `true\|false` | ### media music generate Generate one music track, prepaying its estimate then settling measured cost; the same requestId returns the same job. Beta: this command may still change. ```bash theme={null} adside media music generate --prompt [flags] ``` | Flag | Value | What it does | | - | - | - | | `--prompt` (required) | `` | | | `--wait-seconds` | `<0-30>=0` | | | `--request-id` | `` | Submission identity (generated automatically if omitted) | | `--model` | `` | | | `--max-price-usd` | `` | | | `--duration` | `<3-600>` | | | `--instrumental` | `true\|false` | | | `--wait` | | Wait for the job to finish, 30 s per request, up to --wait-timeout | | `--wait-timeout` | `` | How long --wait may take: 90s, 14m or seconds (default 15m) | | `--out` | `` | Download the finished output to a new file (never overwrites one) | ### media music get Read a music track job, waiting up to waitSeconds for it to finish. Beta: this command may still change. ```bash theme={null} adside media music get --job-id [flags] ``` | Flag | Value | What it does | | - | - | - | | `--job-id` (required) | `` | | | `--wait-seconds` | `<0-30>=0` | | | `--wait` | | Wait for the job to finish, 30 s per request, up to --wait-timeout | | `--wait-timeout` | `` | How long --wait may take: 90s, 14m or seconds (default 15m) | | `--out` | `` | Download the finished output to a new file (never overwrites one) | ### media music models List the music track models, what each is best for, its supported values and prices. Beta: this command may still change. ```bash theme={null} adside media music models ``` ## media sounds ### media sounds cancel Cancel a sound effect job; one a provider already accepted may still finish and is still charged. Beta: this command may still change. ```bash theme={null} adside media sounds cancel --job-id ``` ### media sounds estimate Price a sound effect request without generating or charging. Beta: this command may still change. ```bash theme={null} adside media sounds estimate --prompt [flags] ``` | Flag | Value | | - | - | | `--prompt` (required) | `` | | `--model` | `` | | `--max-price-usd` | `` | | `--duration` | `<1-30>` | | `--loop` | `true\|false` | ### media sounds generate Generate one sound effect, prepaying its estimate then settling measured cost; the same requestId returns the same job. Beta: this command may still change. ```bash theme={null} adside media sounds generate --prompt [flags] ``` | Flag | Value | What it does | | - | - | - | | `--prompt` (required) | `` | | | `--wait-seconds` | `<0-30>=0` | | | `--request-id` | `` | Submission identity (generated automatically if omitted) | | `--model` | `` | | | `--max-price-usd` | `` | | | `--duration` | `<1-30>` | | | `--loop` | `true\|false` | | | `--wait` | | Wait for the job to finish, 30 s per request, up to --wait-timeout | | `--wait-timeout` | `` | How long --wait may take: 90s, 14m or seconds (default 15m) | | `--out` | `` | Download the finished output to a new file (never overwrites one) | ### media sounds get Read a sound effect job, waiting up to waitSeconds for it to finish. Beta: this command may still change. ```bash theme={null} adside media sounds get --job-id [flags] ``` | Flag | Value | What it does | | - | - | - | | `--job-id` (required) | `` | | | `--wait-seconds` | `<0-30>=0` | | | `--wait` | | Wait for the job to finish, 30 s per request, up to --wait-timeout | | `--wait-timeout` | `` | How long --wait may take: 90s, 14m or seconds (default 15m) | | `--out` | `` | Download the finished output to a new file (never overwrites one) | ### media sounds models List the sound effect models, what each is best for, its supported values and prices. Beta: this command may still change. ```bash theme={null} adside media sounds models ``` ## media speech ### media speech cancel Cancel a speech clip job; one a provider already accepted may still finish and is still charged. Beta: this command may still change. ```bash theme={null} adside media speech cancel --job-id ``` ### media speech estimate Price a speech clip request without generating or charging. Beta: this command may still change. ```bash theme={null} adside media speech estimate --text [flags] ``` | Flag | Value | | - | - | | `--text` (required) | `` | | `--model` | `` | | `--max-price-usd` | `` | | `--voice` | `` | | `--language-code` | `` | | `--stability` | `<0-1>` | | `--speed` | `<0.7-1.2>` | ### media speech generate Generate one speech clip, prepaying its estimate then settling measured cost; the same requestId returns the same job. Beta: this command may still change. ```bash theme={null} adside media speech generate --text [flags] ``` | Flag | Value | What it does | | - | - | - | | `--text` (required) | `` | | | `--wait-seconds` | `<0-30>=0` | | | `--request-id` | `` | Submission identity (generated automatically if omitted) | | `--model` | `` | | | `--max-price-usd` | `` | | | `--voice` | `` | | | `--language-code` | `` | | | `--stability` | `<0-1>` | | | `--speed` | `<0.7-1.2>` | | | `--wait` | | Wait for the job to finish, 30 s per request, up to --wait-timeout | | `--wait-timeout` | `` | How long --wait may take: 90s, 14m or seconds (default 15m) | | `--out` | `` | Download the finished output to a new file (never overwrites one) | ### media speech get Read a speech clip job, waiting up to waitSeconds for it to finish. Beta: this command may still change. ```bash theme={null} adside media speech get --job-id [flags] ``` | Flag | Value | What it does | | - | - | - | | `--job-id` (required) | `` | | | `--wait-seconds` | `<0-30>=0` | | | `--wait` | | Wait for the job to finish, 30 s per request, up to --wait-timeout | | `--wait-timeout` | `` | How long --wait may take: 90s, 14m or seconds (default 15m) | | `--out` | `` | Download the finished output to a new file (never overwrites one) | ### media speech models List the speech clip models, what each is best for, its supported values and prices. Beta: this command may still change. ```bash theme={null} adside media speech models ``` ## media videos ### media videos cancel Cancel a video job; one a provider already accepted may still finish and is still charged. Beta: this command may still change. ```bash theme={null} adside media videos cancel --job-id ``` ### media videos estimate Price a video request without generating or charging. Beta: this command may still change. ```bash theme={null} adside media videos estimate --prompt [flags] ``` | Flag | Value | What it does | | - | - | - | | `--prompt` (required) | `` | | | `--model` | `` | | | `--max-price-usd` | `` | | | `--duration` | `<1-30>` | | | `--resolution` | `480p\|720p\|768p\|1080p\|1K\|2K\|4K` | | | `--aspect-ratio` | `9:16\|16:9\|1:1\|4:3\|3:4\|3:2\|2:3\|21:9\|9:21` | | | `--frame-images` | `''` | | | `--generate-audio` | `true\|false` | | | `--first-frame` | `` | The clip's first frame: a local file (uploaded), an https URL or an asset ID | | `--last-frame` | `` | The clip's last frame, with --first-frame, for a model that takes one: a local file (uploaded), an https URL or an asset ID | ### media videos generate Generate one video clip, prepaying its estimate then settling measured cost; the same requestId returns the same job. Beta: this command may still change. ```bash theme={null} adside media videos generate --prompt [flags] ``` | Flag | Value | What it does | | - | - | - | | `--prompt` (required) | `` | | | `--wait-seconds` | `<0-30>=0` | | | `--request-id` | `` | Submission identity (generated automatically if omitted) | | `--model` | `` | | | `--max-price-usd` | `` | | | `--duration` | `<1-30>` | | | `--resolution` | `480p\|720p\|768p\|1080p\|1K\|2K\|4K` | | | `--aspect-ratio` | `9:16\|16:9\|1:1\|4:3\|3:4\|3:2\|2:3\|21:9\|9:21` | | | `--frame-images` | `''` | | | `--generate-audio` | `true\|false` | | | `--first-frame` | `` | The clip's first frame: a local file (uploaded), an https URL or an asset ID | | `--last-frame` | `` | The clip's last frame, with --first-frame, for a model that takes one: a local file (uploaded), an https URL or an asset ID | | `--wait` | | Wait for the job to finish, 30 s per request, up to --wait-timeout | | `--wait-timeout` | `` | How long --wait may take: 90s, 14m or seconds (default 15m) | | `--out` | `` | Download the finished output to a new file (never overwrites one) | ### media videos get Read a video job, waiting up to waitSeconds for it to finish. Beta: this command may still change. ```bash theme={null} adside media videos get --job-id [flags] ``` | Flag | Value | What it does | | - | - | - | | `--job-id` (required) | `` | | | `--wait-seconds` | `<0-30>=0` | | | `--wait` | | Wait for the job to finish, 30 s per request, up to --wait-timeout | | `--wait-timeout` | `` | How long --wait may take: 90s, 14m or seconds (default 15m) | | `--out` | `` | Download the finished output to a new file (never overwrites one) | ### media videos models List the video models, what each is best for, its supported values and prices. Beta: this command may still change. ```bash theme={null} adside media videos models ``` ## media voices ### media voices list List the stock voices a speech request may name, with what each suits and the models that offer it. Beta: this command may still change. ```bash theme={null} adside media voices list [flags] ``` | Flag | Value | | - | - | | `--model` | `` | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.