CLI

CLI examples

Cost-aware examples for common workflows.

Image

Example

truecut tool call estimate_generation_cost --json '{"kind":"t2i","model":"soul","params":{"aspect":"4:5"}}'
truecut generate image --json '{"prompt":"Editorial product portrait on warm limestone","aspect_ratio":"4:5"}'

Poll a result

Example

truecut generation get JOB_ID
truecut generation list --status succeeded --limit 10

Upload a local reference

Example

truecut media upload ./product.png --purpose product
# Use the returned HTTPS URL in a generation or workflow input

Uploads accept PNG, JPEG, WebP, MP4, MP3, and WAV files up to 50 MB. The endpoint authenticates with the CLI’s Bearer token and records the media in the connected account.

Use the complete tool surface

Example

truecut tools list
truecut tool call create_youtube_thumbnail --json '{"title":"I rebuilt my studio in 48 hours","direction":"high contrast creator documentary"}'