soundside.ai

Soundside — Documentation pour développeurs

Plateforme de production média alimentée par IA pour les agents

Soundside expose 21 outils MCP pour générer, éditer, composer, extraire et analyser des médias — images, vidéos, audio, musique, texte et artefacts métier — ainsi que le réglage fin des adaptateurs LoRA et la composition vidéo côté serveur. Connectez n'importe quel client MCP. Les crédits OAuth/clé API couvrent tous les outils authentifiés ; le sous-ensemble éligible prend également en charge x402 USDC sur Base sans compte. Compose, Recast et la publication X sont réservés aux crédits authentifiés.

Devise 2026-09 (2026-09-22)

• Recast : devis d'achat signés valables 24 heures, dépenses d'exécution plafonnées, comparaisons source/résultat et revue finale du mouvement. Voir Recast pour la tarification par crédits authentifiés.
• Supprimé : Luma (entièrement) et la génération d'images/vidéos Runway. Runway est désormais audio uniquement — TTS et effets sonores via create_audio.
• Ajouté : génération musicale Lyria 3 (create_music), Grok TTS (create_audio), tarification vidéo Grok par seconde × résolution, modèles vidéo Alibaba Wan 2.7 (défaut international), adaptateur vidéo MiniMax H3.
• Pour les outils x402 éligibles, récupérez le catalogue en direct : GET https://mcp.soundside.ai/api/x402/status. Les devis Recast réservés aux authentifiés proviennent de remix_video(estimate_only=true).

Démarrage rapide

# MCP endpoint
https://mcp.soundside.ai/mcp

# Auth: API key or x402 crypto payment
Authorization: Bearer <your-api-key>

POST https://mcp.soundside.ai/mcp
{"jsonrpc":"2.0","id":"1","method":"tools/list","params":{}}

Outils (21)

Génération

Outil	Ce qu'il fait	Fournisseurs
create_image	Texte vers image, références de personnages	Alibaba (Wan), Creative Freedom (authentifié uniquement), Grok, MiniMax, Vertex AI
create_video	Texte vers vidéo, image vers vidéo, extension vidéo	Alibaba (Wan 2.7), Creative Freedom (authentifié uniquement), Grok, MiniMax (Hailuo/H3), Vertex AI (Veo 3.1)
create_audio	TTS, effets sonores, shim de transcription obsolète, clonage/conception vocale	Creative Freedom (authentifié uniquement), Grok, MiniMax, Runway (audio uniquement), Vertex AI
create_music	Musique à partir de paroles et d'invites de style	Lyria 3 ; Creative Freedom (crédits authentifiés uniquement)
create_text	Conversations de chat LLM, sortie structurée	Grok, MiniMax, Qwen, Vertex AI (Gemini)
create_artifact	Graphiques, présentations, documents, diagrammes ; mode bundle pour les packages multi-artefacts	plotly, pptx, docx, weasyprint, mermaid, gamma

Composition

Outil	Ce qu'il fait
compose_video	Pipeline côté serveur : enrichir le plan, générer les ressources en parallèle, assembler avec transitions, atténuation audio et superpositions
remix_video	Recast des personnes ou re-style d'une vidéo avec un devis d'achat signé, édition/audio source conservés, comparaison synchronisée et rapport qualité

Édition

Outil	Ce qu'il fait
edit_video	Transformations vidéo de base : rogner, concaténer, fondu enchaîné, vitesse, boucle, étalonnage couleur, graver les sous-titres, FFmpeg personnalisé
edit_audio	Mixer, remplacer ou compléter l'audio sur des médias existants
compose_media	Ajouter du texte, superposer des médias ou créer des composites en écran partagé
apply_effect	Effet Ken Burns, rampe de vitesse, grain de film, vignettage
extract_media	Extraire des images, des ensembles d'images ou des pistes audio

Analyse

Outil	Ce qu'il fait	Fournisseurs
analyze_media	Métadonnées techniques, QA visuelle, transcription, détection de segments, export EDL	Anthropic, Grok, OpenAI, Qwen, Vertex (+ ffprobe soundside.ai)

Adaptateurs (LoRA)

Outil	Ce qu'il fait	Backends
train_adapter	Entraîner un adaptateur LoRA à partir de médias de bibliothèque	DashScope (Wan), Modal (Hunyuan/LTX)
list_adapters	Lister vos adaptateurs LoRA
manage_adapter	Inspecter, déployer, retirer le déploiement, supprimer ou sélectionner un point de contrôle

Gestion de bibliothèque

Outil	Ce qu'il fait
lib_list	Parcourir les projets, collections, ressources, lignées, kits de marque ; interroger le solde de crédits
lib_manage	CRUD pour les projets, collections, ressources, kits de marque
lib_share	Partager des projets avec d'autres utilisateurs par e-mail

Publication

Outil	Ce qu'il fait	Accès
publish_content	Lectures de compte X plafonnées plus opérations durables de publication, réponse, édition, suppression, like et repost	Crédits authentifiés uniquement

Tarification

Soundside utilise un système de crédits : un crédit = 0,01 $ USD.

• La génération IA utilise des tarifs mesurés publiés basés sur le coût du fournisseur avec une marge plateforme d'environ 10 %, sauf si des frais fixes spécifiques à l'outil sont indiqués.
• Les outils de plateforme (moteur d'édition, bibliothèque) sont à prix fixe : 0,01 $/appel ; la QA visuelle est à 0,03 $.
• Compose ajoute des frais d'orchestration de cinq crédits uniquement en cas de succès et détaille séparément les appels enfants. Il nécessite des crédits OAuth/clé API et n'est pas disponible via x402.
• Recast ajoute des frais de service uniquement en cas de succès de 0,20 $ par seconde source transformée (minimum 2 $) au traitement détaillé. Les frais de service sont annulés lorsque la revue finale du mouvement est manquante ou échoue, ou si des constats qualité non résolus subsistent ; le traitement s'applique toujours. Les devis effectuent une analyse payante. Recast utilise des crédits authentifiés, pas x402. Voir Tarification Recast et jetons d'achat.
• Les opérations de compte X utilisent des crédits authentifiés et ne sont pas disponibles via x402. La publication coûte 2 crédits normalement ou 22 avec une URL ; les réponses utilisent la même classe, les opérations cibles coûtent 2 crédits, et les lectures citent le plafond de la page demandée mais se règlent sur le nombre réellement renvoyé (les résultats vides coûtent 0). Voir Opérations de compte X.
• Les estimations par appel et les frais détaillés aident à suivre les dépenses. Un prix par appel ne plafonne pas un flux de travail multi-appels : Compose n'a pas de devis d'achat signé ni de plafond de dépenses pour l'ensemble du flux. Le contrat de devis signé séparé de Recast plafonne son exécution achetée.

La tarification en direct est toujours disponible à :

GET https://mcp.soundside.ai/api/x402/status

Cela renvoie des prix USDC lisibles par machine par outil et par fournisseur pour le canal x402 uniquement. Cela ne publie pas l'outil gratuit ni Compose, Recast et la publication X réservés aux crédits authentifiés. Les prix sont pilotés par la base de données et peuvent changer — vérifiez toujours le point de terminaison plutôt que de coder en dur. Pour les outils à prix variable, le montant publié est un devis plafond (pire cas), pas le prix réglé typique — les lignes portent un price_note lorsque cela est important.

x402 : Paiement à l'appel avec crypto

Aucune clé API requise. Payez avec USDC sur Base (L2) par appel d'outil via EIP-3009 transferWithAuthorization (signature hors chaîne, le facilitateur paie le gaz).

Network: eip155:8453 (Base mainnet)
Token: USDC
Facilitator: Coinbase CDP

Voir Guide x402 pour la configuration complète.

Guides

• Démarrage — Première connexion MCP en 5 minutes
• x402 Paiement à l'appel — Paiements crypto, aucun compte requis
• Référence des outils — Documentation détaillée pour les 21 outils
• Recast d'une vidéo — Devis payants, achats sûrs contre les répétitions, transformations de casting/monde et revue qualité
• Créer un court-métrage original — Planification de plans assistée, revue du storyboard et assemblage des séquences acceptées via MCP
• Publier sur X — Connecter un compte X et publier depuis MCP

Exemples

• Python — Clé API — Se connecter et générer avec httpx
• Python — Devis et achat Recast — Enregistrer un devis, acheter son jeton et récupérer le statut du travail
• Histoire originale — Aperçu et Montage sélectionné — Modèles de demande Compose standard de 30 secondes ; remplacez les ID de ressources fictifs avant utilisation
• Python — x402 — Paiement à l'appel avec USDC
• TypeScript — Clé API — Client MCP Node.js
• Compétence OpenClaw — Configuration en une ligne pour les agents OpenClaw

Validation locale (hook de pré-push)

Il n'y a pas de CI hébergée sur GitHub ; la validation s'exécute localement avant chaque push. Activez une fois par clone :

git config core.hooksPath .githooks

Prérequis : brew install gitleaks et uv. Le hook exécute trois portes à chaque push : (1) un scan de secrets gitleaks de la plage de commits sortants, (2) python3 scripts/validate_public_contract.py, et (3) la suite pytest (uv run --with pytest python -m pytest tests/ -q). Le validateur de contrat compare ce portail au contrat MCP vendu et à sa source de vérité dans les dépôts frères, donc pousser nécessite le workspace de checkout à trois dépôts (../ssd-mcp et ../soundside-ai à côté de ce dépôt) ; un clone autonome ne peut pas passer la porte.

Liens

• Site web : soundside.ai
• Point de terminaison MCP : https://mcp.soundside.ai/mcp
• Tarification en direct : https://mcp.soundside.ai/api/x402/status
• GitHub : github.com/soundside-design/soundside-docs