sume-generation

name	sume-generation
description	Use Sume generation tools to create image or video jobs, wait for completion, fetch results, and download safe media. Use when the user asks to generate new image or video assets from prompts or approved reference images.

Sume Generation

Use this skill for new image and video generation through Sume public API tools. Exact input fields come from sume tools schema.

Discovery

sume tools schema images.generate --json
sume tools schema videos.generate --json
sume tools schema jobs.get --json
sume tools schema jobs.result --json

For MCP clients:

sume mcp --toolsets generation --allow-paid
sume mcp --toolsets downloads --allow-write

Generation tools are paid/provider actions and must not be enabled by default.

Read references/generation-workflows.md before constructing paid generation requests.

Image Generation

sume images generate --prompt "clean product photo" --wait --json
sume images generate --prompt "product ad from brand reference" --reference-image-url "<brand_reference_url>" --wait --json

Use Brand reference_url values only when they are explicitly usable as references and the user authorized paid generation.

Video Generation

sume videos generate --prompt "short product video" --duration 4 --resolution 480p --wait --json

For smoke tests, prefer short duration and low resolution.

Async Results

For longer jobs, omit --wait, keep the returned job id, then poll and fetch result:

sume jobs get <job_id> --json
sume jobs result <job_id> --json

Use downloads only when the user wants files on disk:

sume jobs result <job_id> --download ./outputs/ --json

Do not curl media URLs manually.

Not For

Do not use this skill for Paid Ads, Face Swap, Reference Analysis, or Asset Library search. Use the focused skill for those workflows.