soundside-mcp

endpoint

https://mcp.soundside.ai/mcp

door code

bf1d654dd596e706

protocol

http-sse ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is soundside-mcp live?

Yes — it answered the hub's last check (checked 1h ago). It answered 99% of checks over the last 30 days.

Is soundside-mcp free to use?

Yes — the hub reached it with no key and no payment.

What tools does soundside-mcp have?

21 tools: extract_media, lib_list, publish_content, lib_manage, lib_share, create_video, create_image, manage_adapter, ….

Is soundside-mcp safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• list_adapters reads open 3h ago

  List LoRA adapters mirrored into the Soundside library.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061

  {
    "type": "object",
    "title": "list_adaptersArguments",
    "properties": {
      "status": {
        "anyOf": [
          {
            "enum": [
              "uploading",
              "training",
              "selecting",
              "deploying",
              "deployed",
              "undeploying",
              "undeployed",
              "failed"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Status",
        "default": null,
        "description": "Optional adapter status filter"
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Optional project UUID filter"
      },
      "adapter_type": {
        "anyOf": [
          {
            "enum": [
              "character",
              "style",
              "effect",
              "transition"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Adapter Type",
        "default": null,
        "description": "Optional adapter type filter"
      }
    }
  }

  arguments 61 lines copy
• extract_media reads unknown 3h ago

  Extract from media: extract_frame, extract_frames, extract_audio. Returns resource_id(s).

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162

  {
    "type": "object",
    "title": "extract_mediaArguments",
    "required": [
      "action"
    ],
    "properties": {
      "name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Name",
        "default": null,
        "description": "Filename"
      },
      "tags": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Tags",
        "default": null,
        "description": "Tags"
      },
      "action": {
        "enum": [
          "extract_frame",
          "extract_frames",
          "extract_audio"
        ],
        "type": "string",
        "title": "Action",
        "description": "Extraction action"
      },
      "end_sec": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "End Sec",
        "default": null,
        "description": "End time"
      },
      "provider": {
        "type": "string",
        "const": "soundside.ai",
        "title": "Provider",
        "default": "soundside.ai",
        "description": "Provider"
      },
      "start_sec": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Start Sec",
        "default": null,
        "description": "Start time"
      },
      "timestamp": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Timestamp",
        "default": null,
        "description": "Frame timestamp (seconds)"
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Project UUID"
      },
      "resource_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Resource Id",
        "default": null,
        "description": "Source resource ID"
      },
      "collection_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Collection Id",
        "default": null,
        "description": "Collection UUID"
      },
      "frame_indices": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "integer"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Frame Indices",
        "default": null,
        "description": "Exact zero-based decoded frame indices (1-64 distinct values; extract_frames only)"
      },
      "frame_interval_sec": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Frame Interval Sec",
        "default": null,
        "description": "Frame interval (seconds)"
      }
    }
  }

  arguments 162 lines copy
• lib_list reads unknown 3h ago

  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.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272

  {
    "type": "object",
    "title": "lib_listArguments",
    "required": [
      "entity_type"
    ],
    "properties": {
      "tags": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Tags",
        "default": null,
        "description": "Filter by tags"
      },
      "limit": {
        "type": "integer",
        "title": "Limit",
        "default": 100,
        "description": "Max results (max 1000)"
      },
      "fields": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Fields",
        "default": null,
        "description": "Field whitelist"
      },
      "offset": {
        "type": "integer",
        "title": "Offset",
        "default": 0,
        "description": "Skip N results"
      },
      "search": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Search",
        "default": null,
        "description": "Name search"
      },
      "filters": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Filters",
        "default": null,
        "description": "Django-style filters"
      },
      "sort_by": {
        "enum": [
          "created_at",
          "name",
          "size_bytes"
        ],
        "type": "string",
        "title": "Sort By",
        "default": "created_at",
        "description": "Sort field"
      },
      "ids_only": {
        "type": "boolean",
        "title": "Ids Only",
        "default": false,
        "description": "IDs only"
      },
      "parent_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Parent Id",
        "default": null,
        "description": "Parent collection filter"
      },
      "sort_desc": {
        "type": "boolean",
        "title": "Sort Desc",
        "default": true,
        "description": "Sort descending"
      },
      "count_only": {
        "type": "boolean",
        "title": "Count Only",
        "default": false,
        "description": "Count only"
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Filter by project"
      },
      "entity_type": {
        "enum": [
          "projects",
          "collections",
          "resources",
          "lineage",
          "brand_kits",
          "credits",
          "dashboard"
        ],
        "type": "string",
        "title": "Entity Type",
        "description": "Entity type to list"
      },
      "resource_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Resource Id",
        "default": null,
        "description": "Single resource UUID"
      },
      "all_projects": {
        "type": "boolean",
        "title": "All Projects",
        "default": false,
        "description": "Search all projects"
      },
      "resource_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Resource Ids",
        "default": null,
        "description": "Specific resource UUIDs"
      },
      "collection_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Collection Id",
        "default": null,
        "description": "Filter by collection"
      },
      "include_stats": {
        "type": "boolean",
        "title": "Include Stats",
        "default": true,
        "description": "Include counts/sizes"
      },
      "search_fields": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Search Fields",
        "default": null,
        "description": "Search field scope"
      },
      "exclude_fields": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Exclude Fields",
        "default": null,
        "description": "Field blacklist"
      },
      "include_shares": {
        "type": "boolean",
        "title": "Include Shares",
        "default": false,
        "description": "Include sharing info"
      },
      "include_deleted": {
        "type": "boolean",
        "title": "Include Deleted",
        "default": false,
        "description": "Include deleted"
      },
      "mime_type_prefix": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Mime Type Prefix",
        "default": null,
        "description": "MIME prefix filter (e.g. 'video/')"
      },
      "include_resources": {
        "type": "boolean",
        "title": "Include Resources",
        "default": false,
        "description": "Include resources"
      },
      "include_subcollections": {
        "type": "boolean",
        "title": "Include Subcollections",
        "default": false,
        "description": "Include nested collections"
      }
    }
  }

  arguments 272 lines copy
• publish_content sends messages unknown never probed

  Read and manage a connected X account. action defaults to publish. Read actions return bounded posts/profiles and pagination tokens synchronously. Writes (publish/reply/edit/delete/like/unlike/repost/unrepost) require a unique idempotency_key and return a durable receipt: check its status with lib_list; a push may also arrive, but don't rely on it. Reuse a key only with the exact same request; never retry an unknown write using a new key. API-key/OAuth-client automation needs an explicit read, publish (publish/reply), or manage (other writes) grant. Authenticated credits only. Post text max 280 weighted characters; up to four owned JPEG/PNG/WEBP UUIDs (5 MiB each) or one MP4 UUID (512 MiB, 140s, H.264/yuv420p, AAC if audio). made_with_ai is a client choice, default true for compatibility. Editing is limited by X's live edit_controls; delete affects the edit chain. Self-service replies require X's mention/quote eligibility. No DMs/bookmarks. Examples: {"action":"get_account"}; {"action":"list_posts","limit":10}; {"idempotency_key":"film-1","text":"New film","made_with_ai":false}.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242

  {
    "type": "object",
    "title": "_annotated_publish_contentArguments",
    "properties": {
      "text": {
        "type": "string",
        "title": "Text",
        "default": "",
        "description": "Complete post text for publish/reply/edit; up to 280 weighted characters"
      },
      "limit": {
        "type": "integer",
        "title": "Limit",
        "default": 10,
        "maximum": 100,
        "minimum": 1,
        "description": "Page size, max 100. Posts/mentions min 5; recent search min 10; followers/following min 1. Ignored for direct lookups"
      },
      "query": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 512,
            "minLength": 1
          },
          {
            "type": "null"
          }
        ],
        "title": "Query",
        "default": null,
        "description": "search_posts only: X recent-search query (last 7 days); supports from:, to:, and operators"
      },
      "action": {
        "enum": [
          "publish",
          "reply",
          "edit",
          "delete",
          "like",
          "unlike",
          "repost",
          "unrepost",
          "get_account",
          "get_user",
          "get_posts",
          "list_posts",
          "list_mentions",
          "search_posts",
          "list_followers",
          "list_following"
        ],
        "type": "string",
        "title": "Action",
        "default": "publish",
        "description": "Read accounts/posts or publish, reply, edit, delete, like/unlike, repost/unrepost"
      },
      "post_id": {
        "anyOf": [
          {
            "type": "string",
            "pattern": "^[1-9][0-9]{0,18}$"
          },
          {
            "type": "null"
          }
        ],
        "title": "Post Id",
        "default": null,
        "description": "Numeric X post ID for reply/edit/delete/like/unlike/repost/unrepost, or one get_posts lookup"
      },
      "post_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 100,
            "minItems": 1
          },
          {
            "type": "null"
          }
        ],
        "title": "Post Ids",
        "default": null,
        "description": "get_posts: 1–100 distinct numeric X post IDs, exclusive with post_id"
      },
      "username": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 16,
            "minLength": 1
          },
          {
            "type": "null"
          }
        ],
        "title": "Username",
        "default": null,
        "description": "get_user only: X handle, with optional @; use either this or x_user_id"
      },
      "alt_texts": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 4
          },
          {
            "type": "null"
          }
        ],
        "title": "Alt Texts",
        "default": null,
        "description": "Image alt text aligned with resource_ids; max 1000 characters each"
      },
      "x_user_id": {
        "anyOf": [
          {
            "type": "string",
            "pattern": "^[1-9][0-9]{0,18}$"
          },
          {
            "type": "null"
          }
        ],
        "title": "X User Id",
        "default": null,
        "description": "Numeric X user ID for get_user or list_posts/followers/following; list actions default to the connected account"
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Owner-owned Soundside project UUID for the receipt or read accounting"
      },
      "destination": {
        "type": "string",
        "const": "x",
        "title": "Destination",
        "default": "x",
        "description": "Connected service; currently x only"
      },
      "made_with_ai": {
        "type": "boolean",
        "title": "Made With Ai",
        "default": true,
        "description": "Client-chosen AI disclosure for publish/reply/edit. True by legacy default; pass false to omit the label"
      },
      "resource_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 4
          },
          {
            "type": "null"
          }
        ],
        "title": "Resource Ids",
        "default": null,
        "description": "Owned library UUIDs: up to four images or one MP4, for publish/reply/edit"
      },
      "preserve_media": {
        "type": "boolean",
        "title": "Preserve Media",
        "default": true,
        "description": "edit only: preserve original media when safely possible. False replaces complete text/media; no resource_ids with true"
      },
      "reply_settings": {
        "anyOf": [
          {
            "enum": [
              "mentionedUsers",
              "following",
              "subscribers",
              "verified"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Reply Settings",
        "default": null,
        "description": "publish/reply: restrict who can reply; omit for X's default audience"
      },
      "idempotency_key": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 200,
            "minLength": 1
          },
          {
            "type": "null"
          }
        ],
        "title": "Idempotency Key",
        "default": null,
        "description": "Required for every write, omitted for reads. Reuse only for the exact same request"
      },
      "pagination_token": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 2048,
            "minLength": 1
          },
          {
            "type": "null"
          }
        ],
        "title": "Pagination Token",
        "default": null,
        "description": "Opaque next_pagination_token from the same action/filters; no automatic page traversal"
      },
      "include_private_metrics": {
        "type": "boolean",
        "title": "Include Private Metrics",
        "default": false,
        "description": "get_posts only: request own-post non-public/organic/promoted metrics where X permits"
      }
    },
    "additionalProperties": false
  }

  arguments 242 lines copy
• lib_manage changes data unknown never probed

  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.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298

  {
    "type": "object",
    "title": "lib_manage_toolArguments",
    "required": [
      "entity_type",
      "operation"
    ],
    "properties": {
      "name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Name",
        "default": null,
        "description": "Entity name"
      },
      "tags": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Tags",
        "default": null,
        "description": "Tags"
      },
      "filters": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Filters",
        "default": null,
        "description": "Batch filters"
      },
      "metadata": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Metadata",
        "default": null,
        "description": "Metadata"
      },
      "entity_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Entity Id",
        "default": null,
        "description": "Entity UUID (update/delete)"
      },
      "mime_type": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Mime Type",
        "default": null,
        "description": "MIME type"
      },
      "operation": {
        "enum": [
          "create",
          "update",
          "delete",
          "upload_initiate",
          "upload_complete"
        ],
        "type": "string",
        "title": "Operation",
        "description": "CRUD operation"
      },
      "parent_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Parent Id",
        "default": null,
        "description": "Parent collection UUID"
      },
      "permanent": {
        "type": "boolean",
        "title": "Permanent",
        "default": false,
        "description": "Hard delete"
      },
      "recursive": {
        "type": "boolean",
        "title": "Recursive",
        "default": true,
        "description": "Recursive delete"
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Project UUID"
      },
      "size_bytes": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Size Bytes",
        "default": null,
        "description": "File size (upload_initiate)"
      },
      "visibility": {
        "anyOf": [
          {
            "enum": [
              "private",
              "public"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Visibility",
        "default": null,
        "description": "Visibility: private or public"
      },
      "content_url": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Content Url",
        "default": null,
        "description": "URL to fetch"
      },
      "description": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Description",
        "default": null,
        "description": "Description"
      },
      "entity_type": {
        "enum": [
          "project",
          "collection",
          "resource",
          "brand_kit"
        ],
        "type": "string",
        "title": "Entity Type",
        "description": "Entity type"
      },
      "content_json": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Content Json",
        "default": null,
        "description": "JSON content"
      },
      "content_text": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Content Text",
        "default": null,
        "description": "Text content"
      },
      "resource_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Resource Ids",
        "default": null,
        "description": "Batch UUIDs"
      },
      "storage_path": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Storage Path",
        "default": null,
        "description": "Storage path (upload_complete)"
      },
      "collection_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Collection Id",
        "default": null,
        "description": "Collection UUID"
      },
      "content_base64": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Content Base64",
        "default": null,
        "description": "Base64 content (<5MB)"
      },
      "merge_metadata": {
        "type": "boolean",
        "title": "Merge Metadata",
        "default": true,
        "description": "Merge metadata"
      }
    }
  }

  arguments 298 lines copy
• lib_share changes data unknown never probed

  Manage project sharing: share by email, list shares, or revoke access. For download URLs, use lib_list with resource_id.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869

  {
    "type": "object",
    "title": "lib_share_toolArguments",
    "required": [
      "operation",
      "project_id"
    ],
    "properties": {
      "operation": {
        "enum": [
          "share",
          "list",
          "revoke"
        ],
        "type": "string",
        "title": "Operation",
        "description": "Share operation: share, list, or revoke"
      },
      "project_id": {
        "type": "string",
        "title": "Project Id",
        "description": "Project UUID to manage sharing for"
      },
      "user_email": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "User Email",
        "default": null,
        "description": "Email of user to share with (for share)"
      },
      "permission_level": {
        "anyOf": [
          {
            "enum": [
              "view",
              "edit",
              "admin"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Permission Level",
        "default": null,
        "description": "Permission level to grant"
      },
      "user_id_to_revoke": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "User Id To Revoke",
        "default": null,
        "description": "User ID to revoke access (for revoke)"
      }
    }
  }

  arguments 69 lines copy
• create_video reads unknown never probed

  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.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217

  {
    "type": "object",
    "title": "create_videoArguments",
    "required": [
      "provider",
      "prompt"
    ],
    "properties": {
      "name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Name",
        "default": null,
        "description": "Filename"
      },
      "tags": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Tags",
        "default": null,
        "description": "Tags"
      },
      "prompt": {
        "type": "string",
        "title": "Prompt",
        "description": "Video content description"
      },
      "provider": {
        "enum": [
          "minimax",
          "vertex",
          "grok",
          "creative_freedom",
          "alibaba"
        ],
        "type": "string",
        "title": "Provider",
        "description": "AI provider"
      },
      "adapter_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Adapter Id",
        "default": null,
        "description": "(Deprecated) Single adapter ID"
      },
      "last_frame": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Last Frame",
        "default": null,
        "description": "Resource ID/URL for last frame"
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Project UUID"
      },
      "adapter_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Adapter Ids",
        "default": null,
        "description": "LoRA adapters: [{id, weight}]. Must be deployed."
      },
      "first_frame": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "First Frame",
        "default": null,
        "description": "Resource ID/URL for I2V first frame"
      },
      "input_audio": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Input Audio",
        "default": null,
        "description": "Resource ID/URL for audio input"
      },
      "input_video": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Input Video",
        "default": null,
        "description": "Resource ID/URL for V2V input"
      },
      "resource_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Resource Id",
        "default": null,
        "description": "Alias for first_frame"
      },
      "extend_video": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Extend Video",
        "default": null,
        "description": "Video resource ID/URL to extend"
      },
      "collection_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Collection Id",
        "default": null,
        "description": "Collection UUID"
      },
      "advanced_options": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Advanced Options",
        "default": null,
        "description": "Provider-specific settings"
      },
      "character_reference": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Character Reference",
        "default": null,
        "description": "Character reference image resource ID/URL"
      }
    }
  }

  arguments 217 lines copy
• create_image reads unknown never probed

  Create image from text prompt or reference. Sync (vertex, minimax, grok, creative_freedom) or async (alibaba — poll with lib_list).

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109

  {
    "type": "object",
    "title": "create_imageArguments",
    "required": [
      "provider",
      "prompt"
    ],
    "properties": {
      "name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Name",
        "default": null,
        "description": "Filename"
      },
      "tags": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Tags",
        "default": null,
        "description": "Tags"
      },
      "prompt": {
        "type": "string",
        "title": "Prompt",
        "description": "Image content description"
      },
      "provider": {
        "enum": [
          "minimax",
          "vertex",
          "grok",
          "creative_freedom",
          "alibaba"
        ],
        "type": "string",
        "title": "Provider",
        "description": "AI provider"
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Project UUID"
      },
      "collection_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Collection Id",
        "default": null,
        "description": "Collection UUID"
      },
      "advanced_options": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Advanced Options",
        "default": null,
        "description": "Provider-specific settings"
      },
      "character_reference": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Character Reference",
        "default": null,
        "description": "Character reference image resource ID/URL"
      }
    }
  }

  arguments 109 lines copy
• manage_adapter changes data unknown never probed

  Manage a LoRA adapter: inspect, deploy, undeploy, delete, or select_checkpoint.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940

  {
    "type": "object",
    "title": "manage_adapterArguments",
    "required": [
      "adapter_id",
      "action"
    ],
    "properties": {
      "action": {
        "enum": [
          "inspect",
          "deploy",
          "undeploy",
          "delete",
          "select_checkpoint"
        ],
        "type": "string",
        "title": "Action",
        "description": "Lifecycle action: inspect, deploy, undeploy, delete, or select_checkpoint"
      },
      "adapter_id": {
        "type": "string",
        "title": "Adapter Id",
        "description": "Adapter resource UUID"
      },
      "checkpoint": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Checkpoint",
        "default": null,
        "description": "Checkpoint name/id to export when action=select_checkpoint"
      }
    }
  }

  arguments 40 lines copy
• edit_video reads unknown never probed

  Edit video: trim, concat, crossfade, adjust_speed, loop, color_grade, custom, burn_subtitles. Returns resource_id of new media.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329

  {
    "type": "object",
    "title": "edit_videoArguments",
    "required": [
      "action"
    ],
    "properties": {
      "name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Name",
        "default": null,
        "description": "Filename"
      },
      "tags": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Tags",
        "default": null,
        "description": "Tags"
      },
      "action": {
        "enum": [
          "trim",
          "concat",
          "crossfade",
          "adjust_speed",
          "loop",
          "color_grade",
          "custom",
          "burn_subtitles"
        ],
        "type": "string",
        "title": "Action",
        "description": "Edit action"
      },
      "factor": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Factor",
        "default": null,
        "description": "Speed factor"
      },
      "smooth": {
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ],
        "title": "Smooth",
        "default": null,
        "description": "Frame interpolation for slow-mo"
      },
      "contrast": {
        "anyOf": [
          {
            "type": "number",
            "maximum": 4,
            "minimum": 0.25
          },
          {
            "type": "null"
          }
        ],
        "title": "Contrast",
        "default": null,
        "description": "Contrast multiplier from 0.25 to 4.0; 1.0 is neutral. Values below 1.0 reduce contrast."
      },
      "provider": {
        "type": "string",
        "const": "soundside.ai",
        "title": "Provider",
        "default": "soundside.ai",
        "description": "Provider"
      },
      "start_sec": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Start Sec",
        "default": null,
        "description": "Start time (trim)"
      },
      "brightness": {
        "anyOf": [
          {
            "type": "number",
            "maximum": 1,
            "minimum": -1
          },
          {
            "type": "null"
          }
        ],
        "title": "Brightness",
        "default": null,
        "description": "Additive brightness adjustment from -1.0 to 1.0; 0.0 is neutral"
      },
      "frame_rate": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Frame Rate",
        "default": null,
        "description": "Frame rate (concat)"
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Project UUID"
      },
      "resolution": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Resolution",
        "default": null,
        "description": "Output resolution WxH"
      },
      "saturation": {
        "anyOf": [
          {
            "type": "number",
            "maximum": 3,
            "minimum": 0
          },
          {
            "type": "null"
          }
        ],
        "title": "Saturation",
        "default": null,
        "description": "Saturation multiplier from 0.0 to 3.0; 1.0 is neutral and 0.0 is grayscale"
      },
      "transition": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Transition",
        "default": null,
        "description": "Transition type"
      },
      "ffmpeg_args": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ffmpeg Args",
        "default": null,
        "description": "Custom FFmpeg args"
      },
      "resource_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Resource Id",
        "default": null,
        "description": "Source resource ID"
      },
      "crossfade_ms": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Crossfade Ms",
        "default": null,
        "description": "Audio seam smoothing (ms)"
      },
      "duration_sec": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Duration Sec",
        "default": null,
        "description": "Duration (trim, crossfade)"
      },
      "pixel_format": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Pixel Format",
        "default": null,
        "description": "Pixel format (concat)"
      },
      "resource_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Resource Ids",
        "default": null,
        "description": "Multi-source IDs (concat, crossfade)"
      },
      "collection_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Collection Id",
        "default": null,
        "description": "Collection UUID"
      },
      "output_format": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Output Format",
        "default": null,
        "description": "Output format"
      },
      "subtitle_source": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Subtitle Source",
        "default": null,
        "description": "Subtitle resource ID/URL (SRT/ASS/VTT)"
      },
      "target_duration": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Target Duration",
        "default": null,
        "description": "Target duration (loop)"
      }
    }
  }

  arguments 329 lines copy
• compose_media reads unknown never probed

  Layer text, images, or video onto a base video: add_text, overlay, split_screen. Returns resource_id.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372

  {
    "type": "object",
    "title": "compose_mediaArguments",
    "required": [
      "action"
    ],
    "properties": {
      "x": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "X",
        "default": null,
        "description": "Text X position (px)"
      },
      "y": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Y",
        "default": null,
        "description": "Text Y position (px)"
      },
      "gap": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Gap",
        "default": null,
        "description": "Panel gap (px)"
      },
      "name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Name",
        "default": null,
        "description": "Filename"
      },
      "tags": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Tags",
        "default": null,
        "description": "Tags"
      },
      "text": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Text",
        "default": null,
        "description": "Text to overlay"
      },
      "action": {
        "enum": [
          "add_text",
          "overlay",
          "split_screen"
        ],
        "type": "string",
        "title": "Action",
        "description": "Compositing action"
      },
      "labels": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Labels",
        "default": null,
        "description": "Panel labels"
      },
      "layout": {
        "anyOf": [
          {
            "enum": [
              "horizontal",
              "vertical",
              "grid"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Layout",
        "default": null,
        "description": "Split-screen layout"
      },
      "fontsize": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Fontsize",
        "default": null,
        "description": "Font size"
      },
      "position": {
        "anyOf": [
          {
            "enum": [
              "top",
              "bottom",
              "center",
              "top_left",
              "top_right",
              "bottom_left",
              "bottom_right"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Position",
        "default": null,
        "description": "Named text position"
      },
      "provider": {
        "type": "string",
        "const": "soundside.ai",
        "title": "Provider",
        "default": "soundside.ai",
        "description": "Provider"
      },
      "fontcolor": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Fontcolor",
        "default": null,
        "description": "Font color"
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Project UUID"
      },
      "resolution": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Resolution",
        "default": null,
        "description": "Output resolution WxH"
      },
      "resource_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Resource Id",
        "default": null,
        "description": "Source resource ID"
      },
      "resource_ids": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Resource Ids",
        "default": null,
        "description": "Multi-source IDs (split_screen)"
      },
      "text_end_sec": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Text End Sec",
        "default": null,
        "description": "Text disappear time"
      },
      "collection_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Collection Id",
        "default": null,
        "description": "Collection UUID"
      },
      "overlay_scale": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Overlay Scale",
        "default": null,
        "description": "Overlay scale 0.1-0.9"
      },
      "text_overlays": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Text Overlays",
        "default": null,
        "description": "Batch text overlays list (alternative to single text param)"
      },
      "overlay_border": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Overlay Border",
        "default": null,
        "description": "Overlay border (px)"
      },
      "overlay_source": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Overlay Source",
        "default": null,
        "description": "Overlay resource ID"
      },
      "text_start_sec": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Text Start Sec",
        "default": null,
        "description": "Text appear time"
      },
      "overlay_opacity": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Overlay Opacity",
        "default": null,
        "description": "Overlay opacity 0-1"
      },
      "overlay_position": {
        "anyOf": [
          {
            "enum": [
              "top_left",
              "top_right",
              "bottom_left",
              "bottom_right",
              "center"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Overlay Position",
        "default": null,
        "description": "Overlay position"
      }
    }
  }

  arguments 372 lines copy
• edit_audio reads unknown never probed

  Edit audio on video: mix_audio, replace_audio, pad_audio. Returns resource_id.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195

  {
    "type": "object",
    "title": "edit_audioArguments",
    "required": [
      "action"
    ],
    "properties": {
      "name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Name",
        "default": null,
        "description": "Filename"
      },
      "tags": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Tags",
        "default": null,
        "description": "Tags"
      },
      "action": {
        "enum": [
          "mix_audio",
          "replace_audio",
          "pad_audio"
        ],
        "type": "string",
        "title": "Action",
        "description": "Audio action"
      },
      "provider": {
        "type": "string",
        "const": "soundside.ai",
        "title": "Provider",
        "default": "soundside.ai",
        "description": "Provider"
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Project UUID"
      },
      "resource_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Resource Id",
        "default": null,
        "description": "Source resource ID"
      },
      "audio_source": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Audio Source",
        "default": null,
        "description": "Audio resource ID/URL to mix/replace"
      },
      "video_volume": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Video Volume",
        "default": null,
        "description": "Video volume 0-2"
      },
      "collection_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Collection Id",
        "default": null,
        "description": "Collection UUID"
      },
      "duration_mode": {
        "anyOf": [
          {
            "enum": [
              "shortest",
              "longest",
              "first"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Duration Mode",
        "default": null,
        "description": "Duration mode"
      },
      "audio_position": {
        "anyOf": [
          {
            "enum": [
              "center",
              "start",
              "end"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Audio Position",
        "default": null,
        "description": "Audio position (pad_audio)"
      },
      "overlay_volume": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Overlay Volume",
        "default": null,
        "description": "Overlay volume 0-2"
      },
      "audio_delay_sec": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Audio Delay Sec",
        "default": null,
        "description": "Audio delay (seconds)"
      },
      "target_duration": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Target Duration",
        "default": null,
        "description": "Target duration (pad_audio)"
      }
    }
  }

  arguments 195 lines copy
• remix_video reads unknown never probed

  Shot-for-shot video reskin or recast ("remix") of a film you own. Detects cuts in an owned video, shares cast and setting references across shots, transforms the cast and world (mode="reskin") or the performers alone (mode="recast"), normalizes clips and verifies the delivered frame count, and restores the original soundtrack. It preserves edit boundaries and duration; fidelity of generated motion, mouths, hands and lettering is checked rather than guaranteed. It does not clone or replace voices. Import a direct video URL into your library with lib_manage(content_url=...) first. Two recipes, chosen with `recipe`: - `recipe="source_edit"` (default): edit each source shot with shared references, check it against source frames, and attempt targeted repairs within the quoted allowance. The best take is retained. Remaining shot defects are named in `needs_review`. The final synchronized source-left/result-right video is reviewed at 4 sampled frames/second in windows up to 10 seconds; its findings are in `delivery_review` and `unresolved_defects`. Review the full film yourself before publishing. - `recipe="keyframe"`: restyled source stills per action, interpolated by a video model, judged and repaired. It generates motion between stills; `engine_overrides` applies only here. Requires `rights_attested=true`: you are attesting you hold the rights to remix the source. The call is refused otherwise. Async: returns a pending resource_id immediately; the job runs in the background. Check completion with `lib_list` (the resource's status); once it completes, its side-by-side comparison and JSON delivery report are ready too. A `notifications/resources/updated` push may also arrive while your client holds a stream, but don't rely on it. Quote first: `estimate_only=true` returns metadata.quote.total_credits, metadata.shot_plan, metadata.quote_token and metadata.quote_expires_at. Source analysis (probe, cut detection, frame extraction and a capped visual scan) is billed separately even if you do not start a run. Buy the quote within 24 hours using the SAME source, brief and creative settings, quote_token, estimate_only=false, and budget_cap_credits no greater than the accepted quote. The token is account-bound, reuses the frozen plan without reanalysis, and retries return the same parent. Changed creative settings or expired/tampered tokens require a new quote. A concurrent purchase returns retryable QUOTE_BUSY. Pricing: one credit is $0.01. Recast service is 20 credits per newly transformed source second, 200-credit minimum, plus metered processing. Unchanged and source-fallback footage is excluded; reassembly has no service fee. The service fee is waived when final review is incomplete or has unresolved defects. Processing still applies. The account must cover the quoted ceiling; each child operation reserves within that ceiling and unused allowance is not charged. The report separates processing_credits and service_fee_credits. Legacy jobs keep their accepted fee. Authenticated credits only; direct x402 payment is not supported. Revision: pass `revise_from=<parent remix UUID>` (owner-only, requires `brief=""`) with `regenerate_actions` naming which actions to redo; empty/omitted `regenerate_actions` means pure re-assembly of the parent's already-accepted clips. A revision always keeps the parent's recipe. Example (quote only): remix_video(source_resource_id="<uuid>", brief="A neon-drenched cyberpunk world", rights_attested=true, estimate_only=true) Example (buy that quote): remix_video(source_resource_id="<uuid>", brief="A neon-drenched cyberpunk world", rights_attested=true, quote_token="<metadata.quote_token>", budget_cap_credits=<metadata.quote.total_credits>) Example (the older keyframe recipe): remix_video(source_resource_id="<uuid>", brief="A neon-drenched cyberpunk world", recipe="keyframe", rights_attested=true)

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256

  {
    "type": "object",
    "title": "remix_videoArguments",
    "required": [
      "source_resource_id",
      "brief",
      "rights_attested"
    ],
    "properties": {
      "mode": {
        "enum": [
          "reskin",
          "recast"
        ],
        "type": "string",
        "title": "Mode",
        "default": "reskin",
        "description": "What changes. 'reskin' (default): replace the world and the cast. 'recast': keep the source world and lighting and swap only the on-screen performer. Independent of `recipe`, which decides HOW each shot is regenerated."
      },
      "tags": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Tags",
        "default": null,
        "description": "Tags merged with the server's remix/final tags."
      },
      "brief": {
        "type": "string",
        "title": "Brief",
        "description": "Target world and cast, in prose (e.g. \"A neon cyberpunk city, the mechanic is now a cybernetic courier\"). Must be \"\" when `revise_from` is set — the revision reuses the parent's bible."
      },
      "recipe": {
        "enum": [
          "source_edit",
          "keyframe"
        ],
        "type": "string",
        "title": "Recipe",
        "default": "source_edit",
        "description": "How each shot is regenerated. 'source_edit' (default): one source-conditioned edit call per true shot — the shot's own frames go to the engine with one written instruction, using the real camera move, blocking and lettering as guidance. No 4s action cap (a shot over the engine's 15s per-call maximum is split into provider chunks, not cuts). Each shot is then checked column-by-column against its own source frames, failing shots are re-rolled from a fixed repair table within a quoted reserve, and the best take is retained, with remaining defects disclosed. 'keyframe': the older recipe — two restyled stills per action, interpolated by a keyframe video model, judged and repaired. Dearer and it invents the motion between the stills, but it needs no source-conditioned engine, and `engine_overrides` applies only to it."
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Project UUID. Auto-created if omitted."
      },
      "quote_token": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 2048
          },
          {
            "type": "null"
          }
        ],
        "title": "Quote Token",
        "default": null,
        "description": "Purchase token returned by estimate_only. Valid for 24 hours and this account's exact source, brief and creative settings. Reuses the frozen plan without reanalysis and enforces its price ceiling. Retrying the same token returns the same job, never a second generation. Omit for a fresh unquoted run. Not used with revisions."
      },
      "revise_from": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Revise From",
        "default": null,
        "description": "Parent remix resource UUID to revise. Owner-only. Requires brief=\"\"; mutually exclusive with `reassemble_only`."
      },
      "collection_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Collection Id",
        "default": null,
        "description": "Caller-owned collection UUID. Must belong to the selected project."
      },
      "estimate_only": {
        "type": "boolean",
        "title": "Estimate Only",
        "default": false,
        "description": "Probe + detect + plan + quote, persist the plan, and return the quote. Creates no parent, no admission slot, no root fee charge. NOT FREE: it pays for the probe, the shot detection, and — on the source_edit recipe — a capped scan of the long takes to find where they change place or wardrobe, which is what makes the returned plan the one a real run would execute. That scan is bounded per job and is reused by a later run of the same source and range, so it is paid once. `budget_cap_credits` is checked before the scan runs."
      },
      "range_end_sec": {
        "anyOf": [
          {
            "type": "number",
            "minimum": 0
          },
          {
            "type": "null"
          }
        ],
        "title": "Range End Sec",
        "default": null,
        "description": "Sub-range end, in source seconds. Defaults to the end of the film."
      },
      "collection_name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Collection Name",
        "default": null,
        "description": "Override the auto-generated collection name."
      },
      "quality_profile": {
        "enum": [
          "draft",
          "standard",
          "premium"
        ],
        "type": "string",
        "title": "Quality Profile",
        "default": "standard",
        "description": "Resolution and repair-budget tier: draft (480p, no automatic repair), standard (720p, 1 repair wave), premium (1080p, 2 repair waves). Every profile runs to completion unattended; none of them pauses for confirmation."
      },
      "range_start_sec": {
        "anyOf": [
          {
            "type": "number",
            "minimum": 0
          },
          {
            "type": "null"
          }
        ],
        "title": "Range Start Sec",
        "default": null,
        "description": "Sub-range start, in source seconds. Defaults to the start of the film."
      },
      "reassemble_only": {
        "type": "boolean",
        "title": "Reassemble Only",
        "default": false,
        "description": "Re-verify, assemble, compare and report from an existing checkpoint; no generation. Mutually exclusive with `revise_from`."
      },
      "rights_attested": {
        "type": "boolean",
        "title": "Rights Attested",
        "description": "Must be true. You are attesting that you hold the rights to remix the source film. The call is refused with a clear error when this is not true."
      },
      "engine_overrides": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Engine Overrides",
        "default": null,
        "description": "Force an engine for one action_id, or every action via the key \"*\". recipe='keyframe' only — refused with INVALID_PARAMS on a source-edit job, which has exactly one engine. A bake-off-rejected engine (grok_edit) and wan3_edit (the source-edit recipe's own engine) are both refused. wan_vace is policy-gated (RemixEnginePolicy.vace_scope) rather than rejected: an explicit override here still honours it."
      },
      "max_shot_seconds": {
        "anyOf": [
          {
            "type": "number",
            "exclusiveMinimum": 0
          },
          {
            "type": "null"
          }
        ],
        "title": "Max Shot Seconds",
        "default": null,
        "description": "Per-action duration ceiling. Omit to take the recipe's own default: 4.0s for recipe='keyframe' (so no action is long enough for a first/last-frame engine to invent unrelated content mid-clip), 15.0s for recipe='source_edit' (wan3.0-video's per-call maximum; a longer shot is divided into provider chunks rather than cut). A larger value on recipe='source_edit' is CLAMPED to that maximum and the quote says so, rather than being refused."
      },
      "reference_images": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Reference Images",
        "default": null,
        "description": "Caller design references (style/character boards), up to 8 owned image resource UUIDs."
      },
      "budget_cap_credits": {
        "anyOf": [
          {
            "type": "integer",
            "minimum": 0
          },
          {
            "type": "null"
          }
        ],
        "title": "Budget Cap Credits",
        "default": null,
        "description": "Hard run ceiling in credits. A quote above this is refused before generation (INVALID_PARAMS). Quote preparation has separately billed source analysis."
      },
      "regenerate_actions": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Regenerate Actions",
        "default": null,
        "description": "With `revise_from`: action ids to regenerate. Empty/omitted means pure reassembly of the parent's already-accepted clips."
      },
      "source_resource_id": {
        "type": "string",
        "title": "Source Resource Id",
        "description": "The caller's film to remix. Must be a completed, owned video resource UUID."
      }
    },
    "additionalProperties": false
  }

  arguments 256 lines copy
• create_artifact reads unknown never probed

  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.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296

  {
    "type": "object",
    "title": "create_artifactArguments",
    "required": [
      "type"
    ],
    "properties": {
      "data": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Data",
        "default": null,
        "description": "(chart) Chart data: {x, y, labels} for bar/line/area; {labels, values} for pie; {z, x_labels, y_labels} for heatmap."
      },
      "name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Name",
        "default": null,
        "description": "Custom filename for the generated artifact."
      },
      "tags": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Tags",
        "default": null,
        "description": "Tags for filtering and organization."
      },
      "type": {
        "enum": [
          "presentation",
          "chart",
          "document",
          "diagram"
        ],
        "type": "string",
        "title": "Type",
        "description": "Artifact type to generate"
      },
      "brand": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Brand",
        "default": null,
        "description": "Brand kit name for consistent styling. Use lib_list(entity_type='brand_kits') to see available kits."
      },
      "brief": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Brief",
        "default": null,
        "description": "(bundle mode) High-level description. Used to auto-generate slides/sections when not explicitly provided."
      },
      "title": {
        "type": "string",
        "title": "Title",
        "default": "",
        "description": "Artifact title"
      },
      "width": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Width",
        "default": null,
        "description": "(chart, diagram) Output width in pixels. Default 1200."
      },
      "height": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Height",
        "default": null,
        "description": "(chart, diagram) Output height in pixels. Default 800."
      },
      "slides": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Slides",
        "default": null,
        "description": "(presentation) Slide objects with layout, title, content, notes, image_resource_id, chart_resource_id."
      },
      "outputs": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "enum": [
                "pptx",
                "pdf",
                "docx",
                "png",
                "svg",
                "html"
              ],
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Outputs",
        "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."
      },
      "provider": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Provider",
        "default": null,
        "description": "Provider override. Default: local rendering (pptx/plotly/docx/mermaid). Use 'gamma' for premium AI-generated presentations."
      },
      "sections": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Sections",
        "default": null,
        "description": "(document) Section objects with heading, content, level, table, image_resource_id."
      },
      "template": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Template",
        "default": null,
        "description": "Template name. Presentations: 'default', 'pitch_deck'. Documents: 'report'."
      },
      "chart_type": {
        "anyOf": [
          {
            "enum": [
              "bar",
              "line",
              "pie",
              "scatter",
              "area",
              "heatmap",
              "treemap"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Chart Type",
        "default": null,
        "description": "(chart only) Chart type."
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Library project UUID. If omitted, uses the user's default project."
      },
      "aspect_ratio": {
        "anyOf": [
          {
            "enum": [
              "16:9",
              "4:3"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Aspect Ratio",
        "default": null,
        "description": "(presentation only) Slide dimensions. Default 16:9."
      },
      "diagram_code": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Diagram Code",
        "default": null,
        "description": "(diagram) Mermaid syntax string."
      },
      "collection_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Collection Id",
        "default": null,
        "description": "Library collection UUID within the project."
      },
      "output_format": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Output Format",
        "default": null,
        "description": "Chart: html|png|svg. Document: docx|pdf|html. Diagram: png|svg. Presentation: always pptx."
      }
    }
  }

  arguments 296 lines copy
• train_adapter changes data unknown never probed

  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).

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118

  {
    "type": "object",
    "title": "train_adapterArguments",
    "required": [
      "name",
      "adapter_type",
      "training_data"
    ],
    "properties": {
      "name": {
        "type": "string",
        "title": "Name",
        "description": "Adapter display name"
      },
      "backend": {
        "anyOf": [
          {
            "enum": [
              "dashscope",
              "modal"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Backend",
        "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."
      },
      "base_model": {
        "type": "string",
        "title": "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."
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Library project UUID. Defaults to the caller's current project."
      },
      "auto_deploy": {
        "type": "boolean",
        "title": "Auto Deploy",
        "default": true,
        "description": "Automatically deploy the trained adapter when the training job succeeds"
      },
      "adapter_type": {
        "enum": [
          "character",
          "style",
          "effect",
          "transition"
        ],
        "type": "string",
        "title": "Adapter Type",
        "description": "What this adapter represents: character, style, effect, or transition"
      },
      "trigger_word": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Trigger Word",
        "default": null,
        "description": "Optional trigger token injected into prompts during generation"
      },
      "training_data": {
        "type": "array",
        "items": {
          "type": "object",
          "additionalProperties": true
        },
        "title": "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."
      },
      "prompt_template": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Prompt Template",
        "default": null,
        "description": "Optional deployment-time prompt template. Supports {prompt}, {input_prompt}, and {trigger_word}."
      },
      "hyper_parameters": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Hyper Parameters",
        "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)."
      }
    }
  }

  arguments 118 lines copy
• create_audio reads unknown never probed

  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.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367

  {
    "type": "object",
    "title": "create_audioArguments",
    "required": [
      "provider"
    ],
    "properties": {
      "vol": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Vol",
        "default": null,
        "description": "Volume"
      },
      "loop": {
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ],
        "title": "Loop",
        "default": null,
        "description": "Loop sound effect"
      },
      "mode": {
        "enum": [
          "tts",
          "sound_effect",
          "transcribe",
          "voice_clone",
          "voice_design",
          "list_voices"
        ],
        "type": "string",
        "title": "Mode",
        "default": "tts",
        "description": "Generation mode. 'transcribe' is deprecated; use analyze_media(analysis_type='transcribe')."
      },
      "name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Name",
        "default": null,
        "description": "Filename"
      },
      "tags": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Tags",
        "default": null,
        "description": "Tags"
      },
      "model": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Model",
        "default": null,
        "description": "Model override"
      },
      "pitch": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Pitch",
        "default": null,
        "description": "Pitch"
      },
      "speed": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Speed",
        "default": null,
        "description": "Speech speed"
      },
      "format": {
        "anyOf": [
          {
            "enum": [
              "pcm",
              "mp3",
              "flac",
              "wav"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Format",
        "default": null,
        "description": "Output format"
      },
      "prompt": {
        "type": "string",
        "title": "Prompt",
        "default": "",
        "description": "TTS text or sound effect description"
      },
      "source": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Source",
        "default": null,
        "description": "Transcription source resource ID/URL"
      },
      "bitrate": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Bitrate",
        "default": null,
        "description": "Bitrate"
      },
      "channel": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Channel",
        "default": null,
        "description": "Channels (1 or 2)"
      },
      "duration": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Duration",
        "default": null,
        "description": "Sound effect duration (seconds)"
      },
      "provider": {
        "enum": [
          "minimax",
          "vertex",
          "creative_freedom",
          "runway",
          "grok"
        ],
        "type": "string",
        "title": "Provider",
        "description": "AI provider. runway for sound effects, others for TTS."
      },
      "voice_id": {
        "type": "string",
        "title": "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)"
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Project UUID"
      },
      "voice_type": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Voice Type",
        "default": null,
        "description": "Voice type filter (list_voices)"
      },
      "sample_rate": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Sample Rate",
        "default": null,
        "description": "Sample rate (Hz)"
      },
      "preview_text": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Preview Text",
        "default": null,
        "description": "Voice design preview text"
      },
      "audio_file_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Audio File Id",
        "default": null,
        "description": "Voice cloning source resource ID"
      },
      "collection_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Collection Id",
        "default": null,
        "description": "Collection UUID"
      },
      "language_code": {
        "type": "string",
        "title": "Language Code",
        "default": "en-US",
        "description": "Transcription language"
      },
      "advanced_options": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Advanced Options",
        "default": null,
        "description": "Provider-specific settings"
      },
      "subtitle_formats": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "enum": [
                "srt",
                "vtt"
              ],
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Subtitle Formats",
        "default": null,
        "description": "Subtitle sidecars to persist for transcription"
      },
      "enable_diarization": {
        "type": "boolean",
        "title": "Enable Diarization",
        "default": false,
        "description": "Speaker identification for transcription"
      },
      "prompt_audio_file_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Prompt Audio File Id",
        "default": null,
        "description": "Voice design prompt resource ID"
      },
      "silence_threshold_sec": {
        "type": "number",
        "title": "Silence Threshold Sec",
        "default": 1,
        "description": "Minimum silence gap in seconds"
      },
      "include_word_timestamps": {
        "type": "boolean",
        "title": "Include Word Timestamps",
        "default": true,
        "description": "Word-level timestamps"
      },
      "enable_silence_detection": {
        "type": "boolean",
        "title": "Enable Silence Detection",
        "default": false,
        "description": "Persist silence markers in transcription"
      }
    }
  }

  arguments 367 lines copy
• create_music reads unknown never probed

  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.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220

  {
    "type": "object",
    "title": "create_musicArguments",
    "required": [
      "provider"
    ],
    "properties": {
      "name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Name",
        "default": null,
        "description": "Custom filename"
      },
      "tags": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Tags",
        "default": null,
        "description": "Tags for filtering"
      },
      "model": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Model",
        "default": null,
        "description": "Model name override"
      },
      "format": {
        "anyOf": [
          {
            "enum": [
              "mp3",
              "wav",
              "pcm"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Format",
        "default": null,
        "description": "Output audio format"
      },
      "lyrics": {
        "type": "string",
        "title": "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."
      },
      "prompt": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Prompt",
        "default": null,
        "description": "Style/genre description. Required for instrumental generation."
      },
      "bitrate": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Bitrate",
        "default": null,
        "description": "Audio bitrate"
      },
      "duration": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Duration",
        "default": null,
        "description": "Target duration in seconds. Used only by Lyria as a prompt hint. Creative Freedom takes duration via advanced_options.duration."
      },
      "provider": {
        "enum": [
          "creative_freedom",
          "lyria"
        ],
        "type": "string",
        "title": "Provider",
        "description": "AI provider for music generation. Lyria is synchronous; Creative Freedom is authenticated-only and asynchronous."
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Library project UUID"
      },
      "sample_rate": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Sample Rate",
        "default": null,
        "description": "Audio sample rate (Hz)"
      },
      "collection_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Collection Id",
        "default": null,
        "description": "Library collection UUID"
      },
      "is_instrumental": {
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ],
        "title": "Is Instrumental",
        "default": null,
        "description": "Generate instrumental music (no vocals). When True, lyrics are not required and prompt is required."
      },
      "advanced_options": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Advanced Options",
        "default": null,
        "description": "Provider-specific settings dict"
      },
      "reference_audio_purpose": {
        "anyOf": [
          {
            "enum": [
              "song",
              "voice",
              "instrumental"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Reference Audio Purpose",
        "default": null,
        "description": "Purpose of reference audio"
      },
      "reference_audio_resource_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Reference Audio Resource Id",
        "default": null,
        "description": "Resource ID for reference audio"
      }
    }
  }

  arguments 220 lines copy
• create_text reads unknown never probed

  Generate text via LLM chat completions. Pass messages or prompt.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115

  {
    "type": "object",
    "title": "create_textArguments",
    "properties": {
      "model": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Model",
        "default": null,
        "description": "Model name override"
      },
      "prompt": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Prompt",
        "default": null,
        "description": "Single prompt (alternative to messages)"
      },
      "messages": {
        "type": "array",
        "items": {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          }
        },
        "title": "Messages",
        "default": [],
        "description": "Chat messages with role and content"
      },
      "provider": {
        "enum": [
          "minimax",
          "vertex",
          "grok",
          "qwen"
        ],
        "type": "string",
        "title": "Provider",
        "default": "vertex",
        "description": "AI provider for text generation"
      },
      "max_tokens": {
        "type": "integer",
        "title": "Max Tokens",
        "default": 512,
        "description": "Maximum tokens to generate"
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Library project UUID"
      },
      "json_schema": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Json Schema",
        "default": null,
        "description": "JSON schema for structured output"
      },
      "temperature": {
        "type": "number",
        "title": "Temperature",
        "default": 0.7,
        "description": "Sampling temperature (0-2)"
      },
      "store_response": {
        "type": "boolean",
        "title": "Store Response",
        "default": false,
        "description": "Store response as library resource"
      },
      "advanced_options": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Advanced Options",
        "default": null,
        "description": "Provider-specific settings dict"
      }
    }
  }

  arguments 115 lines copy
• apply_effect reads unknown never probed

  Cinematic effects: ken_burns (image→video motion), speed_ramp, film_grain, vignette. Returns resource_id.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268

  {
    "type": "object",
    "title": "apply_effectArguments",
    "required": [
      "action"
    ],
    "properties": {
      "fps": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Fps",
        "default": null,
        "description": "FPS"
      },
      "name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Name",
        "default": null,
        "description": "Filename"
      },
      "tags": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Tags",
        "default": null,
        "description": "Tags"
      },
      "action": {
        "enum": [
          "ken_burns",
          "speed_ramp",
          "film_grain",
          "vignette"
        ],
        "type": "string",
        "title": "Action",
        "description": "Effect"
      },
      "easing": {
        "anyOf": [
          {
            "enum": [
              "linear",
              "ease_in_out_sine",
              "ease_out_cubic",
              "ease_in_out_cubic"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Easing",
        "default": null,
        "description": "Easing curve"
      },
      "provider": {
        "type": "string",
        "const": "soundside.ai",
        "title": "Provider",
        "default": "soundside.ai",
        "description": "Provider"
      },
      "zoom_end": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Zoom End",
        "default": null,
        "description": "End zoom (ken_burns)"
      },
      "speed_end": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Speed End",
        "default": null,
        "description": "End speed 0.25-4.0"
      },
      "ai_enhance": {
        "anyOf": [
          {
            "type": "boolean"
          },
          {
            "type": "null"
          }
        ],
        "title": "Ai Enhance",
        "default": null,
        "description": "AI subject tracking (GPU)"
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Project UUID"
      },
      "resolution": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Resolution",
        "default": null,
        "description": "Output WxH"
      },
      "zoom_start": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Zoom Start",
        "default": null,
        "description": "Start zoom (ken_burns)"
      },
      "resource_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Resource Id",
        "default": null,
        "description": "Source resource ID"
      },
      "speed_start": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Speed Start",
        "default": null,
        "description": "Start speed 0.25-4.0"
      },
      "duration_sec": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Duration Sec",
        "default": null,
        "description": "Duration (ken_burns)"
      },
      "collection_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Collection Id",
        "default": null,
        "description": "Collection UUID"
      },
      "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"
          }
        ],
        "title": "Pan Direction",
        "default": null,
        "description": "Pan direction"
      },
      "vignette_angle": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Vignette Angle",
        "default": null,
        "description": "Vignette angle (radians)"
      },
      "grain_intensity": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Grain Intensity",
        "default": null,
        "description": "Grain 1-100 (increases file size)"
      }
    }
  }

  arguments 268 lines copy
• analyze_media reads unknown never probed

  Analyze media: technical metadata, vision_qa, transcribe, detect_segments, detect_shots, export_edl.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399

  {
    "type": "object",
    "title": "analyze_mediaArguments",
    "properties": {
      "mode": {
        "enum": [
          "keep",
          "remove"
        ],
        "type": "string",
        "title": "Mode",
        "default": "keep",
        "description": "Segment detection mode"
      },
      "title": {
        "type": "string",
        "title": "Title",
        "default": "SOUNDSIDE_CUT",
        "description": "EDL title"
      },
      "format": {
        "type": "string",
        "const": "cmx3600",
        "title": "Format",
        "default": "cmx3600",
        "description": "EDL format"
      },
      "prompt": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Prompt",
        "default": null,
        "description": "detect_segments criteria"
      },
      "context": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Context",
        "default": null,
        "description": "Content context for detection"
      },
      "criteria": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Criteria",
        "default": null,
        "description": "vision_qa evaluation criteria"
      },
      "segments": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Segments",
        "default": null,
        "description": "Inline keep-ranges for export_edl"
      },
      "reel_name": {
        "type": "string",
        "title": "Reel Name",
        "default": "SOURCE",
        "description": "Source reel name (max 8 chars)"
      },
      "eval_model": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Eval Model",
        "default": null,
        "description": "Model override for eval"
      },
      "frame_rate": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Frame Rate",
        "default": null,
        "description": "Frame rate override"
      },
      "padding_sec": {
        "type": "number",
        "title": "Padding Sec",
        "default": 0.5,
        "description": "Cut point padding"
      },
      "resource_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Resource Id",
        "default": null,
        "description": "Resource ID or URL"
      },
      "max_segments": {
        "anyOf": [
          {
            "type": "integer"
          },
          {
            "type": "null"
          }
        ],
        "title": "Max Segments",
        "default": null,
        "description": "Max keep-ranges"
      },
      "verify_shots": {
        "type": "boolean",
        "title": "Verify Shots",
        "default": true,
        "description": "detect_shots: run the adjacent-frame pixel-diff verification pass that rejects false positives (fast pans, dissolves). Disable only for fast iteration; never the production default."
      },
      "analysis_type": {
        "enum": [
          "technical",
          "vision_qa",
          "transcribe",
          "detect_segments",
          "detect_shots",
          "export_edl"
        ],
        "type": "string",
        "title": "Analysis Type",
        "default": "technical",
        "description": "Analysis type"
      },
      "eval_provider": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Eval Provider",
        "default": null,
        "description": "Eval LLM: vertex, qwen, grok, anthropic, openai"
      },
      "include_audio": {
        "type": "boolean",
        "title": "Include Audio",
        "default": true,
        "description": "Include audio in EDL"
      },
      "language_code": {
        "type": "string",
        "title": "Language Code",
        "default": "en-US",
        "description": "Transcription language"
      },
      "merge_gap_sec": {
        "type": "number",
        "title": "Merge Gap Sec",
        "default": 2,
        "description": "Merge gap threshold"
      },
      "video_end_sec": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Video End Sec",
        "default": null,
        "description": "Vertex vision_qa video window end in seconds"
      },
      "scoring_rubric": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Scoring Rubric",
        "default": null,
        "description": "Custom vision_qa rubric: {dimension: description}, scored 1-5."
      },
      "min_segment_sec": {
        "type": "number",
        "title": "Min Segment Sec",
        "default": 3,
        "description": "Min segment duration"
      },
      "min_shot_frames": {
        "type": "integer",
        "title": "Min Shot Frames",
        "default": 6,
        "description": "detect_shots: minimum frames a shot may have. Candidates closer than this to a neighbor or to the range edges are dropped."
      },
      "video_start_sec": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Video Start Sec",
        "default": null,
        "description": "Vertex vision_qa video window start in seconds"
      },
      "intent_checklist": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": true
          },
          {
            "type": "null"
          }
        ],
        "title": "Intent Checklist",
        "default": null,
        "description": "vision_qa spec checklist: text_overlays, no_pillarboxing, expected_resolution, etc."
      },
      "reference_prompt": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Reference Prompt",
        "default": null,
        "description": "Prompt for vision_qa or detect_segments fallback"
      },
      "subtitle_formats": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "enum": [
                "srt",
                "vtt"
              ],
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Subtitle Formats",
        "default": null,
        "description": "Subtitle formats to persist"
      },
      "generation_prompt": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Generation Prompt",
        "default": null,
        "description": "Original generation prompt for fidelity eval"
      },
      "enable_diarization": {
        "type": "boolean",
        "title": "Enable Diarization",
        "default": false,
        "description": "Speaker identification"
      },
      "evaluation_context": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Evaluation Context",
        "default": null,
        "description": "Eval context: style, purpose, audience"
      },
      "video_sampling_fps": {
        "anyOf": [
          {
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "title": "Video Sampling Fps",
        "default": null,
        "description": "Focused Vertex vision_qa video sampling FPS (0 < fps <= 4; requires video_end_sec)"
      },
      "segments_resource_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Segments Resource Id",
        "default": null,
        "description": "Persisted segments for export_edl"
      },
      "shot_detect_threshold": {
        "type": "number",
        "title": "Shot Detect Threshold",
        "default": 0.3,
        "description": "detect_shots: ffmpeg scene-score threshold (0-1). Lower over-proposes candidate cuts for the adjacent-frame verification pass to filter."
      },
      "silence_threshold_sec": {
        "type": "number",
        "title": "Silence Threshold Sec",
        "default": 1,
        "description": "Min silence gap (seconds)"
      },
      "transcript_resource_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Transcript Resource Id",
        "default": null,
        "description": "Existing transcript to reuse"
      },
      "include_word_timestamps": {
        "type": "boolean",
        "title": "Include Word Timestamps",
        "default": true,
        "description": "Word-level timestamps"
      },
      "enable_silence_detection": {
        "type": "boolean",
        "title": "Enable Silence Detection",
        "default": false,
        "description": "Silence markers"
      }
    }
  }

  arguments 399 lines copy
• compose_video reads unknown never probed

  Compose a complete video from a timeline plan. Accepts 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. Plans: minimal (just brief+style), moderate (segment outlines), or detailed (providers, prompts, timing). Server fills gaps. Async: returns pending resource_id. Check completion with lib_list (the resource's status); an MCP notification may also arrive, but don't rely on it. Revision: pass reuse_segments mapping indices to prior resource_ids (from metadata.composition.segment_resources). Only changed segments regenerate. Revise (sugar): pass revise_from=<parent composition UUID> 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. Reassemble-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 review and objective delivery checks. Quality: judges are evidence. No judge verdict fails or regenerates a run; the publication gate is objective checks only (generated media, duration, resolution, audio, narration mix). metadata.delivery_certificate.status is certified, needs_review, draft (qa=false) or failed, and its needs_review list names every judge finding.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909

  {
    "type": "object",
    "$defs": {
      "RevisionSegmentOverride": {
        "type": "object",
        "title": "RevisionSegmentOverride",
        "properties": {
          "prompt": {
            "anyOf": [
              {
                "type": "string",
                "minLength": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Prompt",
            "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)."
          },
          "duration_sec": {
            "anyOf": [
              {
                "type": "number",
                "maximum": 30,
                "minimum": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Duration Sec",
            "default": null,
            "description": "Replacement duration in seconds. Generative segments are bounded by MAX_SEGMENT_DURATION=15.0s by the plan parse."
          },
          "camera_position": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Camera Position",
            "default": null,
            "description": "Replacement camera position, e.g. 'wide'."
          },
          "motion_intensity": {
            "anyOf": [
              {
                "enum": [
                  "low",
                  "medium",
                  "high"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Motion Intensity",
            "default": null,
            "description": "Replacement motion intensity."
          }
        },
        "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.",
        "additionalProperties": false
      }
    },
    "title": "compose_videoArguments",
    "required": [
      "plan"
    ],
    "properties": {
      "qa": {
        "type": "boolean",
        "title": "Qa",
        "default": true,
        "description": "Run the final review panel on the assembled film (~3 credits). Its verdict is evidence (certified or needs_review) and never blocks delivery; qa=false delivers a draft."
      },
      "plan": {
        "type": "object",
        "title": "CompositionPlan",
        "properties": {
          "cast": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "title": "CastMember",
                  "required": [
                    "name"
                  ],
                  "properties": {
                    "name": {
                      "type": "string",
                      "title": "Name",
                      "description": "Name used in segment prompts to trigger reference resolution"
                    },
                    "role": {
                      "enum": [
                        "character",
                        "setting",
                        "prop"
                      ],
                      "type": "string",
                      "title": "Role",
                      "default": "character"
                    },
                    "resource_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Resource Id",
                      "default": null,
                      "description": "Resource ID of the reference sheet image. If None, pipeline auto-generates one when auto_generate_references=True."
                    },
                    "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"
                        }
                      ],
                      "title": "Narration Voice Id",
                      "default": null,
                      "description": "MiniMax system voice for externally generated cast dialogue."
                    },
                    "visual_description": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Visual Description",
                      "default": null,
                      "description": "Optional caller-authored appearance text used by deterministic explicit-cast reference prompting and planning. Preserve wardrobe/material and design details; the brief determines the artistic medium."
                    },
                    "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"
                        }
                      ],
                      "title": "Native Video Voice Id",
                      "default": null,
                      "description": "xAI reference-audio voice for Grok native-video speech."
                    }
                  },
                  "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.",
                  "additionalProperties": false
                }
              },
              {
                "type": "null"
              }
            ],
            "title": "Cast",
            "default": null
          },
          "audio": {
            "anyOf": [
              {
                "type": "object",
                "title": "AudioSpec",
                "properties": {
                  "music": {
                    "anyOf": [
                      {
                        "type": "object",
                        "title": "MusicSpec",
                        "properties": {
                          "prompt": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Prompt",
                            "default": null
                          },
                          "provider": {
                            "anyOf": [
                              {
                                "type": "string",
                                "const": "lyria"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Provider",
                            "default": null,
                            "description": "Generation provider. Omit for supplied music; generated music is Lyria-only."
                          },
                          "volume_db": {
                            "type": "integer",
                            "title": "Volume Db",
                            "default": -18,
                            "maximum": 0,
                            "minimum": -30
                          },
                          "resource_id": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Resource Id",
                            "default": null
                          },
                          "fade_out_sec": {
                            "type": "number",
                            "title": "Fade Out Sec",
                            "default": 2,
                            "maximum": 10,
                            "minimum": 0
                          }
                        },
                        "description": "Background music configuration.\n\n`volume_db` sets the music level relative to the other layers; the final\nmix then gets one gain toward -16 LUFS integrated, of at most +12 dB, with\nits true peak kept at or below -1 dBTP (see AudioSpec).",
                        "additionalProperties": false
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null
                  },
                  "ducking": {
                    "anyOf": [
                      {
                        "type": "object",
                        "title": "DuckingConfig",
                        "properties": {
                          "enabled": {
                            "type": "boolean",
                            "title": "Enabled",
                            "default": true,
                            "description": "Enable sidechain ducking"
                          },
                          "knee_db": {
                            "type": "number",
                            "title": "Knee Db",
                            "default": 2.5,
                            "maximum": 10,
                            "minimum": 0,
                            "description": "Soft knee width in dB (higher = more gradual transition)"
                          },
                          "attack_ms": {
                            "type": "number",
                            "title": "Attack Ms",
                            "default": 200,
                            "maximum": 1000,
                            "minimum": 10,
                            "description": "Attack time in ms (how fast ducking engages)"
                          },
                          "release_ms": {
                            "type": "number",
                            "title": "Release Ms",
                            "default": 1000,
                            "maximum": 5000,
                            "minimum": 100,
                            "description": "Release time in ms (how fast background returns after speech)"
                          },
                          "music_ratio": {
                            "type": "number",
                            "title": "Music Ratio",
                            "default": 4,
                            "maximum": 20,
                            "minimum": 1.5,
                            "description": "Compression ratio for music under speech (4.0 = reduce by 75%)"
                          },
                          "source_ratio": {
                            "type": "number",
                            "title": "Source Ratio",
                            "default": 6,
                            "maximum": 20,
                            "minimum": 1.5,
                            "description": "Compression ratio for source audio under speech (higher = harder duck)"
                          },
                          "threshold_db": {
                            "type": "number",
                            "title": "Threshold Db",
                            "default": -34,
                            "maximum": -6,
                            "minimum": -60,
                            "description": "Speech detection threshold in dB (lower = more sensitive)"
                          }
                        },
                        "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.",
                        "additionalProperties": false
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null
                  },
                  "narration": {
                    "anyOf": [
                      {
                        "type": "object",
                        "title": "NarrationSpec",
                        "properties": {
                          "mode": {
                            "enum": [
                              "monolithic",
                              "per_segment"
                            ],
                            "type": "string",
                            "title": "Mode",
                            "default": "monolithic"
                          },
                          "speed": {
                            "type": "number",
                            "title": "Speed",
                            "default": 1,
                            "maximum": 2,
                            "minimum": 0.5
                          },
                          "script": {
                            "anyOf": [
                              {
                                "type": "string",
                                "maxLength": 12000
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Script",
                            "default": null
                          },
                          "provider": {
                            "anyOf": [
                              {
                                "type": "string",
                                "const": "minimax"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Provider",
                            "default": null,
                            "description": "Generation provider. Omit for supplied narration; generated narration is MiniMax-only."
                          },
                          "segments": {
                            "anyOf": [
                              {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "title": "SegmentNarration",
                                  "required": [
                                    "segment_index"
                                  ],
                                  "properties": {
                                    "role": {
                                      "enum": [
                                        "narrator",
                                        "dialogue"
                                      ],
                                      "type": "string",
                                      "title": "Role",
                                      "default": "narrator"
                                    },
                                    "text": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "maxLength": 2000,
                                          "minLength": 1
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "title": "Text",
                                      "default": null
                                    },
                                    "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"
                                        }
                                      ],
                                      "title": "Voice Id",
                                      "default": null
                                    },
                                    "delay_sec": {
                                      "type": "number",
                                      "title": "Delay Sec",
                                      "default": 0.5,
                                      "maximum": 10,
                                      "minimum": 0,
                                      "description": "Offset from segment start before this audio plays"
                                    },
                                    "cast_member": {
                                      "anyOf": [
                                        {
                                          "type": "string"
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "title": "Cast Member",
                                      "default": null,
                                      "description": "Name of the cast member speaking this dialogue (for voice casting)"
                                    },
                                    "resource_id": {
                                      "anyOf": [
                                        {
                                          "type": "string"
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ],
                                      "title": "Resource Id",
                                      "default": null,
                                      "description": "Existing authorized audio resource to place at this segment's offset."
                                    },
                                    "segment_index": {
                                      "type": "integer",
                                      "title": "Segment Index",
                                      "minimum": 0
                                    }
                                  },
                                  "description": "Narration or dialogue for a single segment in per-segment mode.\n\nA segment can either generate TTS from ``text`` or reuse one authorized\naudio resource.  Reused audio keeps its segment placement and role but\nnever carries voice-generation instructions.",
                                  "additionalProperties": false
                                }
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Segments",
                            "default": null
                          },
                          "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"
                              }
                            ],
                            "title": "Voice Id",
                            "default": null
                          },
                          "volume_db": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "maximum": 10,
                                "minimum": -10
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Volume Db",
                            "default": null
                          },
                          "resource_id": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "title": "Resource Id",
                            "default": null
                          }
                        },
                        "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.",
                        "additionalProperties": false
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null
                  },
                  "normalize_source_audio": {
                    "type": "boolean",
                    "title": "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)."
                  },
                  "source_audio_target_lufs": {
                    "type": "number",
                    "title": "Source Audio Target Lufs",
                    "default": -18,
                    "maximum": -10,
                    "minimum": -30,
                    "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."
                  },
                  "source_audio_true_peak_db": {
                    "type": "number",
                    "title": "Source Audio True Peak Db",
                    "default": -1.5,
                    "maximum": 0,
                    "minimum": -6,
                    "description": "True-peak ceiling (dBTP) for the loudnorm normalization pass on retained provider audio. Prevents inter-sample clipping after normalization."
                  }
                },
                "description": "Audio tracks configuration.\n\nThe final mix gets one gain toward -16 LUFS integrated loudness, limited so\nthat its true peak stays at or below -1 dBTP before AAC encoding and to at\nmost +12 dB; a silent mix is left untouched. `music.volume_db`,\n`narration.volume_db` and each segment's `source_audio_volume` set the\nbalance between the layers, not the delivered level.",
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ],
            "default": null
          },
          "brief": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2000
              },
              {
                "type": "null"
              }
            ],
            "title": "Brief",
            "default": null
          },
          "style": {
            "type": "string",
            "title": "Style",
            "default": "corporate_inspirational"
          },
          "title": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 100
              },
              {
                "type": "null"
              }
            ],
            "title": "Title",
            "default": null
          },
          "output": {
            "type": "object",
            "title": "OutputSpec",
            "properties": {
              "fps": {
                "type": "integer",
                "title": "Fps",
                "default": 30,
                "maximum": 60,
                "minimum": 24
              },
              "resolution": {
                "enum": [
                  "1280x720",
                  "720x1280",
                  "720x720",
                  "960x720",
                  "720x960",
                  "1080x720",
                  "720x1080"
                ],
                "type": "string",
                "title": "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)."
              },
              "aspect_ratio": {
                "enum": [
                  "16:9",
                  "9:16",
                  "1:1",
                  "4:3",
                  "3:4",
                  "3:2",
                  "2:3"
                ],
                "type": "string",
                "title": "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."
              },
              "duration_sec": {
                "type": "integer",
                "title": "Duration Sec",
                "default": 30,
                "maximum": 300,
                "minimum": 10
              }
            },
            "description": "Output video specification.",
            "additionalProperties": false
          },
          "overlays": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "title": "OverlaySpec",
                  "required": [
                    "text",
                    "segment_index"
                  ],
                  "properties": {
                    "text": {
                      "type": "string",
                      "title": "Text"
                    },
                    "style": {
                      "enum": [
                        "headline",
                        "caption",
                        "cta",
                        "watermark"
                      ],
                      "type": "string",
                      "title": "Style",
                      "default": "headline"
                    },
                    "end_sec": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "End Sec",
                      "default": null
                    },
                    "position": {
                      "type": "string",
                      "title": "Position",
                      "default": "bottom_center"
                    },
                    "font_size": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "maximum": 120,
                          "minimum": 12
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Font Size",
                      "default": null
                    },
                    "start_sec": {
                      "type": "number",
                      "title": "Start Sec",
                      "default": 0.5,
                      "minimum": 0
                    },
                    "font_color": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Font Color",
                      "default": null
                    },
                    "segment_index": {
                      "type": "integer",
                      "title": "Segment Index",
                      "minimum": 0
                    }
                  },
                  "description": "A text overlay on a segment.",
                  "additionalProperties": false
                }
              },
              {
                "type": "null"
              }
            ],
            "title": "Overlays",
            "default": null
          },
          "segments": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "title": "SegmentSpec",
                  "properties": {
                    "id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Id",
                      "default": null
                    },
                    "text": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Text",
                      "default": null
                    },
                    "type": {
                      "enum": [
                        "video",
                        "image",
                        "title_card",
                        "existing",
                        "still"
                      ],
                      "type": "string",
                      "title": "Type",
                      "default": "video"
                    },
                    "prompt": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Prompt",
                      "default": null
                    },
                    "weather": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Weather",
                      "default": null
                    },
                    "provider": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Provider",
                      "default": null
                    },
                    "scene_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Scene Id",
                      "default": null,
                      "description": "Scene this segment belongs to."
                    },
                    "font_size": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "maximum": 120,
                          "minimum": 12
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Font Size",
                      "default": null
                    },
                    "ken_burns": {
                      "anyOf": [
                        {
                          "type": "object",
                          "title": "KenBurnsSpec",
                          "properties": {
                            "easing": {
                              "enum": [
                                "linear",
                                "ease_in_out_sine",
                                "ease_out_cubic",
                                "ease_in_out_cubic"
                              ],
                              "type": "string",
                              "title": "Easing",
                              "default": "ease_in_out_sine"
                            },
                            "zoom_end": {
                              "type": "number",
                              "title": "Zoom End",
                              "default": 1.2,
                              "maximum": 3,
                              "minimum": 0.5
                            },
                            "zoom_start": {
                              "type": "number",
                              "title": "Zoom Start",
                              "default": 1,
                              "maximum": 3,
                              "minimum": 0.5
                            },
                            "pan_direction": {
                              "type": "string",
                              "title": "Pan Direction",
                              "default": "center"
                            }
                          },
                          "description": "Ken Burns effect parameters for image segments.",
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "default": null
                    },
                    "adapter_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Adapter Id",
                      "default": null,
                      "description": "Optional manual Wan LoRA adapter resource_id override for video segments."
                    },
                    "background": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Background",
                      "default": null
                    },
                    "last_frame": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Last Frame",
                      "default": null,
                      "description": "Authorized library resource UUID for the final frame pin. Video segments only; Compose does not accept URLs or URIs."
                    },
                    "text_align": {
                      "anyOf": [
                        {
                          "enum": [
                            "left",
                            "center",
                            "right"
                          ],
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Text Align",
                      "default": "center"
                    },
                    "text_color": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Text Color",
                      "default": null
                    },
                    "description": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Description",
                      "default": null
                    },
                    "fade_in_sec": {
                      "anyOf": [
                        {
                          "type": "number",
                          "maximum": 3,
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Fade In Sec",
                      "default": null,
                      "description": "Fade-in duration for title card"
                    },
                    "first_frame": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "First Frame",
                      "default": null
                    },
                    "font_family": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Font Family",
                      "default": null,
                      "description": "Font family: 'noto_sans' (default), 'noto_serif', or system font name"
                    },
                    "location_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Location Id",
                      "default": null,
                      "description": "Location/setting entity id; one location per scene."
                    },
                    "resource_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Resource Id",
                      "default": null
                    },
                    "time_of_day": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Time Of Day",
                      "default": null,
                      "description": "e.g. 'dawn', 'night'."
                    },
                    "duration_sec": {
                      "anyOf": [
                        {
                          "type": "number",
                          "maximum": 30,
                          "exclusiveMinimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Duration Sec",
                      "default": null,
                      "description": "Segment duration. Existing footage supports positive subsecond edits; other segment types require at least one second."
                    },
                    "fade_out_sec": {
                      "anyOf": [
                        {
                          "type": "number",
                          "maximum": 3,
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Fade Out Sec",
                      "default": null,
                      "description": "Fade-out duration for title card"
                    },
                    "line_spacing": {
                      "anyOf": [
                        {
                          "type": "number",
                          "maximum": 3,
                          "minimum": 0.8
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Line Spacing",
                      "default": null,
                      "description": "Line spacing multiplier (1.0=tight, 1.5=default, 2.0=spacious)"
                    },
                    "prop_state_in": {
                      "type": "object",
                      "title": "Prop State In",
                      "description": "Prop entity id -> state at segment start.",
                      "additionalProperties": {
                        "type": "string"
                      }
                    },
                    "continues_from": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Continues From",
                      "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."
                    },
                    "prop_state_out": {
                      "type": "object",
                      "title": "Prop State Out",
                      "description": "Prop entity id -> state at segment end.",
                      "additionalProperties": {
                        "type": "string"
                      }
                    },
                    "source_end_sec": {
                      "anyOf": [
                        {
                          "type": "number",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Source End Sec",
                      "default": null,
                      "description": "End time in seconds for a reviewed window of an existing video resource. Must be greater than source_start_sec."
                    },
                    "camera_position": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Camera Position",
                      "default": null,
                      "description": "e.g. 'wide', 'over-the-shoulder'."
                    },
                    "original_prompt": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Original Prompt",
                      "default": null
                    },
                    "motion_intensity": {
                      "anyOf": [
                        {
                          "enum": [
                            "low",
                            "medium",
                            "high"
                          ],
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Motion Intensity",
                      "default": null
                    },
                    "screen_direction": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Screen Direction",
                      "default": null,
                      "description": "e.g. 'left-to-right'."
                    },
                    "source_start_sec": {
                      "anyOf": [
                        {
                          "type": "number",
                          "minimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Source Start Sec",
                      "default": null,
                      "description": "Start time in seconds for a reviewed window of an existing video resource. Must be paired with source_end_sec."
                    },
                    "continuity_anchor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Continuity Anchor",
                      "default": null,
                      "description": "Anchor (e.g. a prior frame resource id) this shot must match."
                    },
                    "fallback_provider": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Fallback Provider",
                      "default": null
                    },
                    "visual_references": {
                      "anyOf": [
                        {
                          "type": "object",
                          "title": "VisualReferencesSpec",
                          "properties": {
                            "styles": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "title": "Styles"
                            },
                            "videos": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "title": "Videos"
                            },
                            "bindings": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "title": "VisualReferenceBinding",
                                "required": [
                                  "key",
                                  "resource_id"
                                ],
                                "properties": {
                                  "key": {
                                    "type": "string",
                                    "title": "Key",
                                    "description": "Stable provider-neutral entity key, such as cast:mara-vale"
                                  },
                                  "role": {
                                    "enum": [
                                      "subject",
                                      "background",
                                      "style"
                                    ],
                                    "type": "string",
                                    "title": "Role",
                                    "default": "subject"
                                  },
                                  "label": {
                                    "anyOf": [
                                      {
                                        "type": "string"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "title": "Label",
                                    "default": null,
                                    "description": "Human-readable entity label"
                                  },
                                  "resource_id": {
                                    "type": "string",
                                    "title": "Resource Id",
                                    "description": "Authorized library resource UUID for the reference asset"
                                  },
                                  "prompt_index": {
                                    "anyOf": [
                                      {
                                        "type": "integer",
                                        "minimum": 1
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "title": "Prompt Index",
                                    "default": null,
                                    "description": "Plan-level <IMAGE_N> index to remap into the provider request"
                                  }
                                },
                                "description": "Stable logical binding between a prompt token and a visual asset.",
                                "additionalProperties": false
                              },
                              "title": "Bindings",
                              "description": "Stable entity-to-asset bindings used to compile provider-local reference indices"
                            },
                            "subjects": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "title": "Subjects",
                              "description": "Authorized subject-reference resource UUIDs for this shot. Choose references whose visible subjects match the shot's intended presence and state. A group reference can reintroduce an absent or destroyed subject even when first_frame shows only the survivor; use a matching solo reference for solo shots."
                            },
                            "backgrounds": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "title": "Backgrounds"
                            }
                          },
                          "description": "Provider-neutral visual references for a segment.",
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "default": null
                    },
                    "character_state_in": {
                      "type": "object",
                      "title": "Character State In",
                      "description": "Character entity id -> state at segment start.",
                      "additionalProperties": {
                        "type": "string"
                      }
                    },
                    "characters_present": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "title": "Characters Present",
                      "description": "Entity ids of characters on screen in this segment."
                    },
                    "character_state_out": {
                      "type": "object",
                      "title": "Character State Out",
                      "description": "Character entity id -> state at segment end.",
                      "additionalProperties": {
                        "type": "string"
                      }
                    },
                    "optional_references": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "title": "Optional References",
                      "description": "Entity ids that may be referenced if helpful."
                    },
                    "required_references": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "title": "Required References",
                      "description": "Entity ids that MUST be referenced in this shot."
                    },
                    "source_audio_volume": {
                      "type": "number",
                      "title": "Source Audio Volume",
                      "default": 0.3,
                      "maximum": 1,
                      "minimum": 0,
                      "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; a value > 0 keeps generate_audio True, except under audio_strategy='scored', where every Grok clip is silent. To keep Grok's native audio (ambience, action sounds) under a music score, set a value > 0 on the video segments and leave audio_strategy unset (a music-only plan is then inferred 'full_mix'), or set audio_strategy='full_mix' (which, unlike the inferred case, does not silence video segments left unset). When unset: 0.3, except that enrichment writes 0.8 under 'native', writes 0.0 to the video segments of a plan it infers 'full_mix' for music plus native audio, and uses the style preset's value on segments it authors from a brief."
                    }
                  },
                  "description": "A single segment in the composition timeline.",
                  "additionalProperties": false
                }
              },
              {
                "type": "null"
              }
            ],
            "title": "Segments",
            "default": null
          },
          "references": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "title": "ReferenceAsset",
                  "properties": {
                    "url": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Url",
                      "default": null,
                      "description": "Unsupported on public Compose; use an authorized library resource_id."
                    },
                    "role": {
                      "type": "string",
                      "title": "Role",
                      "default": "reference",
                      "description": "Why this reference matters, e.g. brand_guide, storyboard, source_footage."
                    },
                    "title": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Title",
                      "default": null,
                      "description": "Optional human-readable label for reporting."
                    },
                    "weight": {
                      "type": "number",
                      "title": "Weight",
                      "default": 1,
                      "maximum": 5,
                      "minimum": 0,
                      "description": "Relative importance of this reference during enrichment."
                    },
                    "media_type": {
                      "anyOf": [
                        {
                          "enum": [
                            "image",
                            "video",
                            "audio",
                            "pdf",
                            "document",
                            "execution_report"
                          ],
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Media Type",
                      "default": null,
                      "description": "Explicit media type. If omitted, inferred from the resource mime type or URL."
                    },
                    "resource_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "title": "Resource Id",
                      "default": null,
                      "description": "Library resource ID for the reference asset."
                    }
                  },
                  "description": "A reference artifact used during multimodal enrichment.",
                  "additionalProperties": false
                }
              },
              {
                "type": "null"
              }
            ],
            "title": "References",
            "default": null
          },
          "transitions": {
            "type": "object",
            "title": "TransitionsSpec",
            "properties": {
              "type": {
                "enum": [
                  "crossfade",
                  "cut"
                ],
                "type": "string",
                "title": "Type",
                "default": "crossfade"
              },
              "duration_ms": {
                "type": "integer",
                "title": "Duration Ms",
                "default": 400,
                "maximum": 2000,
                "minimum": 0
              }
            },
            "description": "Transition configuration between segments.",
            "additionalProperties": false
          },
          "domain_rubric": {
            "anyOf": [
              {
                "type": "object",
                "additionalProperties": {
                  "type": "string"
                }
              },
              {
                "type": "null"
              }
            ],
            "title": "Domain Rubric",
            "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\"}"
          },
          "audio_strategy": {
            "anyOf": [
              {
                "enum": [
                  "native",
                  "narrated",
                  "scored",
                  "full_mix"
                ],
                "type": "string",
                "title": "AudioStrategy",
                "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 each segment's\n`source_audio_volume`. Enrichment writes a default in two cases only: 0.8\nto every segment left unset under NATIVE, and 0 to every unset `video`\nsegment when it infers FULL_MIX for music plus native audio (see\n`CompositionPlan.audio_strategy`). Every built-in style preset carries its\nown `source_audio_volume`, so no other strategy default applies: an unset\nsegment keeps 0.3, or the preset's value on a segment enrichment authored.\nGrok is asked for a silent clip (`generate_audio=False`) when a segment's\nvolume is 0, and for every segment under SCORED."
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Audio mixing strategy. When unset it is inferred from the plan's audio after enrichment (music that enrichment adds because the brief asks for it counts): 'native' with no narration or music, 'narrated' with narration only, 'full_mix' with narration and music, and 'scored' with music only. Since contract 1.2, a music-only plan in which at least one `video` segment explicitly sets source_audio_volume > 0 is inferred 'full_mix' instead: those segments keep Grok's native audio under the score, and every `video` segment that leaves source_audio_volume unset is set to 0.0 (a silent clip). `existing` segments never trigger this. Under 'narrated' and 'full_mix', suppress_video_speech (default true) asks Grok for ambience and action sounds without dialogue or music. An explicit strategy is never overridden; an explicit 'scored' makes every Grok clip silent, whatever its source_audio_volume. An explicit 'full_mix' does not silence unset video segments: they keep their default source_audio_volume (0.3, or the style preset's value on segments enrichment authors), and Grok generates native audio for every segment whose value is above 0."
          },
          "schema_version": {
            "type": "string",
            "const": "1.0",
            "title": "Schema Version",
            "default": "1.0",
            "description": "Durable public Compose plan contract version. If supplied, the value must be exactly '1.0'."
          },
          "delivery_intent": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Delivery Intent",
            "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 review (evidence only); otherwise content type is inferred from the brief."
          },
          "visual_strategy": {
            "type": "object",
            "title": "VisualStrategySpec",
            "properties": {
              "primary_provider": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Primary Provider",
                "default": null
              },
              "consistency_focus": {
                "enum": [
                  "character",
                  "scene",
                  "balanced"
                ],
                "type": "string",
                "title": "Consistency Focus",
                "default": "balanced"
              },
              "fallback_provider": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Fallback Provider",
                "default": null
              },
              "prefer_single_provider": {
                "type": "boolean",
                "title": "Prefer Single Provider",
                "default": true
              },
              "allow_segment_overrides": {
                "type": "boolean",
                "title": "Allow Segment Overrides",
                "default": true
              }
            },
            "description": "Project-level visual routing strategy.",
            "additionalProperties": false
          },
          "grok_voice_references": {
            "type": "boolean",
            "title": "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 <AUDIO_n> bindings alongside <IMAGE_n>). 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."
          },
          "suppress_video_speech": {
            "type": "boolean",
            "title": "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)."
          },
          "auto_generate_references": {
            "type": "boolean",
            "title": "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."
          }
        },
        "description": "Composition plan: sparse (brief+style) or detailed (segments, audio, overlays).",
        "additionalProperties": false
      },
      "tags": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Tags",
        "default": null,
        "description": "Tags merged with the server's composition/final tags."
      },
      "brand": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Brand",
        "default": null,
        "description": "Brand kit name for styling."
      },
      "qa_policy": {
        "enum": [
          "gate",
          "advisory"
        ],
        "type": "string",
        "title": "Qa Policy",
        "default": "gate",
        "description": "Deprecated since contract 1.1: accepted and ignored. Judges are evidence; delivery gates only on objective checks."
      },
      "project_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Project Id",
        "default": null,
        "description": "Project UUID. Auto-created if omitted."
      },
      "regenerate": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "integer"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Regenerate",
        "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."
      },
      "reuse_from": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Reuse From",
        "default": null,
        "description": "Alias of parent_resource_id."
      },
      "revise_from": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Revise From",
        "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."
      },
      "collection_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Collection Id",
        "default": null,
        "description": "Caller-owned collection UUID. Must belong to the selected project."
      },
      "reuse_segments": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Reuse Segments",
        "default": null,
        "description": "Segment index→resource_id map for revision. Reused segments skip generation."
      },
      "collection_name": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Collection Name",
        "default": null,
        "description": "Override auto-generated collection name."
      },
      "evaluation_mode": {
        "type": "string",
        "const": "full",
        "title": "Evaluation Mode",
        "default": "full",
        "description": "Required value 'full': run the complete supported evaluation, QA review and objective delivery checks."
      },
      "quality_profile": {
        "enum": [
          "frontier",
          "stable"
        ],
        "type": "string",
        "title": "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."
      },
      "reassemble_only": {
        "type": "boolean",
        "title": "Reassemble Only",
        "default": false,
        "description": "Skip GES; run assembly, QA review and objective delivery checks only. Requires ALL segment IDs in reuse_segments."
      },
      "image_candidates": {
        "type": "integer",
        "title": "Image Candidates",
        "default": 3,
        "maximum": 6,
        "minimum": 1,
        "description": "Image candidates per segment (1-6, default 3)."
      },
      "video_candidates": {
        "type": "integer",
        "title": "Video Candidates",
        "default": 1,
        "maximum": 6,
        "minimum": 1,
        "description": "Video candidates per segment (1-6, default 1)."
      },
      "segment_overrides": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/$defs/RevisionSegmentOverride"
            }
          },
          {
            "type": "null"
          }
        ],
        "title": "Segment Overrides",
        "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."
      },
      "parent_resource_id": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Parent Resource Id",
        "default": null,
        "description": "reassemble_only: reassemble from this parent composition's checkpoint (owner-only; supplies segments + reuse map + audio from metadata.composition)."
      },
      "allow_degraded_output": {
        "type": "boolean",
        "title": "Allow Degraded Output",
        "default": false,
        "description": "Deprecated since contract 1.1: accepted and ignored."
      }
    },
    "additionalProperties": false
  }

  arguments 1909 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.

Served from the same domain, which is what was measured. Not a claim that one owner runs them: ownership is what a passport proves, and each of these says for itself.

• www.soundside.ai soundside a2a · 6 tools