preview
ChatGPTUse this when showing generated Widemile media inline.
prostudio_asset_copy
ChatGPTCopy an agent-host attachment URL through Widemile's restricted remote-ingress service, persist it in Widemile storage, and attach it to the workspace. Use this for Claude/GPT attachments when the MCP server cannot access the user's local filesystem.
prostudio_asset_import
ChatGPTAttach an already-hosted durable image, video, audio, or music asset to a Widemile workspace so it can be used by references, generations, canvas, editor, and Previs. Temporary Fal/KIE provider URLs are rejected; use prostudio_asset_copy to mirror temporary agent/provider media first.
prostudio_asset_upload
ChatGPTUpload a local media file explicitly selected by the user from a trusted local stdio deployment. Remote HTTP/OAuth deployments reject filesystem access; use prostudio_asset_copy or prostudio_asset_upload_content there.
prostudio_asset_upload_content
ChatGPTUpload base64 media bytes supplied by a remote agent host, store a durable copy, and attach it to the workspace. Use when no temporary attachment URL is available; prefer prostudio_asset_copy for large media.
prostudio_audio_generate
ChatGPTExecute an approved voice or audio-design plan. Accepts only an immutable prepared plan and requires explicit user approval of that plan and its exact credit charge.
prostudio_brief_get
ChatGPTRead the canonical free-form Markdown Brief and its revision. The Brief is creative context only and has no compiled production schema.
prostudio_canvas_get
ChatGPTRead the versioned Widemile visual canvas, including items and their connections.
prostudio_canvas_save
ChatGPTReplace the Widemile canvas using optimistic concurrency.
prostudio_character_reference_prepare
ChatGPTValidate an agent-authored canonical character-reference prompt and agent-selected image parameters against the authoritative Widemile recipe, then persist the same immutable generation plan and exact credit charge used by all Widemile generations. Call prostudio_character_reference_spec_get first. This tool never authors or silently rewrites the prompt.
prostudio_character_reference_spec_get
ChatGPTRead the authoritative Widemile character-reference recipe before writing a character prompt. The connected agent remains responsible for the final prompt, model, and parameters.
prostudio_credits_balance
ChatGPTRead the connected user's available Widemile generation credits.
prostudio_editor_apply
ChatGPTApply a deterministic command batch to the Widemile timeline using optimistic concurrency. A batch may add, update, replace, split, reorder, or remove clips and tracks.
prostudio_editor_export
ChatGPTUse this when the user wants an MP4 of the current saved editor timeline. Exports exactly expectedVersion as a new workspace video; poll prostudio_job_status, then call preview with the completed media.
prostudio_editor_get
ChatGPTRead the versioned server-side Widemile editing timeline.
prostudio_editor_replace
ChatGPTReplace the complete Widemile editor timeline after validating it.
prostudio_generation_delete
ChatGPTPermanently delete a generation. Only its creator or the workspace owner can do this.
prostudio_generation_folder_set
ChatGPTMove a generation into a default or custom folder in its current workspace. Pass folderId=null to move it to the main workspace.
prostudio_generation_get
ChatGPTRead one durable image, video, audio, or music generation attached to a workspace.
prostudio_generation_move
ChatGPTMove a generation to another writable workspace, or unassign it by passing null. The media is preserved and can be reassigned later.
prostudio_generation_plan_cancel
ChatGPTCancel an unexecuted prepared generation plan.
prostudio_generation_plan_get
ChatGPTRead one immutable Widemile generation plan and its execution result.
prostudio_generation_plans_list
ChatGPTList recent immutable generation plans and their execution states for a workspace.
prostudio_generation_prepare
ChatGPTResolve optional creative context, memories, references, mode, compatible model, provider bindings, and exact credit charge; then persist an immutable plan for user approval. A Brief is optional and an empty Brief never blocks preparation. Return credits only, never a currency estimate. Reference media must be selected by stable reference or memory ids, never raw URLs.
prostudio_generation_price_estimate
ChatGPTReturn only the exact credit charge for a model and generation options without executing it. Never present a currency estimate.
prostudio_generation_share_link
ChatGPTCreate or reuse the public shared-generation URL for the preview app.
prostudio_generations_list
ChatGPTList durable image, video, audio, and music generations attached to a workspace.
prostudio_image_edit
ChatGPTCreate one active image version from the exact action returned by prostudio_image_edit_prepare. Poll asynchronous upscale or layer jobs with prostudio_job_status.
prostudio_image_edit_prepare
ChatGPTPrepare crop, 2x/4x upscale, or Automatic/1K/1.5K/2K layer separation for one completed image. Returns the exact action and credit charge; layer credits are a maximum authorization.
prostudio_image_generate
ChatGPTExecute an approved text-to-image, image-to-image, or outpaint plan. Accepts only an immutable prepared plan and requires explicit user approval of that plan and its exact credit charge.
prostudio_job_cancel
ChatGPTCancel a generic Widemile job only while it is queued or retry-scheduled, before provider work starts. Cancellation is a durable atomic race with the worker and releases reserved credits. Once processing starts, the API returns a conflict because the generic lifecycle has no reliable provider cancellation token; it never reports a false cancellation. Image-to-3D jobs use their dedicated cancel tool.
prostudio_job_status
ChatGPTPoll and reconcile an asynchronous video, audio-design, music, or 3D job. This may query the generation provider and persist the latest status or completed output; call preview when the durable output URL becomes available.
prostudio_location_reference_prepare
ChatGPTValidate an agent-authored canonical location-reference prompt and agent-selected image parameters against the authoritative Widemile recipe, then persist the same immutable generation plan and exact credit charge used by all Widemile generations. Call prostudio_location_reference_spec_get first. This tool never authors or silently rewrites the prompt.
prostudio_location_reference_spec_get
ChatGPTRead the authoritative Widemile location-reference recipe before writing a location prompt. The connected agent remains responsible for the final prompt, model, and parameters.
prostudio_memory_create
ChatGPTCreate a durable production entity with purpose, reference media, tags, and typed relationships to other entities.
prostudio_memory_delete
ChatGPTDelete one production memory entity.
prostudio_memory_list
ChatGPTList the durable semantic memory graph for characters, locations, products, props, wardrobe, styles, voices, music, shots, constraints, and relationships.
prostudio_memory_update
ChatGPTUpdate a production memory entity or disable it without losing its history.
prostudio_models_list
ChatGPTList normalized generation capabilities, modes, reference capacities, paired edit models, durations, and resolutions.
prostudio_music_edit
ChatGPTExecute one explicitly approved Suno music operation and save it as a new version of the selected source track.
prostudio_music_edit_prepare
ChatGPTPrepare one new music version by extending, replacing a section, restyling, adding vocals or instruments, or separating stems. Returns the normalized operation and exact credit charge without starting it.
prostudio_music_generate
ChatGPTExecute an approved music plan. Accepts only an immutable prepared plan and requires explicit user approval of that plan and its exact credit charge.
prostudio_prop_reference_prepare
ChatGPTValidate an agent-authored canonical prop-reference prompt and agent-selected image parameters against the authoritative Widemile recipe, then persist the same immutable generation plan and exact credit charge used by all Widemile generations. Call prostudio_prop_reference_spec_get first. This tool never authors or silently rewrites the prompt.
prostudio_prop_reference_spec_get
ChatGPTRead the authoritative Widemile prop-reference recipe before writing a prop prompt. The connected agent remains responsible for the final prompt, model, and parameters.
prostudio_reference_create
ChatGPTCreate one category-free reference from ordered durable image or video media. Prefer stable assetId values returned by asset or generation tools. Use tags only for organization; usage purpose belongs to the generation binding or optional Brief context.
prostudio_reference_delete
ChatGPTCompatibility operation for legacy references. Generic references are archived recoverably; prefer prostudio_reference_update with status archived.
prostudio_reference_update
ChatGPTCorrect the name, product description, or canonical image set of a workspace reference.
prostudio_references_list
ChatGPTList active category-free references and their ordered image or video media in a Widemile workspace.
prostudio_references_resolve
ChatGPTResolve explicit stable reference and memory ids with optional creative context, infer text/image/reference generation mode, select a compatible model, bind model tokens, and report blockers without silently dropping required references. A Brief is never required.
prostudio_shot_generation_set
ChatGPTAssign one completed workspace generation to an optional workflow step label, replace the current assignment, or clear it. The assignment is operational state outside the free-form Brief.
prostudio_surface_contract_get
ChatGPTDiscover the canonical document and command contract for canvas, editor, or Previs before mutating that surface.
prostudio_unassigned_generation_assign
ChatGPTAttach an unassigned generation owned by the connected user to a writable workspace.
prostudio_unassigned_generation_delete
ChatGPTPermanently delete an unassigned generation owned by the connected user and its owned stored media.
prostudio_unassigned_generation_get
ChatGPTRead one generation owned by the connected user that is not currently attached to a workspace.
prostudio_unassigned_generations_list
ChatGPTList durable generations owned by the connected user that are not currently attached to a workspace.
prostudio_upload_consent_accept
ChatGPTPersist the current user's explicit acceptance of the media-upload agreement. Call only after presenting every declaration returned by prostudio_upload_consent_get and receiving an unambiguous yes from the user; never infer or auto-accept consent.
prostudio_upload_consent_get
ChatGPTCheck whether the current user has accepted the Widemile media-upload agreement and return the exact declarations that must be presented before asking for consent.
prostudio_video_edit
ChatGPTExecute one explicitly approved composed video edit. Every requested trim, crop, color grade, film grain, caption style, and upscale is baked atomically into one new version of the source video.
prostudio_video_edit_prepare
ChatGPTPrepare one new video version containing any combination of trim, crop, cinematic color grading, physical film grain, automatic styled captions, and upscale. Returns the complete normalized edit and exact credit charge without starting it.
prostudio_video_generate
ChatGPTExecute an approved text-to-video, image-to-video, or multimodal reference-to-video plan. Accepts only an immutable prepared plan and requires explicit user approval of that plan and its exact credit charge.
prostudio_video_upscale
ChatGPTExecute an explicitly approved video upscale using the exact target and credit charge returned by prostudio_video_upscale_prepare.
prostudio_video_upscale_prepare
ChatGPTAnalyze an existing completed video in the selected workspace and return the exact target resolution and credit charge. This tool never starts the upscale.
prostudio_workspace_create
ChatGPTCreate a Widemile workspace backed by a Widemile creative project.
prostudio_workspace_delete
ChatGPTPermanently delete a Widemile workspace after explicit user confirmation.
prostudio_workspace_folder_create
ChatGPTCreate a custom organizational folder inside a writable Widemile workspace.
prostudio_workspace_folder_delete
ChatGPTDelete a custom Widemile workspace folder after explicit confirmation. Default Characters, Locations, and Props folders cannot be deleted. Assets in the deleted folder return to the main workspace and are not deleted.
prostudio_workspace_folder_rename
ChatGPTRename a custom Widemile workspace folder. Default Characters, Locations, and Props folders are protected and cannot be renamed.
prostudio_workspace_folders_list
ChatGPTList the default and custom folders in a Widemile workspace. A null folder id represents the main workspace when assigning an asset.
prostudio_workspace_get
ChatGPTGet one Widemile workspace by id.
prostudio_workspace_update
ChatGPTUpdate workspace name, description, thumbnail, or lifecycle status.
prostudio_workspaces_list
ChatGPTList one deterministic page of personal, organization, and shared Widemile workspaces. Continue with pagination.nextOffset while pagination.hasMore is true to retrieve the complete accessible set.