Docs / Media

Generate media and manage assets with the SmallForce CLI

Search before generating so the request matches an enabled model:

smallforce media models search "animate a product photo" --modality video --json
smallforce media models get <endpointId> --json

Build the generation input from the returned schema. For a model with a normal prompt field:

smallforce media generate <endpointId> \
  --prompt "A ceramic mug on a clean studio table" \
  --wait \
  --out ./mug.png

For an image input, upload the local file and use the returned asset ID:

smallforce assets upload ./product.png --json
smallforce media generate <endpointId> \
  --image <assetId> \
  --input '<json-built-from-inputSchema>' \
  --wait \
  --out ./product-video.mp4

Generation is asynchronous. Without --wait, the command returns a job. Use media jobs list and media jobs get to inspect it later. An output path implies waiting and downloads completed output assets.

Do not place local file paths or guessed asset URLs inside model JSON. Use --image or repeatable --asset <field>=<assetId> mappings. See the complete media reference and assets reference.