> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Guide d’intégration Seedance MCP

> seedance MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) est un protocole de contexte de modèle lancé par Anthropic, permettant aux modèles d’IA (comme Claude, GPT, etc.) d’appeler des outils externes via une interface standardisée. Grâce au Seedance MCP Server fourni par XHuoAPI, vous pouvez utiliser directement la génération de vidéos IA Seedance de ByteDance dans des clients IA tels que Claude Desktop, VS Code, Cursor, etc.

## Aperçu des fonctionnalités

Le Seedance MCP Server offre les fonctionnalités principales suivantes :

* **Génération vidéo à partir de texte** — Génération de vidéos de haute qualité à partir d’invites textuelles
* **Génération vidéo à partir d’images** — Génération de vidéos en se basant sur des images de référence (première image, dernière image, image de référence, etc.)
* **Support multi-modèles** — Supporte plusieurs modèles tels que Seedance 1.5 Pro, 1.0 Pro, 1.0 Lite, etc.
* **Résolutions multiples** — Supporte les résolutions 480p, 720p, 1080p
* **Formats d’image variés** — Supporte les ratios 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, etc.
* **Durée flexible** — Supporte des vidéos de 2 à 12 secondes
* **Génération audio** — Certains modèles supportent la génération audio simultanée
* **Suivi des tâches** — Surveillance de la progression et récupération des résultats

## Prérequis

Avant utilisation, vous devez obtenir un token API XHuoAPI :

1. Inscrivez-vous ou connectez-vous sur la [plateforme XHuoAPI](https://api.xhuoapi.ai)
2. Rendez-vous sur la page [Seedance Videos API](https://api.xhuoapi.ai/documents/seedance-videos)
3. Cliquez sur « Acquire » pour obtenir votre token API (une allocation gratuite est offerte lors de la première demande)

## Installation et configuration

### Méthode 1 : Installation via pip (recommandée)

```bash theme={null}
pip install mcp-seedance
```

### Méthode 2 : Installation depuis le code source

```bash theme={null}
git clone https://github.com/XHuoAPI/SeedanceMCP.git
cd SeedanceMCP
pip install -e .
```

Une fois l’installation terminée, vous pouvez lancer le service avec la commande `mcp-seedance`.

## Utilisation dans Claude Desktop

Modifiez le fichier de configuration de Claude Desktop :

* **macOS** : `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows** : `%APPDATA%\Claude\claude_desktop_config.json`

Ajoutez la configuration suivante :

```json theme={null}
{
  "mcpServers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "XHuoAPI_API_TOKEN": "votreTokenAPI"
      }
    }
  }
}
```

Si vous utilisez `uvx` (pas besoin d’installer les paquets à l’avance) :

```json theme={null}
{
  "mcpServers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "XHuoAPI_API_TOKEN": "votreTokenAPI"
      }
    }
  }
}
```

Après avoir sauvegardé la configuration, redémarrez Claude Desktop pour utiliser les outils Seedance dans vos conversations.

## Utilisation dans VS Code / Cursor

Créez un fichier `.vscode/mcp.json` à la racine de votre projet :

```json theme={null}
{
  "servers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "XHuoAPI_API_TOKEN": "votreTokenAPI"
      }
    }
  }
}
```

Ou utilisez `uvx` :

```json theme={null}
{
  "servers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "XHuoAPI_API_TOKEN": "votreTokenAPI"
      }
    }
  }
}
```

## Liste des outils disponibles

| Nom de l’outil                       | Description                                                |
| ------------------------------------ | ---------------------------------------------------------- |
| `seedance_generate_video`            | Génère une vidéo à partir d’un texte                       |
| `seedance_generate_video_from_image` | Génère une vidéo en se basant sur une image                |
| `seedance_get_task`                  | Consulte l’état d’une tâche unique                         |
| `seedance_get_tasks_batch`           | Consulte l’état de plusieurs tâches                        |
| `seedance_list_models`               | Liste tous les modèles disponibles et leurs capacités      |
| `seedance_list_resolutions`          | Liste les résolutions et ratios d’image disponibles        |
| `seedance_list_actions`              | Liste tous les outils et exemples de workflows disponibles |

## Exemples d’utilisation

Une fois configuré, vous pouvez appeler ces fonctionnalités en langage naturel dans votre client IA, par exemple :

* « Aide-moi à générer une vidéo en time-lapse d’une rue urbaine avec Seedance »
* « Utilise cette photo comme première image pour générer une vidéo de 8 secondes »
* « Génère une courte vidéo 1080p au format portrait 9:16 »
* « Utilise le modèle Seedance 1.5 Pro pour générer une vidéo avec audio »

## Plus d’informations

* Dépôt GitHub : [XHuoAPI/SeedanceMCP](https://github.com/XHuoAPI/SeedanceMCP)
* Package PyPI : [mcp-seedance](https://pypi.org/project/mcp-seedance/)
* Documentation API : [Seedance vidéo génération API](https://api.xhuoapi.ai/documents/seedance)