Compeller

Create a Compeller generation job from primary audio media and optional reference media. Returns compel id, status, and links to track progress and retrieve renderings.

Create a compel from a selected Deezer preview track. If the user provides an audio file instead, upload that file and use create_compel.

Delete a webhook endpoint by id. Removes the registration and stops future deliveries.

Get Compeller platform capabilities, supported features, and API version.

Get the current status, progress, and details of a Compeller generation job.

Get current Compeller subscription plans and pricing.

Get details of a specific video rendering.

List all Compeller generation jobs for the authenticated account, newest first.

List all video renderings for a specific compel.

List available visual styles for Compeller video generation.

List all webhook endpoints registered for the authenticated account. Secrets are never returned by this tool.

Register an HTTPS endpoint to receive signed push notifications for compel lifecycle events (compel.ready when renderable, compel.completed, compel.failed). Returns webhook_id and the HMAC-SHA256 signing secret exactly once - store the secret immediately, it is never returned again. Deliveries are signed via X-Compeller-Signature: sha256=<hex> over the raw body. Delivery is at-least-once: a failed delivery is retried with backoff (up to 6 attempts) and every retry carries the same X-Compeller-Event-Id, so dedupe on it.

Mint a new HMAC-SHA256 signing secret for a registered webhook endpoint. The previous secret is invalidated immediately - integrators must update their receiver before the next compel terminal event fires. Returns the new secret exactly once; store it on receipt.

Search Compeller generation jobs by title for the authenticated account.

Search and list uploaded media files for the authenticated account.

Search Deezer preview tracks by song, artist, or album. Use this when the user provides a song string but no MP3/WAV/FLAC file.

Start rendering a READY compel with default configuration so an agent can continue to final MP4 without opening the browser UI.

Synchronously POST a synthetic webhook.test event to a registered endpoint. Uses the same HMAC-SHA256 signature as real deliveries, runs the standard URL safety check at delivery time, and returns {webhook_id, event_id, event_type, delivered, response_status, response_body_preview, latency_ms, error?}. Ignores the endpoint's events subscription - test delivery is always on-demand. Use this to verify your integration before relying on compel.completed / compel.failed events.

Update one or more mutable fields on a registered webhook endpoint: url, events, active. At least one of these must be provided. Validation mirrors register_webhook (https-only, <= 2048 chars, URL safety blocklist). Returns the updated endpoint (secret is never returned by this tool - use rotate_webhook_secret for that).

Get upload instructions for media files (audio, images, video). Returns the upload URL and required headers. Requires API token authentication.