CLI

CLI examples

Cost-aware FoxCut CLI examples for common image, video, asset, and production workflows.

Image

Example

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

Poll a result

Example

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

Upload a local reference

Example

foxcut 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

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