{ "compose_contract": { "default_quality_profile": "stable", "evaluation_mode": "full", "fixed_media_profiles": { "frontier": { "music": { "candidate_count": 3, "provider": "lyria" }, "narration": { "candidate_count": 3, "provider": "minimax" }, "reference": { "candidate_count": 1, "provider": "grok" } }, "stable": { "music": { "candidate_count": 2, "provider": "lyria" }, "narration": { "candidate_count": 2, "provider": "minimax" }, "reference": { "candidate_count": 1, "provider": "grok" } } }, "implementation_dependencies": [ { "activation": "always", "billing": "root_fee", "role": "planning_and_text_evaluation", "scope": "runtime_managed", "selectable": false }, { "activation": "quality_profile", "billing": "child_itemized", "role": "media_evaluation", "scope": "runtime_managed", "selectable": false }, { "activation": "requested_step", "billing": "child_itemized", "role": "narration_presence_transcription", "scope": "runtime_managed", "selectable": false } ], "narration_limits": { "script_codepoints": 12000, "segment_entries": 15, "segment_text_codepoints": 2000, "total_codepoints": 12000 }, "output_implementations": [ { "billing": "child_itemized", "provider": "grok", "role": "visual_generation", "selectable": false }, { "billing": "child_itemized", "provider": "minimax", "role": "narration_generation", "selectable": false }, { "billing": "child_itemized", "provider": "lyria", "role": "music_generation", "selectable": false }, { "billing": "platform", "provider": "soundside.ai", "role": "deterministic_rendering", "selectable": false } ], "provider_attempts": { "ges_rounds": 1, "narration_transcription_attempts": 1 }, "quality_delivery": { "final_verified_degraded_only": true, "intermediate_stages": "fail_closed" }, "reassembly": { "explicit_shape": "all_segment_indices_exactly", "parent_shape": "exactly_one_alias_and_plan_empty", "revision_reuse": "proper_subset_only" }, "reference_generation": { "candidate_count": 1, "provider": "grok", "rounds": 1, "source": "explicit_cast_only" } }, "contract_version": "1.0", "counts": { "authenticated_credit_only_tools": 1, "free_tools": 1, "pro_tools": 19, "provider_implementations": 19, "x402_eligible_tools": 17 }, "deprecations": [ { "removal_contract_version": "2.0", "replacement": { "arguments": { "analysis_type": "transcribe" }, "tool": "analyze_media" }, "selector": { "mode": "transcribe" }, "tool": "create_audio" } ], "lane_projection_sha256": "a9eb272c31ee7a95dd2d0b290a3127a6198f249555ee203c4d48a627348322b3", "pricing_policy": { "compose_child_calls_itemized": true, "compose_orchestration_success_credits": 5, "credit_usd": "0.01", "platform_margin": "approximately 10% unless a tool-specific flat fee is listed" }, "provider_mode_matrix": [ { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "vision_qa" ], "provider": "anthropic", "tool": "analyze_media" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "vision_qa" ], "provider": "grok", "tool": "analyze_media" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "vision_qa" ], "provider": "openai", "tool": "analyze_media" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "vision_qa" ], "provider": "qwen", "tool": "analyze_media" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "technical", "detect_segments", "export_edl" ], "provider": "soundside.ai", "tool": "analyze_media" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "transcribe", "vision_qa" ], "provider": "vertex", "tool": "analyze_media" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "ken_burns", "speed_ramp", "film_grain", "vignette" ], "provider": "soundside.ai", "tool": "apply_effect" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "add_text", "overlay", "split_screen" ], "provider": "soundside.ai", "tool": "compose_media" }, { "auth_lanes": [ "authenticated_credits" ], "modes": [ "stable", "frontier" ], "provider": "grok", "tool": "compose_video" }, { "auth_lanes": [ "authenticated_credits" ], "modes": [ "music" ], "provider": "lyria", "tool": "compose_video" }, { "auth_lanes": [ "authenticated_credits" ], "modes": [ "narration" ], "provider": "minimax", "tool": "compose_video" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "document" ], "provider": "docx", "tool": "create_artifact" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "presentation" ], "provider": "gamma", "tool": "create_artifact" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "diagram" ], "provider": "mermaid", "tool": "create_artifact" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "chart" ], "provider": "plotly", "tool": "create_artifact" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "presentation" ], "provider": "pptx", "tool": "create_artifact" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "document" ], "provider": "weasyprint", "tool": "create_artifact" }, { "auth_lanes": [ "authenticated_credits" ], "modes": [ "tts", "sound_effect" ], "provider": "creative_freedom", "tool": "create_audio" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "tts" ], "provider": "grok", "tool": "create_audio" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "tts", "voice_clone", "voice_design", "list_voices" ], "provider": "minimax", "tool": "create_audio" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "tts", "sound_effect" ], "provider": "runway", "tool": "create_audio" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "tts", "transcribe" ], "provider": "vertex", "tool": "create_audio" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "text_to_image", "image_edit" ], "provider": "alibaba", "tool": "create_image" }, { "auth_lanes": [ "authenticated_credits" ], "modes": [ "text_to_image", "image_edit" ], "provider": "creative_freedom", "tool": "create_image" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "text_to_image", "image_edit" ], "provider": "grok", "tool": "create_image" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "text_to_image", "image_edit" ], "provider": "minimax", "tool": "create_image" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "text_to_image" ], "provider": "vertex", "tool": "create_image" }, { "auth_lanes": [ "authenticated_credits" ], "modes": [ "generate" ], "provider": "creative_freedom", "tool": "create_music" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "generate" ], "provider": "lyria", "tool": "create_music" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "chat" ], "provider": "grok", "tool": "create_text" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "chat" ], "provider": "minimax", "tool": "create_text" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "chat" ], "provider": "qwen", "tool": "create_text" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "chat" ], "provider": "vertex", "tool": "create_text" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "text_to_video", "image_to_video", "first_last_frame", "reference_to_video", "multi_image_reference", "video_repainting", "local_edit", "video_extension", "frame_expansion", "digital_human", "image_to_action", "character_swap", "lip_replacement" ], "provider": "alibaba", "tool": "create_video" }, { "auth_lanes": [ "authenticated_credits" ], "modes": [ "text_to_video" ], "provider": "creative_freedom", "tool": "create_video" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "text_to_video", "image_to_video", "reference_to_video", "video_edit", "video_extension" ], "provider": "grok", "tool": "create_video" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "text_to_video", "image_to_video", "first_last_frame", "subject_reference" ], "provider": "minimax", "tool": "create_video" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "text_to_video", "image_to_video", "video_extension" ], "provider": "vertex", "tool": "create_video" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "mix_audio", "replace_audio", "pad_audio" ], "provider": "soundside.ai", "tool": "edit_audio" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "trim", "concat", "crossfade", "adjust_speed", "loop", "color_grade", "custom", "burn_subtitles" ], "provider": "soundside.ai", "tool": "edit_video" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "extract_frame", "extract_frames", "extract_audio" ], "provider": "soundside.ai", "tool": "extract_media" }, { "auth_lanes": [ "free", "authenticated_credits" ], "modes": [ "projects", "collections", "resources", "lineage", "brand_kits", "credits", "dashboard" ], "provider": "soundside.ai", "tool": "lib_list" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "create", "update", "delete", "upload_initiate", "upload_complete" ], "provider": "soundside.ai", "tool": "lib_manage" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "share", "list", "revoke" ], "provider": "soundside.ai", "tool": "lib_share" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "list" ], "provider": "soundside.ai", "tool": "list_adapters" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "inspect", "deploy", "undeploy", "delete", "select_checkpoint" ], "provider": "soundside.ai", "tool": "manage_adapter" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "train" ], "provider": "dashscope", "tool": "train_adapter" }, { "auth_lanes": [ "authenticated_credits", "x402" ], "modes": [ "train" ], "provider": "modal", "tool": "train_adapter" } ], "public_tier": "pro", "sets": { "authenticated_credit_only_tools": [ "compose_video" ], "free_tools": [ "lib_list" ], "pro_tools": [ "analyze_media", "apply_effect", "compose_media", "compose_video", "create_artifact", "create_audio", "create_image", "create_music", "create_text", "create_video", "edit_audio", "edit_video", "extract_media", "lib_list", "lib_manage", "lib_share", "list_adapters", "manage_adapter", "train_adapter" ], "x402_eligible_tools": [ "analyze_media", "apply_effect", "compose_media", "create_artifact", "create_audio", "create_image", "create_music", "create_text", "create_video", "edit_audio", "edit_video", "extract_media", "lib_manage", "lib_share", "list_adapters", "manage_adapter", "train_adapter" ] }, "tool_schema_sha256": "f05118bfc57677cc545e175dad5541ad5c5361fc75907e368bf04e1f10a06ce5", "tools": [ { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false, "title": "Analyze Media" }, "category": "analysis", "description": "Analyze media: technical metadata, vision_qa, transcribe, detect_segments, export_edl.", "execution": "sync", "inputSchema": { "properties": { "analysis_type": { "default": "technical", "description": "Analysis type", "enum": [ "technical", "vision_qa", "transcribe", "detect_segments", "export_edl" ], "title": "Analysis Type", "type": "string" }, "context": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Content context for detection", "title": "Context" }, "criteria": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "vision_qa evaluation criteria", "title": "Criteria" }, "enable_diarization": { "default": false, "description": "Speaker identification", "title": "Enable Diarization", "type": "boolean" }, "enable_silence_detection": { "default": false, "description": "Silence markers", "title": "Enable Silence Detection", "type": "boolean" }, "eval_model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Model override for eval", "title": "Eval Model" }, "eval_provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Eval LLM: vertex, grok, anthropic, openai", "title": "Eval Provider" }, "evaluation_context": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Eval context: style, purpose, audience", "title": "Evaluation Context" }, "format": { "const": "cmx3600", "default": "cmx3600", "description": "EDL format", "title": "Format", "type": "string" }, "frame_rate": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Frame rate override", "title": "Frame Rate" }, "generation_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Original generation prompt for fidelity eval", "title": "Generation Prompt" }, "include_audio": { "default": true, "description": "Include audio in EDL", "title": "Include Audio", "type": "boolean" }, "include_word_timestamps": { "default": true, "description": "Word-level timestamps", "title": "Include Word Timestamps", "type": "boolean" }, "intent_checklist": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "vision_qa spec checklist: text_overlays, no_pillarboxing, expected_resolution, etc.", "title": "Intent Checklist" }, "language_code": { "default": "en-US", "description": "Transcription language", "title": "Language Code", "type": "string" }, "max_segments": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Max keep-ranges", "title": "Max Segments" }, "merge_gap_sec": { "default": 2.0, "description": "Merge gap threshold", "title": "Merge Gap Sec", "type": "number" }, "min_segment_sec": { "default": 3.0, "description": "Min segment duration", "title": "Min Segment Sec", "type": "number" }, "mode": { "default": "keep", "description": "Segment detection mode", "enum": [ "keep", "remove" ], "title": "Mode", "type": "string" }, "padding_sec": { "default": 0.5, "description": "Cut point padding", "title": "Padding Sec", "type": "number" }, "prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "detect_segments criteria", "title": "Prompt" }, "reel_name": { "default": "SOURCE", "description": "Source reel name (max 8 chars)", "title": "Reel Name", "type": "string" }, "reference_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Prompt for vision_qa or detect_segments fallback", "title": "Reference Prompt" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Resource ID or URL", "title": "Resource Id" }, "scoring_rubric": { "anyOf": [ { "additionalProperties": { "type": "string" }, "type": "object" }, { "type": "null" } ], "default": null, "description": "Custom vision_qa rubric: {dimension: description}, scored 1-5.", "title": "Scoring Rubric" }, "segments": { "anyOf": [ { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Inline keep-ranges for export_edl", "title": "Segments" }, "segments_resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Persisted segments for export_edl", "title": "Segments Resource Id" }, "silence_threshold_sec": { "default": 1.0, "description": "Min silence gap (seconds)", "title": "Silence Threshold Sec", "type": "number" }, "subtitle_formats": { "anyOf": [ { "items": { "enum": [ "srt", "vtt" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Subtitle formats to persist", "title": "Subtitle Formats" }, "title": { "default": "SOUNDSIDE_CUT", "description": "EDL title", "title": "Title", "type": "string" }, "transcript_resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Existing transcript to reuse", "title": "Transcript Resource Id" } }, "title": "analyze_mediaArguments", "type": "object" }, "name": "analyze_media", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "anthropic", "grok", "openai", "qwen", "soundside.ai", "vertex" ] }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false, "title": "Apply Effect" }, "category": "editing", "description": "Cinematic effects: ken_burns (image→video motion), speed_ramp, film_grain, vignette. Returns resource_id.", "execution": "sync", "inputSchema": { "properties": { "action": { "description": "Effect", "enum": [ "ken_burns", "speed_ramp", "film_grain", "vignette" ], "title": "Action", "type": "string" }, "ai_enhance": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "description": "AI subject tracking (GPU)", "title": "Ai Enhance" }, "collection_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Collection UUID", "title": "Collection Id" }, "duration_sec": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Duration (ken_burns)", "title": "Duration Sec" }, "easing": { "anyOf": [ { "enum": [ "linear", "ease_in_out_sine", "ease_out_cubic", "ease_in_out_cubic" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Easing curve", "title": "Easing" }, "fps": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "FPS", "title": "Fps" }, "grain_intensity": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Grain 1-100 (increases file size)", "title": "Grain Intensity" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Filename", "title": "Name" }, "pan_direction": { "anyOf": [ { "enum": [ "center", "left_to_right", "right_to_left", "top_to_bottom", "bottom_to_top", "documentary", "dramatic", "reveal", "static" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Pan direction", "title": "Pan Direction" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Project UUID", "title": "Project Id" }, "provider": { "const": "soundside.ai", "default": "soundside.ai", "description": "Provider", "title": "Provider", "type": "string" }, "resolution": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Output WxH", "title": "Resolution" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Source resource ID", "title": "Resource Id" }, "speed_end": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "End speed 0.25-4.0", "title": "Speed End" }, "speed_start": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Start speed 0.25-4.0", "title": "Speed Start" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Tags", "title": "Tags" }, "vignette_angle": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Vignette angle (radians)", "title": "Vignette Angle" }, "zoom_end": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "End zoom (ken_burns)", "title": "Zoom End" }, "zoom_start": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Start zoom (ken_burns)", "title": "Zoom Start" } }, "required": [ "action" ], "title": "apply_effectArguments", "type": "object" }, "name": "apply_effect", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "soundside.ai" ] }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false, "title": "Compose Media" }, "category": "editing", "description": "Layer text, images, or video onto a base video: add_text, overlay, split_screen. Returns resource_id.", "execution": "sync", "inputSchema": { "properties": { "action": { "description": "Compositing action", "enum": [ "add_text", "overlay", "split_screen" ], "title": "Action", "type": "string" }, "collection_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Collection UUID", "title": "Collection Id" }, "fontcolor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Font color", "title": "Fontcolor" }, "fontsize": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Font size", "title": "Fontsize" }, "gap": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Panel gap (px)", "title": "Gap" }, "labels": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Panel labels", "title": "Labels" }, "layout": { "anyOf": [ { "enum": [ "horizontal", "vertical", "grid" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Split-screen layout", "title": "Layout" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Filename", "title": "Name" }, "overlay_border": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Overlay border (px)", "title": "Overlay Border" }, "overlay_opacity": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Overlay opacity 0-1", "title": "Overlay Opacity" }, "overlay_position": { "anyOf": [ { "enum": [ "top_left", "top_right", "bottom_left", "bottom_right", "center" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Overlay position", "title": "Overlay Position" }, "overlay_scale": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Overlay scale 0.1-0.9", "title": "Overlay Scale" }, "overlay_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Overlay resource ID", "title": "Overlay Source" }, "position": { "anyOf": [ { "enum": [ "top", "bottom", "center", "top_left", "top_right", "bottom_left", "bottom_right" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Named text position", "title": "Position" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Project UUID", "title": "Project Id" }, "provider": { "const": "soundside.ai", "default": "soundside.ai", "description": "Provider", "title": "Provider", "type": "string" }, "resolution": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Output resolution WxH", "title": "Resolution" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Source resource ID", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Multi-source IDs (split_screen)", "title": "Resource Ids" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Tags", "title": "Tags" }, "text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Text to overlay", "title": "Text" }, "text_end_sec": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Text disappear time", "title": "Text End Sec" }, "text_overlays": { "anyOf": [ { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Batch text overlays list (alternative to single text param)", "title": "Text Overlays" }, "text_start_sec": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Text appear time", "title": "Text Start Sec" }, "x": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Text X position (px)", "title": "X" }, "y": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Text Y position (px)", "title": "Y" } }, "required": [ "action" ], "title": "compose_mediaArguments", "type": "object" }, "name": "compose_media", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "soundside.ai" ] }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false, "title": "Compose Video" }, "category": "composition", "description": "Compose a complete video from a timeline plan.\n\nAccepts a plan (sparse brief or detailed timeline), enriches it, generates assets in parallel, and assembles with transitions, audio mix, and overlays. Auto-creates a project/collection if none provided.\n\nPlans: minimal (just brief+style), moderate (segment outlines), or detailed (providers, prompts, timing). Server fills gaps.\n\nAsync: returns pending resource_id. Poll with lib_list or await MCP notification.\n\nRevision: pass reuse_segments mapping indices to prior resource_ids (from metadata.composition.segment_resources). Only changed segments regenerate.\n\nRevise (sugar): pass revise_from= with plan={} and regenerate=[indices]. The server rebuilds the plan and reuse map from the parent's durable checkpoint (owner-only): every segment NOT listed in regenerate reuses the parent's clip, and the parent's monolithic narration/music carry over as supplied audio. regenerate=[] (or omitted) re-assembles the parent as-is — every segment reuses, carried audio, full QA + publication; this is the recovery path for a FAILED own parent whose segments all completed. Optional segment_overrides edits regenerated segments (prompt, duration_sec, motion_intensity, camera_position) and requires a non-empty regenerate. The manual reuse_segments path above remains the low-level alternative.\n\nReassemble-only: set reassemble_only=true with ALL segment IDs in reuse_segments and the prior enriched timeline as plan. Skips planning/generation and runs the same assembly+QA publication gate.\n", "execution": "pending", "inputSchema": { "$defs": { "RevisionSegmentOverride": { "additionalProperties": false, "description": "Per-segment edits applied to a regenerated segment of a revision.\n\nSubclasses ``ComposePlanModel`` so the advertised JSON schema carries\n``additionalProperties: false`` — unknown override keys are rejected with a\npydantic path, matching the recursive strictness of authored plans. The\n``duration_sec`` field bound mirrors ``SegmentSpec`` (1-30); the generative\n``MAX_SEGMENT_DURATION`` bound stays enforced solely by the shared\n``CompositionPlan`` parse that bounds every authored plan, so the error\ntext never diverges.", "properties": { "camera_position": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Replacement camera position, e.g. 'wide'.", "title": "Camera Position" }, "duration_sec": { "anyOf": [ { "maximum": 30.0, "minimum": 1.0, "type": "number" }, { "type": "null" } ], "default": null, "description": "Replacement duration in seconds. Generative segments are bounded by MAX_SEGMENT_DURATION=15.0s by the plan parse.", "title": "Duration Sec" }, "motion_intensity": { "anyOf": [ { "enum": [ "low", "medium", "high" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Replacement motion intensity.", "title": "Motion Intensity" }, "prompt": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ], "default": null, "description": "Replacement generation prompt for this regenerated segment. Becomes the authored starting point (the parent's refined prompt for this index is discarded).", "title": "Prompt" } }, "title": "RevisionSegmentOverride", "type": "object" } }, "additionalProperties": false, "properties": { "allow_degraded_output": { "default": false, "description": "Allow only a complete, non-vetoed final semantic panel that misses its score threshold to publish as verified_degraded. Intermediate, mechanical, missing-panel, and veto failures remain fail-closed.", "title": "Allow Degraded Output", "type": "boolean" }, "brand": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Brand kit name for styling.", "title": "Brand" }, "collection_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Caller-owned collection UUID. Must belong to the selected project.", "title": "Collection Id" }, "collection_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Override auto-generated collection name.", "title": "Collection Name" }, "evaluation_mode": { "const": "full", "default": "full", "description": "Required value 'full': run the complete supported evaluation and delivery gate.", "title": "Evaluation Mode", "type": "string" }, "image_candidates": { "default": 3, "description": "Image candidates per segment (1-6, default 3).", "maximum": 6, "minimum": 1, "title": "Image Candidates", "type": "integer" }, "parent_resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "reassemble_only: reassemble from this parent composition's checkpoint (owner-only; supplies segments + reuse map + audio from metadata.composition).", "title": "Parent Resource Id" }, "plan": { "additionalProperties": false, "description": "Composition plan: sparse (brief+style) or detailed (segments, audio, overlays).", "properties": { "audio": { "anyOf": [ { "additionalProperties": false, "description": "Audio tracks configuration.", "properties": { "ducking": { "anyOf": [ { "additionalProperties": false, "description": "Sidechain compression config for automatic audio ducking.\n\nWhen speech (narration/dialogue) co-exists with background audio\n(music/source), sidechaincompress automatically reduces background\nvolume during speech and restores it during pauses.", "properties": { "attack_ms": { "default": 200.0, "description": "Attack time in ms (how fast ducking engages)", "maximum": 1000.0, "minimum": 10.0, "title": "Attack Ms", "type": "number" }, "enabled": { "default": true, "description": "Enable sidechain ducking", "title": "Enabled", "type": "boolean" }, "knee_db": { "default": 2.5, "description": "Soft knee width in dB (higher = more gradual transition)", "maximum": 10.0, "minimum": 0.0, "title": "Knee Db", "type": "number" }, "music_ratio": { "default": 4.0, "description": "Compression ratio for music under speech (4.0 = reduce by 75%)", "maximum": 20.0, "minimum": 1.5, "title": "Music Ratio", "type": "number" }, "release_ms": { "default": 1000.0, "description": "Release time in ms (how fast background returns after speech)", "maximum": 5000.0, "minimum": 100.0, "title": "Release Ms", "type": "number" }, "source_ratio": { "default": 6.0, "description": "Compression ratio for source audio under speech (higher = harder duck)", "maximum": 20.0, "minimum": 1.5, "title": "Source Ratio", "type": "number" }, "threshold_db": { "default": -34.0, "description": "Speech detection threshold in dB (lower = more sensitive)", "maximum": -6.0, "minimum": -60.0, "title": "Threshold Db", "type": "number" } }, "title": "DuckingConfig", "type": "object" }, { "type": "null" } ], "default": null }, "music": { "anyOf": [ { "additionalProperties": false, "description": "Background music configuration.", "properties": { "fade_out_sec": { "default": 2.0, "maximum": 10.0, "minimum": 0.0, "title": "Fade Out Sec", "type": "number" }, "prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Prompt" }, "provider": { "anyOf": [ { "const": "lyria", "type": "string" }, { "type": "null" } ], "default": null, "description": "Generation provider. Omit for supplied music; generated music is Lyria-only.", "title": "Provider" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Resource Id" }, "volume_db": { "default": -18, "maximum": 0, "minimum": -30, "title": "Volume Db", "type": "integer" } }, "title": "MusicSpec", "type": "object" }, { "type": "null" } ], "default": null }, "narration": { "anyOf": [ { "additionalProperties": false, "description": "Narration audio configuration.\n\nTwo modes:\n- monolithic (default): single narration track from `script`, starts at t=0\n- per_segment: individual TTS clips per segment from `segments` list,\n each mixed at its segment offset. Duration is elastic — segment video\n must be at least as long as its narration.", "properties": { "mode": { "default": "monolithic", "enum": [ "monolithic", "per_segment" ], "title": "Mode", "type": "string" }, "provider": { "anyOf": [ { "const": "minimax", "type": "string" }, { "type": "null" } ], "default": null, "description": "Generation provider. Omit for supplied narration; generated narration is MiniMax-only.", "title": "Provider" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Resource Id" }, "script": { "anyOf": [ { "maxLength": 12000, "type": "string" }, { "type": "null" } ], "default": null, "title": "Script" }, "segments": { "anyOf": [ { "items": { "additionalProperties": false, "description": "Narration or dialogue for a single segment in per-segment mode.", "properties": { "cast_member": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Name of the cast member speaking this dialogue (for voice casting)", "title": "Cast Member" }, "delay_sec": { "default": 0.5, "description": "Offset from segment start before this audio plays", "maximum": 10.0, "minimum": 0.0, "title": "Delay Sec", "type": "number" }, "role": { "default": "narrator", "enum": [ "narrator", "dialogue" ], "title": "Role", "type": "string" }, "segment_index": { "minimum": 0, "title": "Segment Index", "type": "integer" }, "text": { "maxLength": 2000, "minLength": 1, "title": "Text", "type": "string" }, "voice_id": { "anyOf": [ { "enum": [ "Friendly_Person", "Deep_Voice_Man", "Wise_Woman", "Calm_Woman", "Lively_Girl", "Casual_Guy", "Patient_Man", "Young_Knight", "Determined_Man", "Elegant_Man" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Voice Id" } }, "required": [ "segment_index", "text" ], "title": "SegmentNarration", "type": "object" }, "maxItems": 15, "type": "array" }, { "type": "null" } ], "default": null, "title": "Segments" }, "speed": { "default": 1.0, "maximum": 2.0, "minimum": 0.5, "title": "Speed", "type": "number" }, "voice_id": { "anyOf": [ { "enum": [ "Friendly_Person", "Deep_Voice_Man", "Wise_Woman", "Calm_Woman", "Lively_Girl", "Casual_Guy", "Patient_Man", "Young_Knight", "Determined_Man", "Elegant_Man" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Voice Id" }, "volume_db": { "anyOf": [ { "maximum": 10, "minimum": -10, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Volume Db" } }, "title": "NarrationSpec", "type": "object" }, { "type": "null" } ], "default": null }, "normalize_source_audio": { "default": true, "description": "Apply EBU R128 loudness normalization (ffmpeg `loudnorm`) to each segment's retained provider audio BEFORE `source_audio_volume` scaling, so segments reach a consistent perceived loudness regardless of how the source provider recorded them. Set false to keep raw provider levels (legacy behavior).", "title": "Normalize Source Audio", "type": "boolean" }, "source_audio_target_lufs": { "default": -18.0, "description": "EBU R128 integrated loudness target (LUFS) applied per segment to retained provider audio when normalize_source_audio is true. Applied ahead of source_audio_volume, which then acts as a relative mix level on top of this known loudness.", "maximum": -10.0, "minimum": -30.0, "title": "Source Audio Target Lufs", "type": "number" }, "source_audio_true_peak_db": { "default": -1.5, "description": "True-peak ceiling (dBTP) for the loudnorm normalization pass on retained provider audio. Prevents inter-sample clipping after normalization.", "maximum": 0.0, "minimum": -6.0, "title": "Source Audio True Peak Db", "type": "number" } }, "title": "AudioSpec", "type": "object" }, { "type": "null" } ], "default": null }, "audio_strategy": { "anyOf": [ { "description": "Controls how audio layers are composed in the final mix.\n\nNATIVE: Provider-generated audio (e.g., Grok soundtrack) is primary.\nNARRATED: External narration is primary, native audio is ambient bed.\nSCORED: External music is primary, no native audio.\nFULL_MIX: All layers: narration + music + native audio with ducking.\n\nThe strategy reaches the video request through `source_audio_volume`:\n`enrichment._apply_audio_strategy_defaults` writes 0.8/0.3/0.0/0.2 per\nstrategy onto each segment, and `GrokVisualAdapter` asks Grok for a silent\nclip (`generate_audio=False`) exactly when that volume is 0 — i.e. under\nSCORED, whose native track finishing would discard anyway.", "enum": [ "native", "narrated", "scored", "full_mix" ], "title": "AudioStrategy", "type": "string" }, { "type": "null" } ], "default": null, "description": "Audio mixing strategy. Auto-inferred from plan contents if not set: NATIVE when no narration/music, NARRATED when narration present, SCORED for music-only, FULL_MIX for narration+music." }, "auto_generate_references": { "default": true, "description": "Auto-generate 2K reference images for cast members and recurring entities that lack resource_ids. Uses grok for hero-quality reference sheets.", "title": "Auto Generate References", "type": "boolean" }, "brief": { "anyOf": [ { "maxLength": 2000, "type": "string" }, { "type": "null" } ], "default": null, "title": "Brief" }, "cast": { "anyOf": [ { "items": { "additionalProperties": false, "description": "A character, setting, or prop with a reference image for consistency.\n\nWhen cast members are defined, the pipeline automatically:\n- Resolves provider-neutral visual_references on segments whose prompts mention the member's name\n- Assigns narration_voice_id to dialogue SegmentNarrations linked to the member\n\nIf ``resource_id`` is None and ``auto_generate_references`` is True on the plan,\nthe pipeline will auto-generate a reference image before segment generation.", "properties": { "name": { "description": "Name used in segment prompts to trigger reference resolution", "title": "Name", "type": "string" }, "narration_voice_id": { "anyOf": [ { "enum": [ "Friendly_Person", "Deep_Voice_Man", "Wise_Woman", "Calm_Woman", "Lively_Girl", "Casual_Guy", "Patient_Man", "Young_Knight", "Determined_Man", "Elegant_Man" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "MiniMax system voice for externally generated cast dialogue.", "title": "Narration Voice Id" }, "native_video_voice_id": { "anyOf": [ { "enum": [ "altair", "ara", "atlas", "carina", "castor", "celeste", "cosmo", "eve", "helios", "helix", "iris", "kepler", "leo", "lumen", "luna", "lux", "naksh", "orion", "perseus", "rex", "rigel", "sal", "sirius", "ursa", "zagan", "zenith" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "xAI reference-audio voice for Grok native-video speech.", "title": "Native Video Voice Id" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Resource ID of the reference sheet image. If None, pipeline auto-generates one when auto_generate_references=True.", "title": "Resource Id" }, "role": { "default": "character", "enum": [ "character", "setting", "prop" ], "title": "Role", "type": "string" }, "visual_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional caller-authored appearance text for this explicit cast member, used only by deterministic explicit-cast reference prompting.", "title": "Visual Description" } }, "required": [ "name" ], "title": "CastMember", "type": "object" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Cast" }, "delivery_intent": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional caller hint for content type, e.g. 'cinematic short', 'narrative film', 'ad', 'explainer'. When set it authoritatively routes the editorial story gate; otherwise content type is inferred from the brief.", "title": "Delivery Intent" }, "domain_rubric": { "anyOf": [ { "additionalProperties": { "type": "string" }, "type": "object" }, { "type": "null" } ], "default": null, "description": "Optional domain-specific evaluation criteria. Keys are dimension names, values are scoring descriptions. Applied to both segment and final QA rubrics. Example for chess: {\"piece_accuracy\": \"Pieces must be standard Staunton in legal positions\"}", "title": "Domain Rubric" }, "grok_voice_references": { "default": true, "description": "Send cast `native_video_voice_id`s as xAI `reference_audios` on reference-to-video segments, so Grok speaks a character's lines in that voice natively (the prompt gets bindings alongside ). At most 3 voices per segment (xAI limit), reference-to-video only — never combined with first_frame / input_video / extend_video, which xAI forbids. Defaults to TRUE: a live probe on 2026-08-25 confirmed this account's key is enabled (an R2V request with reference_audios=[{voice_id:'eve'}] completed and returned a clip carrying an AAC track, and a bogus voice_id is rejected 400 'Unknown voice_id', so the field is genuinely read rather than ignored). It is still a no-op unless the plan has voiced cast members AND the segment actually wants native speech: nothing is sent when `generate_audio` is off for the segment, or when speech is suppressed (`suppress_video_speech` under a narrated/full_mix strategy). Set False to keep every voice out of the video layer.", "title": "Grok Voice References", "type": "boolean" }, "output": { "additionalProperties": false, "description": "Output video specification.", "properties": { "aspect_ratio": { "default": "16:9", "description": "Output aspect ratio. All seven values the xAI video API accepts are supported, so Grok segments generate natively instead of being padded to fit. 16:9 is xAI's own default and is not sent on the wire.", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "3:2", "2:3" ], "title": "Aspect Ratio", "type": "string" }, "duration_sec": { "default": 30, "maximum": 300, "minimum": 10, "title": "Duration Sec", "type": "integer" }, "fps": { "default": 30, "maximum": 60, "minimum": 24, "title": "Fps", "type": "integer" }, "resolution": { "default": "1280x720", "description": "Final 720p-class canvas. The value must be the canonical canvas for aspect_ratio (16:9 -> 1280x720, 9:16 -> 720x1280, 1:1 -> 720x720, and equivalent 720-short-side canvases for the remaining supported Grok ratios).", "enum": [ "1280x720", "720x1280", "720x720", "960x720", "720x960", "1080x720", "720x1080" ], "title": "Resolution", "type": "string" } }, "title": "OutputSpec", "type": "object" }, "overlays": { "anyOf": [ { "items": { "additionalProperties": false, "description": "A text overlay on a segment.", "properties": { "end_sec": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "title": "End Sec" }, "font_color": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Font Color" }, "font_size": { "anyOf": [ { "maximum": 120, "minimum": 12, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Font Size" }, "position": { "default": "bottom_center", "title": "Position", "type": "string" }, "segment_index": { "minimum": 0, "title": "Segment Index", "type": "integer" }, "start_sec": { "default": 0.5, "minimum": 0.0, "title": "Start Sec", "type": "number" }, "style": { "default": "headline", "enum": [ "headline", "caption", "cta", "watermark" ], "title": "Style", "type": "string" }, "text": { "title": "Text", "type": "string" } }, "required": [ "text", "segment_index" ], "title": "OverlaySpec", "type": "object" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Overlays" }, "references": { "anyOf": [ { "items": { "additionalProperties": false, "description": "A reference artifact used during multimodal enrichment.", "properties": { "media_type": { "anyOf": [ { "enum": [ "image", "video", "audio", "pdf", "document", "execution_report" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Explicit media type. If omitted, inferred from the resource mime type or URL.", "title": "Media Type" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Library resource ID for the reference asset.", "title": "Resource Id" }, "role": { "default": "reference", "description": "Why this reference matters, e.g. brand_guide, storyboard, source_footage.", "title": "Role", "type": "string" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional human-readable label for reporting.", "title": "Title" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Unsupported on public Compose; use an authorized library resource_id.", "title": "Url" }, "weight": { "default": 1.0, "description": "Relative importance of this reference during enrichment.", "maximum": 5.0, "minimum": 0.0, "title": "Weight", "type": "number" } }, "title": "ReferenceAsset", "type": "object" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "References" }, "schema_version": { "const": "1.0", "default": "1.0", "description": "Durable public Compose plan contract version. If supplied, the value must be exactly '1.0'.", "title": "Schema Version", "type": "string" }, "segments": { "anyOf": [ { "items": { "additionalProperties": false, "description": "A single segment in the composition timeline.", "properties": { "adapter_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional manual Wan LoRA adapter resource_id override for video segments.", "title": "Adapter Id" }, "background": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Background" }, "camera_position": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "e.g. 'wide', 'over-the-shoulder'.", "title": "Camera Position" }, "character_state_in": { "additionalProperties": { "type": "string" }, "description": "Character entity id -> state at segment start.", "title": "Character State In", "type": "object" }, "character_state_out": { "additionalProperties": { "type": "string" }, "description": "Character entity id -> state at segment end.", "title": "Character State Out", "type": "object" }, "characters_present": { "description": "Entity ids of characters on screen in this segment.", "items": { "type": "string" }, "title": "Characters Present", "type": "array" }, "continues_from": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Index of the preceding segment this one continues from. Same-scene hard cuts extract the predecessor's last frame and I2V; crossfade / motion holds use extend_video.", "title": "Continues From" }, "continuity_anchor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Anchor (e.g. a prior frame resource id) this shot must match.", "title": "Continuity Anchor" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Description" }, "duration_sec": { "anyOf": [ { "maximum": 30.0, "minimum": 1.0, "type": "number" }, { "type": "null" } ], "default": null, "title": "Duration Sec" }, "fade_in_sec": { "anyOf": [ { "maximum": 3.0, "minimum": 0.0, "type": "number" }, { "type": "null" } ], "default": null, "description": "Fade-in duration for title card", "title": "Fade In Sec" }, "fade_out_sec": { "anyOf": [ { "maximum": 3.0, "minimum": 0.0, "type": "number" }, { "type": "null" } ], "default": null, "description": "Fade-out duration for title card", "title": "Fade Out Sec" }, "fallback_provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Fallback Provider" }, "first_frame": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "First Frame" }, "font_family": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Font family: 'noto_sans' (default), 'noto_serif', or system font name", "title": "Font Family" }, "font_size": { "anyOf": [ { "maximum": 120, "minimum": 12, "type": "integer" }, { "type": "null" } ], "default": null, "title": "Font Size" }, "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Id" }, "ken_burns": { "anyOf": [ { "additionalProperties": false, "description": "Ken Burns effect parameters for image segments.", "properties": { "easing": { "default": "ease_in_out_sine", "enum": [ "linear", "ease_in_out_sine", "ease_out_cubic", "ease_in_out_cubic" ], "title": "Easing", "type": "string" }, "pan_direction": { "default": "center", "title": "Pan Direction", "type": "string" }, "zoom_end": { "default": 1.2, "maximum": 3.0, "minimum": 0.5, "title": "Zoom End", "type": "number" }, "zoom_start": { "default": 1.0, "maximum": 3.0, "minimum": 0.5, "title": "Zoom Start", "type": "number" } }, "title": "KenBurnsSpec", "type": "object" }, { "type": "null" } ], "default": null }, "line_spacing": { "anyOf": [ { "maximum": 3.0, "minimum": 0.8, "type": "number" }, { "type": "null" } ], "default": null, "description": "Line spacing multiplier (1.0=tight, 1.5=default, 2.0=spacious)", "title": "Line Spacing" }, "location_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Location/setting entity id; one location per scene.", "title": "Location Id" }, "motion_intensity": { "anyOf": [ { "enum": [ "low", "medium", "high" ], "type": "string" }, { "type": "null" } ], "default": null, "title": "Motion Intensity" }, "optional_references": { "description": "Entity ids that may be referenced if helpful.", "items": { "type": "string" }, "title": "Optional References", "type": "array" }, "original_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Original Prompt" }, "prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Prompt" }, "prop_state_in": { "additionalProperties": { "type": "string" }, "description": "Prop entity id -> state at segment start.", "title": "Prop State In", "type": "object" }, "prop_state_out": { "additionalProperties": { "type": "string" }, "description": "Prop entity id -> state at segment end.", "title": "Prop State Out", "type": "object" }, "provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Provider" }, "required_references": { "description": "Entity ids that MUST be referenced in this shot.", "items": { "type": "string" }, "title": "Required References", "type": "array" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Resource Id" }, "scene_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Scene this segment belongs to.", "title": "Scene Id" }, "screen_direction": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "e.g. 'left-to-right'.", "title": "Screen Direction" }, "source_audio_volume": { "default": 0.3, "description": "Volume for retained source audio (0.0=stripped, 0.3=ambient bed, 1.0=full). Also drives Grok's `generate_audio` on this segment: 0.0 means finishing throws the native track away, so compose asks Grok for a SILENT clip (generate_audio=False) rather than paying to generate audio it will discard; any value > 0 keeps generate_audio True. Enrichment sets this from the audio strategy (native 0.8 / narrated 0.3 / scored 0.0 / full_mix 0.2), so audio_strategy='scored' is what turns native audio off end-to-end.", "maximum": 1.0, "minimum": 0.0, "title": "Source Audio Volume", "type": "number" }, "text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Text" }, "text_align": { "anyOf": [ { "enum": [ "left", "center", "right" ], "type": "string" }, { "type": "null" } ], "default": "center", "title": "Text Align" }, "text_color": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Text Color" }, "time_of_day": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "e.g. 'dawn', 'night'.", "title": "Time Of Day" }, "type": { "default": "video", "enum": [ "video", "image", "title_card", "existing", "still" ], "title": "Type", "type": "string" }, "visual_references": { "anyOf": [ { "additionalProperties": false, "description": "Provider-neutral visual references for a segment.", "properties": { "backgrounds": { "items": { "type": "string" }, "title": "Backgrounds", "type": "array" }, "bindings": { "description": "Stable entity-to-asset bindings used to compile provider-local reference indices", "items": { "additionalProperties": false, "description": "Stable logical binding between a prompt token and a visual asset.", "properties": { "key": { "description": "Stable provider-neutral entity key, such as cast:mara-vale", "title": "Key", "type": "string" }, "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Human-readable entity label", "title": "Label" }, "prompt_index": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "default": null, "description": "Plan-level index to remap into the provider request", "title": "Prompt Index" }, "resource_id": { "description": "Authorized library resource UUID for the reference asset", "title": "Resource Id", "type": "string" }, "role": { "default": "subject", "enum": [ "subject", "background", "style" ], "title": "Role", "type": "string" } }, "required": [ "key", "resource_id" ], "title": "VisualReferenceBinding", "type": "object" }, "title": "Bindings", "type": "array" }, "styles": { "items": { "type": "string" }, "title": "Styles", "type": "array" }, "subjects": { "items": { "type": "string" }, "title": "Subjects", "type": "array" }, "videos": { "items": { "type": "string" }, "title": "Videos", "type": "array" } }, "title": "VisualReferencesSpec", "type": "object" }, { "type": "null" } ], "default": null }, "weather": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Weather" } }, "title": "SegmentSpec", "type": "object" }, "type": "array" }, { "type": "null" } ], "default": null, "title": "Segments" }, "style": { "default": "corporate_inspirational", "title": "Style", "type": "string" }, "suppress_video_speech": { "default": true, "description": "Append 'no dialogue/voiceover' to video prompts when external narration is present. Set to False to allow provider-generated speech in videos. This suppresses SPEECH only — ambience and foley are still generated. Whether the provider generates any audio at all is the separate `generate_audio` flag, which compose derives from each segment's `source_audio_volume` (see SegmentSpec).", "title": "Suppress Video Speech", "type": "boolean" }, "title": { "anyOf": [ { "maxLength": 100, "type": "string" }, { "type": "null" } ], "default": null, "title": "Title" }, "transitions": { "additionalProperties": false, "description": "Transition configuration between segments.", "properties": { "duration_ms": { "default": 400, "maximum": 2000, "minimum": 0, "title": "Duration Ms", "type": "integer" }, "type": { "default": "crossfade", "enum": [ "crossfade", "cut" ], "title": "Type", "type": "string" } }, "title": "TransitionsSpec", "type": "object" }, "visual_strategy": { "additionalProperties": false, "description": "Project-level visual routing strategy.", "properties": { "allow_segment_overrides": { "default": true, "title": "Allow Segment Overrides", "type": "boolean" }, "consistency_focus": { "default": "balanced", "enum": [ "character", "scene", "balanced" ], "title": "Consistency Focus", "type": "string" }, "fallback_provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Fallback Provider" }, "prefer_single_provider": { "default": true, "title": "Prefer Single Provider", "type": "boolean" }, "primary_provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Primary Provider" } }, "title": "VisualStrategySpec", "type": "object" } }, "title": "CompositionPlan", "type": "object" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Project UUID. Auto-created if omitted.", "title": "Project Id" }, "qa": { "default": true, "description": "Run vision_qa on final output (~3 credits).", "title": "Qa", "type": "boolean" }, "qa_policy": { "default": "gate", "description": "'gate' (default): fail if required QA is not verified and passing. 'advisory': publish nonpassing evidence only when allow_degraded_output=true.", "enum": [ "gate", "advisory" ], "title": "Qa Policy", "type": "string" }, "quality_profile": { "default": "stable", "description": "'stable' (default): the production Grok-only profile. 'frontier': explicit higher-cost Grok-only candidate panels; it does not enable additional visual providers.", "enum": [ "frontier", "stable" ], "title": "Quality Profile", "type": "string" }, "reassemble_only": { "default": false, "description": "Skip GES, run assembly+QA only. Requires ALL segment IDs in reuse_segments.", "title": "Reassemble Only", "type": "boolean" }, "regenerate": { "anyOf": [ { "items": { "type": "integer" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Segment indices (0-based, unique, within the parent's timeline) to regenerate. Only with revise_from. Empty or omitted means pure re-assembly: every parent segment is reused (zero generation), carried audio, full QA + publication — the recovery path for a failed own parent whose segments all completed. Validated against the parent's checkpointed segment count before any charge.", "title": "Regenerate" }, "reuse_from": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Alias of parent_resource_id.", "title": "Reuse From" }, "reuse_segments": { "anyOf": [ { "additionalProperties": { "type": "string" }, "type": "object" }, { "type": "null" } ], "default": null, "description": "Segment index→resource_id map for revision. Reused segments skip generation.", "title": "Reuse Segments" }, "revise_from": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Parent composition resource UUID to revise. Owner-only. The server reconstructs the plan and reuse map from the parent's durable checkpoint: every segment NOT listed in `regenerate` reuses the parent's clip; the parent's monolithic narration and music carry over as supplied audio. Requires plan={}; regenerate is optional (empty/omitted = pure re-assembly of the parent, including a failed one whose segments completed). Mutually exclusive with parent_resource_id/reuse_from, reuse_segments, and reassemble_only.", "title": "Revise From" }, "segment_overrides": { "anyOf": [ { "additionalProperties": { "$ref": "#/$defs/RevisionSegmentOverride" }, "type": "object" }, { "type": "null" } ], "default": null, "description": "Per-segment edits, keyed by canonical index string; keys must be listed in regenerate. Allowed keys per override: prompt, duration_sec, motion_intensity, camera_position. Unknown keys are rejected (strict plans). Requires revise_from and a non-empty regenerate.", "title": "Segment Overrides" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Tags merged with the server's composition/final tags.", "title": "Tags" }, "video_candidates": { "default": 1, "description": "Video candidates per segment (1-6, default 1).", "maximum": 6, "minimum": 1, "title": "Video Candidates", "type": "integer" } }, "required": [ "plan" ], "title": "compose_videoArguments", "type": "object" }, "name": "compose_video", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "grok", "lyria", "minimax" ] }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false, "title": "Create Artifact" }, "category": "generation", "description": "Create a business artifact: presentation (slides), chart (data viz), document (sections), or diagram (mermaid). Bundle mode: pass outputs list for multi-format generation. Supports brand kits. Provider 'gamma' for AI presentations.", "execution": "sync", "inputSchema": { "properties": { "aspect_ratio": { "anyOf": [ { "enum": [ "16:9", "4:3" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "(presentation only) Slide dimensions. Default 16:9.", "title": "Aspect Ratio" }, "brand": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Brand kit name for consistent styling. Use lib_list(entity_type='brand_kits') to see available kits.", "title": "Brand" }, "brief": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "(bundle mode) High-level description. Used to auto-generate slides/sections when not explicitly provided.", "title": "Brief" }, "chart_type": { "anyOf": [ { "enum": [ "bar", "line", "pie", "scatter", "area", "heatmap", "treemap" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "(chart only) Chart type.", "title": "Chart Type" }, "collection_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Library collection UUID within the project.", "title": "Collection Id" }, "data": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "(chart) Chart data: {x, y, labels} for bar/line/area; {labels, values} for pie; {z, x_labels, y_labels} for heatmap.", "title": "Data" }, "diagram_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "(diagram) Mermaid syntax string.", "title": "Diagram Code" }, "height": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "(chart, diagram) Output height in pixels. Default 800.", "title": "Height" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Custom filename for the generated artifact.", "title": "Name" }, "output_format": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Chart: html|png|svg. Document: docx|pdf|html. Diagram: png|svg. Presentation: always pptx.", "title": "Output Format" }, "outputs": { "anyOf": [ { "items": { "enum": [ "pptx", "pdf", "docx", "png", "svg", "html" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "(bundle mode) Output formats to generate. When provided, generates multiple artifacts. Each format maps to a type: pptx→presentation, docx/pdf/html→document, png/svg→chart.", "title": "Outputs" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Library project UUID. If omitted, uses the user's default project.", "title": "Project Id" }, "provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Provider override. Default: local rendering (pptx/plotly/docx/mermaid). Use 'gamma' for premium AI-generated presentations.", "title": "Provider" }, "sections": { "anyOf": [ { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "(document) Section objects with heading, content, level, table, image_resource_id.", "title": "Sections" }, "slides": { "anyOf": [ { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "(presentation) Slide objects with layout, title, content, notes, image_resource_id, chart_resource_id.", "title": "Slides" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Tags for filtering and organization.", "title": "Tags" }, "template": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Template name. Presentations: 'default', 'pitch_deck'. Documents: 'report'.", "title": "Template" }, "title": { "default": "", "description": "Artifact title", "title": "Title", "type": "string" }, "type": { "description": "Artifact type to generate", "enum": [ "presentation", "chart", "document", "diagram" ], "title": "Type", "type": "string" }, "width": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "(chart, diagram) Output width in pixels. Default 1200.", "title": "Width" } }, "required": [ "type" ], "title": "create_artifactArguments", "type": "object" }, "name": "create_artifact", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "docx", "gamma", "mermaid", "plotly", "pptx", "weasyprint" ] }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false, "title": "Create Audio" }, "category": "generation", "description": "Create audio: TTS, sound effects, voice cloning/design, voice listing, or the deprecated transcription compatibility shim. Use analyze_media(analysis_type='transcribe') for new transcription integrations.", "execution": "mixed", "inputSchema": { "properties": { "advanced_options": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Provider-specific settings", "title": "Advanced Options" }, "audio_file_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Voice cloning source resource ID", "title": "Audio File Id" }, "bitrate": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Bitrate", "title": "Bitrate" }, "channel": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Channels (1 or 2)", "title": "Channel" }, "collection_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Collection UUID", "title": "Collection Id" }, "duration": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Sound effect duration (seconds)", "title": "Duration" }, "enable_diarization": { "default": false, "description": "Speaker identification for transcription", "title": "Enable Diarization", "type": "boolean" }, "enable_silence_detection": { "default": false, "description": "Persist silence markers in transcription", "title": "Enable Silence Detection", "type": "boolean" }, "format": { "anyOf": [ { "enum": [ "pcm", "mp3", "flac", "wav" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Output format", "title": "Format" }, "include_word_timestamps": { "default": true, "description": "Word-level timestamps", "title": "Include Word Timestamps", "type": "boolean" }, "language_code": { "default": "en-US", "description": "Transcription language", "title": "Language Code", "type": "string" }, "loop": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Loop sound effect", "title": "Loop" }, "mode": { "default": "tts", "description": "Generation mode. 'transcribe' is deprecated; use analyze_media(analysis_type='transcribe').", "enum": [ "tts", "sound_effect", "transcribe", "voice_clone", "voice_design", "list_voices" ], "title": "Mode", "type": "string" }, "model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Model override", "title": "Model" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Filename", "title": "Name" }, "pitch": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Pitch", "title": "Pitch" }, "preview_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Voice design preview text", "title": "Preview Text" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Project UUID", "title": "Project Id" }, "prompt": { "default": "", "description": "TTS text or sound effect description", "title": "Prompt", "type": "string" }, "prompt_audio_file_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Voice design prompt resource ID", "title": "Prompt Audio File Id" }, "provider": { "description": "AI provider. runway for sound effects, others for TTS.", "enum": [ "minimax", "vertex", "creative_freedom", "runway", "grok" ], "title": "Provider", "type": "string" }, "sample_rate": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Sample rate (Hz)", "title": "Sample Rate" }, "silence_threshold_sec": { "default": 1.0, "description": "Minimum silence gap in seconds", "title": "Silence Threshold Sec", "type": "number" }, "source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Transcription source resource ID/URL", "title": "Source" }, "speed": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Speech speed", "title": "Speed" }, "subtitle_formats": { "anyOf": [ { "items": { "enum": [ "srt", "vtt" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Subtitle sidecars to persist for transcription", "title": "Subtitle Formats" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Tags", "title": "Tags" }, "voice_id": { "default": "Calm_Woman", "description": "Voice ID for TTS (e.g. 'Calm_Woman', 'en-US-Chirp3-HD-Aoede', or 'eve' for grok — see grok.GROK_TTS_VOICES)", "title": "Voice Id", "type": "string" }, "voice_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Voice type filter (list_voices)", "title": "Voice Type" }, "vol": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Volume", "title": "Vol" } }, "required": [ "provider" ], "title": "create_audioArguments", "type": "object" }, "name": "create_audio", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "creative_freedom", "grok", "minimax", "runway", "vertex" ] }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false, "title": "Create Image" }, "category": "generation", "description": "Create image from text prompt or reference. Sync (vertex, minimax, grok, creative_freedom) or async (alibaba — poll with lib_list).", "execution": "mixed", "inputSchema": { "properties": { "advanced_options": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Provider-specific settings", "title": "Advanced Options" }, "character_reference": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Character reference image resource ID/URL", "title": "Character Reference" }, "collection_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Collection UUID", "title": "Collection Id" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Filename", "title": "Name" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Project UUID", "title": "Project Id" }, "prompt": { "description": "Image content description", "title": "Prompt", "type": "string" }, "provider": { "description": "AI provider", "enum": [ "minimax", "vertex", "grok", "creative_freedom", "alibaba" ], "title": "Provider", "type": "string" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Tags", "title": "Tags" } }, "required": [ "provider", "prompt" ], "title": "create_imageArguments", "type": "object" }, "name": "create_image", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "alibaba", "creative_freedom", "grok", "minimax", "vertex" ] }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false, "title": "Create Music" }, "category": "generation", "description": "Create music from lyrics/prompt. Lyria is synchronous; Creative Freedom is authenticated-only and asynchronous. MiniMax music is unavailable and is not part of the public contract.", "execution": "mixed", "inputSchema": { "properties": { "advanced_options": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Provider-specific settings dict", "title": "Advanced Options" }, "bitrate": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Audio bitrate", "title": "Bitrate" }, "collection_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Library collection UUID", "title": "Collection Id" }, "duration": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Target duration in seconds. Used only by Lyria as a prompt hint. Creative Freedom takes duration via advanced_options.duration.", "title": "Duration" }, "format": { "anyOf": [ { "enum": [ "mp3", "wav", "pcm" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Output audio format", "title": "Format" }, "is_instrumental": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Generate instrumental music (no vocals). When True, lyrics are not required and prompt is required.", "title": "Is Instrumental" }, "lyrics": { "default": "", "description": "Song lyrics text. Use \\n to separate lines. Supports structure tags: [Intro], [Verse], [Chorus], [Bridge], [Outro], etc. Not required when is_instrumental=True.", "title": "Lyrics", "type": "string" }, "model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Model name override", "title": "Model" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Custom filename", "title": "Name" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Library project UUID", "title": "Project Id" }, "prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Style/genre description. Required for instrumental generation.", "title": "Prompt" }, "provider": { "description": "AI provider for music generation. Lyria is synchronous; Creative Freedom is authenticated-only and asynchronous.", "enum": [ "creative_freedom", "lyria" ], "title": "Provider", "type": "string" }, "reference_audio_purpose": { "anyOf": [ { "enum": [ "song", "voice", "instrumental" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Purpose of reference audio", "title": "Reference Audio Purpose" }, "reference_audio_resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Resource ID for reference audio", "title": "Reference Audio Resource Id" }, "sample_rate": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Audio sample rate (Hz)", "title": "Sample Rate" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Tags for filtering", "title": "Tags" } }, "required": [ "provider" ], "title": "create_musicArguments", "type": "object" }, "name": "create_music", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "creative_freedom", "lyria" ] }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false, "title": "Generate Text" }, "category": "generation", "description": "Generate text via LLM chat completions. Pass messages or prompt.", "execution": "sync", "inputSchema": { "properties": { "advanced_options": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Provider-specific settings dict", "title": "Advanced Options" }, "json_schema": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "JSON schema for structured output", "title": "Json Schema" }, "max_tokens": { "default": 512, "description": "Maximum tokens to generate", "title": "Max Tokens", "type": "integer" }, "messages": { "default": [], "description": "Chat messages with role and content", "items": { "additionalProperties": { "type": "string" }, "type": "object" }, "title": "Messages", "type": "array" }, "model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Model name override", "title": "Model" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Library project UUID", "title": "Project Id" }, "prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Single prompt (alternative to messages)", "title": "Prompt" }, "provider": { "default": "vertex", "description": "AI provider for text generation", "enum": [ "minimax", "vertex", "grok", "qwen" ], "title": "Provider", "type": "string" }, "store_response": { "default": false, "description": "Store response as library resource", "title": "Store Response", "type": "boolean" }, "temperature": { "default": 0.7, "description": "Sampling temperature (0-2)", "title": "Temperature", "type": "number" } }, "title": "create_textArguments", "type": "object" }, "name": "create_text", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "grok", "minimax", "qwen", "vertex" ] }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false, "title": "Create Video" }, "category": "generation", "description": "Create video from text/image. Async: returns pending resource_id, poll with lib_list until completed (5-10s intervals, 600s timeout). Supports character_reference for consistency.", "execution": "pending", "inputSchema": { "properties": { "adapter_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "(Deprecated) Single adapter ID", "title": "Adapter Id" }, "adapter_ids": { "anyOf": [ { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "LoRA adapters: [{id, weight}]. Must be deployed.", "title": "Adapter Ids" }, "advanced_options": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Provider-specific settings", "title": "Advanced Options" }, "character_reference": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Character reference image resource ID/URL", "title": "Character Reference" }, "collection_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Collection UUID", "title": "Collection Id" }, "extend_video": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Video resource ID/URL to extend", "title": "Extend Video" }, "first_frame": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Resource ID/URL for I2V first frame", "title": "First Frame" }, "input_audio": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Resource ID/URL for audio input", "title": "Input Audio" }, "input_video": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Resource ID/URL for V2V input", "title": "Input Video" }, "last_frame": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Resource ID/URL for last frame", "title": "Last Frame" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Filename", "title": "Name" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Project UUID", "title": "Project Id" }, "prompt": { "description": "Video content description", "title": "Prompt", "type": "string" }, "provider": { "description": "AI provider", "enum": [ "minimax", "vertex", "grok", "creative_freedom", "alibaba" ], "title": "Provider", "type": "string" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Alias for first_frame", "title": "Resource Id" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Tags", "title": "Tags" } }, "required": [ "provider", "prompt" ], "title": "create_videoArguments", "type": "object" }, "name": "create_video", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "alibaba", "creative_freedom", "grok", "minimax", "vertex" ] }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false, "title": "Edit Audio" }, "category": "editing", "description": "Edit audio on video: mix_audio, replace_audio, pad_audio. Returns resource_id.", "execution": "sync", "inputSchema": { "properties": { "action": { "description": "Audio action", "enum": [ "mix_audio", "replace_audio", "pad_audio" ], "title": "Action", "type": "string" }, "audio_delay_sec": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Audio delay (seconds)", "title": "Audio Delay Sec" }, "audio_position": { "anyOf": [ { "enum": [ "center", "start", "end" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Audio position (pad_audio)", "title": "Audio Position" }, "audio_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Audio resource ID/URL to mix/replace", "title": "Audio Source" }, "collection_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Collection UUID", "title": "Collection Id" }, "duration_mode": { "anyOf": [ { "enum": [ "shortest", "longest", "first" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Duration mode", "title": "Duration Mode" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Filename", "title": "Name" }, "overlay_volume": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Overlay volume 0-2", "title": "Overlay Volume" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Project UUID", "title": "Project Id" }, "provider": { "const": "soundside.ai", "default": "soundside.ai", "description": "Provider", "title": "Provider", "type": "string" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Source resource ID", "title": "Resource Id" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Tags", "title": "Tags" }, "target_duration": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Target duration (pad_audio)", "title": "Target Duration" }, "video_volume": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Video volume 0-2", "title": "Video Volume" } }, "required": [ "action" ], "title": "edit_audioArguments", "type": "object" }, "name": "edit_audio", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "soundside.ai" ] }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false, "title": "Edit Video" }, "category": "editing", "description": "Edit video: trim, concat, crossfade, adjust_speed, loop, color_grade, custom, burn_subtitles. Returns resource_id of new media.", "execution": "sync", "inputSchema": { "properties": { "action": { "description": "Edit action", "enum": [ "trim", "concat", "crossfade", "adjust_speed", "loop", "color_grade", "custom", "burn_subtitles" ], "title": "Action", "type": "string" }, "brightness": { "anyOf": [ { "maximum": 1.0, "minimum": -1.0, "type": "number" }, { "type": "null" } ], "default": null, "description": "Additive brightness adjustment from -1.0 to 1.0; 0.0 is neutral", "title": "Brightness" }, "collection_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Collection UUID", "title": "Collection Id" }, "contrast": { "anyOf": [ { "maximum": 4.0, "minimum": 0.25, "type": "number" }, { "type": "null" } ], "default": null, "description": "Contrast multiplier from 0.25 to 4.0; 1.0 is neutral. Values below 1.0 reduce contrast.", "title": "Contrast" }, "crossfade_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "Audio seam smoothing (ms)", "title": "Crossfade Ms" }, "duration_sec": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Duration (trim, crossfade)", "title": "Duration Sec" }, "factor": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Speed factor", "title": "Factor" }, "ffmpeg_args": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Custom FFmpeg args", "title": "Ffmpeg Args" }, "frame_rate": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Frame rate (concat)", "title": "Frame Rate" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Filename", "title": "Name" }, "output_format": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Output format", "title": "Output Format" }, "pixel_format": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Pixel format (concat)", "title": "Pixel Format" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Project UUID", "title": "Project Id" }, "provider": { "const": "soundside.ai", "default": "soundside.ai", "description": "Provider", "title": "Provider", "type": "string" }, "resolution": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Output resolution WxH", "title": "Resolution" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Source resource ID", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Multi-source IDs (concat, crossfade)", "title": "Resource Ids" }, "saturation": { "anyOf": [ { "maximum": 3.0, "minimum": 0.0, "type": "number" }, { "type": "null" } ], "default": null, "description": "Saturation multiplier from 0.0 to 3.0; 1.0 is neutral and 0.0 is grayscale", "title": "Saturation" }, "smooth": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "default": null, "description": "Frame interpolation for slow-mo", "title": "Smooth" }, "start_sec": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Start time (trim)", "title": "Start Sec" }, "subtitle_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Subtitle resource ID/URL (SRT/ASS/VTT)", "title": "Subtitle Source" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Tags", "title": "Tags" }, "target_duration": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Target duration (loop)", "title": "Target Duration" }, "transition": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Transition type", "title": "Transition" } }, "required": [ "action" ], "title": "edit_videoArguments", "type": "object" }, "name": "edit_video", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "soundside.ai" ] }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true, "title": "Extract Media" }, "category": "editing", "description": "Extract from media: extract_frame, extract_frames, extract_audio. Returns resource_id(s).", "execution": "sync", "inputSchema": { "properties": { "action": { "description": "Extraction action", "enum": [ "extract_frame", "extract_frames", "extract_audio" ], "title": "Action", "type": "string" }, "collection_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Collection UUID", "title": "Collection Id" }, "end_sec": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "End time", "title": "End Sec" }, "frame_interval_sec": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Frame interval (seconds)", "title": "Frame Interval Sec" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Filename", "title": "Name" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Project UUID", "title": "Project Id" }, "provider": { "const": "soundside.ai", "default": "soundside.ai", "description": "Provider", "title": "Provider", "type": "string" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Source resource ID", "title": "Resource Id" }, "start_sec": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Start time", "title": "Start Sec" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Tags", "title": "Tags" }, "timestamp": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "default": null, "description": "Frame timestamp (seconds)", "title": "Timestamp" } }, "required": [ "action" ], "title": "extract_mediaArguments", "type": "object" }, "name": "extract_media", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "soundside.ai" ] }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true, "title": "List Resources" }, "category": "library", "description": "List library entities: projects, collections, resources, lineage, brand_kits, credits, or dashboard (composite load). Filter by project_id, collection_id, tags, mime_type_prefix. Supports pagination (limit/offset), sorting, and search.", "execution": "sync", "inputSchema": { "properties": { "all_projects": { "default": false, "description": "Search all projects", "title": "All Projects", "type": "boolean" }, "collection_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Filter by collection", "title": "Collection Id" }, "count_only": { "default": false, "description": "Count only", "title": "Count Only", "type": "boolean" }, "entity_type": { "description": "Entity type to list", "enum": [ "projects", "collections", "resources", "lineage", "brand_kits", "credits", "dashboard" ], "title": "Entity Type", "type": "string" }, "exclude_fields": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Field blacklist", "title": "Exclude Fields" }, "fields": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Field whitelist", "title": "Fields" }, "filters": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Django-style filters", "title": "Filters" }, "ids_only": { "default": false, "description": "IDs only", "title": "Ids Only", "type": "boolean" }, "include_deleted": { "default": false, "description": "Include deleted", "title": "Include Deleted", "type": "boolean" }, "include_resources": { "default": false, "description": "Include resources", "title": "Include Resources", "type": "boolean" }, "include_shares": { "default": false, "description": "Include sharing info", "title": "Include Shares", "type": "boolean" }, "include_stats": { "default": true, "description": "Include counts/sizes", "title": "Include Stats", "type": "boolean" }, "include_subcollections": { "default": false, "description": "Include nested collections", "title": "Include Subcollections", "type": "boolean" }, "limit": { "default": 100, "description": "Max results (max 1000)", "title": "Limit", "type": "integer" }, "mime_type_prefix": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "MIME prefix filter (e.g. 'video/')", "title": "Mime Type Prefix" }, "offset": { "default": 0, "description": "Skip N results", "title": "Offset", "type": "integer" }, "parent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Parent collection filter", "title": "Parent Id" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Filter by project", "title": "Project Id" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Single resource UUID", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Specific resource UUIDs", "title": "Resource Ids" }, "search": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Name search", "title": "Search" }, "search_fields": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Search field scope", "title": "Search Fields" }, "sort_by": { "default": "created_at", "description": "Sort field", "enum": [ "created_at", "name", "size_bytes" ], "title": "Sort By", "type": "string" }, "sort_desc": { "default": true, "description": "Sort descending", "title": "Sort Desc", "type": "boolean" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Filter by tags", "title": "Tags" } }, "required": [ "entity_type" ], "title": "lib_listArguments", "type": "object" }, "name": "lib_list", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "soundside.ai" ] }, { "annotations": { "destructiveHint": true, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false, "title": "Manage Resources" }, "category": "library", "description": "CRUD for library entities (projects, collections, resources, brand_kits). Large file upload: upload_initiate → PUT to signed URL → upload_complete. To share a resource: set visibility=\"public\" → response includes a permanent short_url. For listing, use lib_list.", "execution": "sync", "inputSchema": { "properties": { "collection_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Collection UUID", "title": "Collection Id" }, "content_base64": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Base64 content (<5MB)", "title": "Content Base64" }, "content_json": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "JSON content", "title": "Content Json" }, "content_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Text content", "title": "Content Text" }, "content_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "URL to fetch", "title": "Content Url" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Description", "title": "Description" }, "entity_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Entity UUID (update/delete)", "title": "Entity Id" }, "entity_type": { "description": "Entity type", "enum": [ "project", "collection", "resource", "brand_kit" ], "title": "Entity Type", "type": "string" }, "filters": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Batch filters", "title": "Filters" }, "merge_metadata": { "default": true, "description": "Merge metadata", "title": "Merge Metadata", "type": "boolean" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Metadata", "title": "Metadata" }, "mime_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "MIME type", "title": "Mime Type" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Entity name", "title": "Name" }, "operation": { "description": "CRUD operation", "enum": [ "create", "update", "delete", "upload_initiate", "upload_complete" ], "title": "Operation", "type": "string" }, "parent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Parent collection UUID", "title": "Parent Id" }, "permanent": { "default": false, "description": "Hard delete", "title": "Permanent", "type": "boolean" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Project UUID", "title": "Project Id" }, "recursive": { "default": true, "description": "Recursive delete", "title": "Recursive", "type": "boolean" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Batch UUIDs", "title": "Resource Ids" }, "size_bytes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "description": "File size (upload_initiate)", "title": "Size Bytes" }, "storage_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Storage path (upload_complete)", "title": "Storage Path" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "Tags", "title": "Tags" }, "visibility": { "anyOf": [ { "enum": [ "private", "public" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Visibility: private or public", "title": "Visibility" } }, "required": [ "entity_type", "operation" ], "title": "lib_manage_toolArguments", "type": "object" }, "name": "lib_manage", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "soundside.ai" ] }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false, "title": "Share Resources" }, "category": "library", "description": "Manage project sharing: share by email, list shares, or revoke access. For download URLs, use lib_list with resource_id.", "execution": "sync", "inputSchema": { "properties": { "operation": { "description": "Share operation: share, list, or revoke", "enum": [ "share", "list", "revoke" ], "title": "Operation", "type": "string" }, "permission_level": { "anyOf": [ { "enum": [ "view", "edit", "admin" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Permission level to grant", "title": "Permission Level" }, "project_id": { "description": "Project UUID to manage sharing for", "title": "Project Id", "type": "string" }, "user_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Email of user to share with (for share)", "title": "User Email" }, "user_id_to_revoke": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "User ID to revoke access (for revoke)", "title": "User Id To Revoke" } }, "required": [ "operation", "project_id" ], "title": "lib_share_toolArguments", "type": "object" }, "name": "lib_share", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "soundside.ai" ] }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true, "title": "List Adapters" }, "category": "adapters", "description": "List LoRA adapters mirrored into the Soundside library.", "execution": "sync", "inputSchema": { "properties": { "adapter_type": { "anyOf": [ { "enum": [ "character", "style", "effect", "transition" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional adapter type filter", "title": "Adapter Type" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional project UUID filter", "title": "Project Id" }, "status": { "anyOf": [ { "enum": [ "uploading", "training", "selecting", "deploying", "deployed", "undeploying", "undeployed", "failed" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional adapter status filter", "title": "Status" } }, "title": "list_adaptersArguments", "type": "object" }, "name": "list_adapters", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "soundside.ai" ] }, { "annotations": { "destructiveHint": true, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false, "title": "Manage Adapter" }, "category": "adapters", "description": "Manage a LoRA adapter: inspect, deploy, undeploy, delete, or select_checkpoint.", "execution": "mixed", "inputSchema": { "properties": { "action": { "description": "Lifecycle action: inspect, deploy, undeploy, delete, or select_checkpoint", "enum": [ "inspect", "deploy", "undeploy", "delete", "select_checkpoint" ], "title": "Action", "type": "string" }, "adapter_id": { "description": "Adapter resource UUID", "title": "Adapter Id", "type": "string" }, "checkpoint": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Checkpoint name/id to export when action=select_checkpoint", "title": "Checkpoint" } }, "required": [ "adapter_id", "action" ], "title": "manage_adapterArguments", "type": "object" }, "name": "manage_adapter", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "soundside.ai" ] }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false, "title": "Train Adapter" }, "category": "adapters", "description": "Train a LoRA adapter from library media. Each training_data item needs first_frame_resource_id + video_resource_id (kf2v also needs last_frame_resource_id). Backends: dashscope (wan* models) or modal (hunyuan/ltx/wan-selfhosted/HF repos).", "execution": "pending", "inputSchema": { "properties": { "adapter_type": { "description": "What this adapter represents: character, style, effect, or transition", "enum": [ "character", "style", "effect", "transition" ], "title": "Adapter Type", "type": "string" }, "auto_deploy": { "default": true, "description": "Automatically deploy the trained adapter when the training job succeeds", "title": "Auto Deploy", "type": "boolean" }, "backend": { "anyOf": [ { "enum": [ "dashscope", "modal" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Training backend: 'dashscope' or 'modal'. Auto-detected from base_model if omitted. Use 'modal' to force self-hosted training for Wan models.", "title": "Backend" }, "base_model": { "default": "wan2.6-i2v", "description": "Base model: wan2.6-i2v (default), wan2.5-i2v-preview, wan2.2-i2v-flash, wan2.2-kf2v-flash, hunyuan-video-1.5, wan-2.6-selfhosted, ltx-2, or HF repo.", "title": "Base Model", "type": "string" }, "hyper_parameters": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Training hyperparameters. Merged with model defaults. Keys vary by backend/trainer: n_epochs, batch_size, learning_rate (DashScope); rank, alpha, lr, epochs, target_modules (Modal/finetrainers).", "title": "Hyper Parameters" }, "name": { "description": "Adapter display name", "title": "Name", "type": "string" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Library project UUID. Defaults to the caller's current project.", "title": "Project Id" }, "prompt_template": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional deployment-time prompt template. Supports {prompt}, {input_prompt}, and {trigger_word}.", "title": "Prompt Template" }, "training_data": { "description": "Training items referencing library resources. Each item must include first_frame_resource_id and video_resource_id; kf2v adapters also need last_frame_resource_id.", "items": { "additionalProperties": true, "type": "object" }, "title": "Training Data", "type": "array" }, "trigger_word": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Optional trigger token injected into prompts during generation", "title": "Trigger Word" } }, "required": [ "name", "adapter_type", "training_data" ], "title": "train_adapterArguments", "type": "object" }, "name": "train_adapter", "outputSchema": { "additionalProperties": true, "description": "Standard response format for MCP tool operations.\n\nAll MCP tools should return responses conforming to this schema\nto ensure consistent, parseable outputs.", "properties": { "duration_ms": { "default": 0, "description": "Operation duration in milliseconds", "minimum": 0, "title": "Duration Ms", "type": "integer" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Error message (required if success=False)", "title": "Error" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "description": "Tool-specific additional data", "title": "Metadata" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "description": "Primary resource ID created or affected", "title": "Resource Id" }, "resource_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "default": null, "description": "List of resource IDs (for multi-resource operations)", "title": "Resource Ids" }, "status": { "default": "completed", "description": "Operation status", "enum": [ "completed", "pending", "failed", "paused", "needs_user_input" ], "title": "Status", "type": "string" }, "success": { "default": true, "description": "Whether the operation completed successfully", "title": "Success", "type": "boolean" } }, "title": "StandardToolResponse", "type": "object" }, "providers": [ "dashscope", "modal" ] } ] }