---
title: Jobs and media inputs
description: Recover jobs, download artifacts, and register public HTTPS media inputs with the Sume CLI.
---

## Jobs

```bash
sume jobs list --agent --json
sume jobs get <job_id> --agent --json
sume jobs status <job_id> --agent --json
sume jobs events <job_id> --agent --json
sume jobs result <job_id> --agent --json
sume jobs watch <job_id>
sume jobs download <job_id> --output-dir ./out
sume jobs cancel <job_id> --confirm-submit
```

Use job recovery commands instead of resubmitting paid generation when a process
restarts or a local timeout occurs. `jobs watch` polls until terminal or
timeout; `jobs download` writes completed media artifacts into a local
directory.

These job helpers work for Avatar CLI submits **and** for Image/Video/Music jobs
you created via the [Developer API](/public-api).

## Assets

Register or upload first-party input assets when a workflow needs asset ids
instead of (or in addition to) bare public URLs:

```bash
sume assets list --agent --json
sume assets get <asset_id> --agent --json
sume assets create --source-url https://example.com/reference.png --confirm-submit
sume assets upload-url --content-type image/png --size-bytes 12345 --confirm-submit
sume assets complete <asset_id> --confirm-submit
sume assets download-url <asset_id>
sume assets download <asset_id> --output-dir ./assets
```

Inspect exact flags with `sume tools schema assets.create --json` and related
schemas. Prefer public HTTPS media URLs in generation payloads when you do not
need first-party asset lifecycle.

## Use media in Avatar generation

Avatar launch fields commonly accept public HTTPS URLs such as
`input.image_url`, `product_image`, and `scene.image_url`. For exact
request-body fields, inspect:

```bash
sume tools schema avatars.create --json
sume tools schema avatar-videos.create --json
```

For Image/Video/Music media fields, follow the model guides
([Image](/models/image), [Video](/models/video), [Music](/models/music)) — those
families are API-first from the CLI's perspective.