Asset id or public HTTPS URL? What Sume inputs accept
Sume generation fields take public HTTPS URLs directly. Localhost, private, non-HTTPS, signed URLs and wrong content types are rejected. When an asset id helps.

Pass a public HTTPS URL in the request field; you do not need to create an asset first. Sume's docs say launch generation requests accept media as public HTTPS URLs and that normal Avatar, face-swap and caption requests need no separate asset. Use an asset id only when your workflow needs the first-party asset lifecycle.
Everything here is from Media inputs and Jobs and media inputs, read 2026-09-30.
Which fields take a URL?
The exact fields are in the live OpenAPI schema; these are the ones the docs list.
| Workflow | Field |
|---|---|
| Avatar 1.0 photo input | input.image_url |
| Avatar Video product branch | product_image |
| Avatar Video scene photo | scene.image_url |
| Avatar Video image background | video_inputs[].background.url |
| Face swap (Beta) and captions | video_url |
Which URLs get rejected?
Localhost, private-network, non-HTTPS and signed or private URLs, and any whose content type does not match, are rejected before generation submission. The troubleshooting page adds a common cause: a URL that needs cookies or a short-lived signature that expires before Sume can fetch it. Related errors are image_not_fetchable and input_media_unreachable; check the URL is public HTTPS, then retry or contact support with the request id.
When is an asset id worth it?
When you want Sume-registered inputs you can list, get and download later. sume assets create --source-url <url> --confirm-submit registers from a public URL; the upload route is covered in the assets flow post. Both are write-gated.
What comes back as output?
Completed jobs list artifacts with an artf_ id, a media.sume.com URL, a type and a content type. Store the Sume URL, not raw provider URLs.
Sources
Related posts
More in Developers
- sume/auto video defaults: 720p, 8 seconds, 3 to 10 s at 16:9 or 9:16
Leave resolution and duration off a sume/auto video request and Sume uses 720p and 8 seconds. The Auto envelope is 3 to 10 seconds at 16:9 or 9:16.
- Install the Sume CLI in CI: checksums and pinned release tags
The hosted installer verifies checksums.txt and will not overwrite another sume on PATH. To pin, swap latest for a release tag such as v0.1.6.
- sume jobs watch timed out: recover the job before you resubmit
A local wait that times out does not cancel a paid Sume job. Inspect it with jobs status, events and result, then download, instead of submitting again.
- sume/video-1.0 and /v1/models/sume/video-1.0/runs: what they are
Video 1.0 is a retiring alias for Video Router Auto. Two URLs take the same body, the public id is sume/video-1.0, and receipts report sume/auto.
Written by Sume