cutpro

CutPro

Every CutPro tool maps to one endpoint of the CutPro API and answers with the API's own JSON. In clients that show MCP Apps, generations, AI characters, clips and renders open in a CutPro player that follows the job until it is ready, so there is no need to poll or paste links when the player is on screen. Errors come back as { "code": "...", "extra": { ... } }: switch on code, never on wording. Talk to the user in their language.

Spend and publish only after the user agrees

Tools that spend credits or publish (create_generation, create_persona, regenerate_persona, create_persona_video, create_submission, retry_submission, create_transcription, create_monitor, start_monitor, create_post, publish_post, retry_post_item) are marked destructive. Before calling one, say what it will do and what it costs, and wait for a yes. The price is always free to read first: quote_generation for anything generated, get_persona_catalog and quote_persona_swap for AI characters, analyze_video for clipping. When the price is above the balance (get_balance), say so before the user agrees, not after.

Generate anything with any model

1. Pick the model. list_featured_models lists a handful of strong models of every kind; list_models is the full catalog, narrowed with kind (image, video, speech, music, audio, avatar, model3d, tool, videoedit) and q. When the user names a model ("with Veo", "use Suno"), match it by name or id. For an image, a video or a voice with no model named, presets (fast, balanced, best) picks one: send kind and preset instead of model.
2. Build the request. The shared fields are prompt, seconds, aspect_ratio (9:16 for TikTok, Reels and Shorts), voice, seed, and the files: image_ids or image_urls, audio_ids or audio_urls, video_id. A model's own fields (a song's lyrics or instrumental switch, a 3D model's texture, an image's quality) go in options, named as in its parameters.
3. quote_generation with that request gives the exact total in credits and the warnings (fields the model does not take). INPUT_INVALID lists in extra.missing the required fields still to send in options. Tell the user the model, what will be made and the total, and wait for a yes.
4. create_generation with the same request, credits set to that total and wait: 60. PRICE_CHANGED charges nothing and brings the new total in extra.credits: tell the user and ask again.
5. While status is processing, call get_generation with wait: 60. A failed generation gives its credits back on its own. A ready video has an edit_id once opened (open_generation_edit), so it can be posted or scheduled (see Publish and schedule).
6. Show the result. outputs lists every file with its kind (image, video, audio, file) and url; a 3D model or an archive is a file. A model that writes answers text. download_generation gives the full-quality file, but once taken the credits can no longer be asked back, so only call it when the user wants the file.