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

# Guia de Integração Seedance MCP

> seedance MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) é um protocolo de contexto de modelo lançado pela Anthropic, que permite que modelos de IA (como Claude, GPT, etc.) chamem ferramentas externas por meio de uma interface padronizada. Com o Seedance MCP Server fornecido pela XHuoAPI, você pode usar diretamente a geração de vídeos de IA da Seedance da ByteDance em clientes de IA como Claude Desktop, VS Code, Cursor, entre outros.

## Visão Geral das Funcionalidades

O Seedance MCP Server oferece as seguintes funcionalidades principais:

* **Geração de vídeo a partir de texto** — gera vídeos de alta qualidade a partir de prompts de texto
* **Geração de vídeo a partir de imagem** — gera vídeos com base em imagens de referência (modos de primeiro quadro, último quadro, imagem de referência, etc.)
* **Suporte a múltiplos modelos** — suporta modelos Seedance 1.5 Pro, 1.0 Pro, 1.0 Lite e outros
* **Diversas resoluções** — suporta resoluções 480p, 720p, 1080p, entre outras
* **Várias proporções de tela** — suporta proporções 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, etc.
* **Duração flexível** — suporta vídeos com duração de 2 a 12 segundos
* **Geração de áudio** — alguns modelos suportam geração simultânea de áudio
* **Consulta de tarefas** — monitora o progresso da geração e obtém resultados

## Preparação Prévia

Antes de usar, você precisa obter o Token da API da XHuoAPI:

1. Registre-se ou faça login na [plataforma XHuoAPI](https://api.xhuoapi.ai)
2. Acesse a página da [Seedance Videos API](https://api.xhuoapi.ai/documents/seedance-videos)
3. Clique em “Acquire” para obter o Token da API (a primeira solicitação oferece um crédito gratuito)

## Instalação e Configuração

### Método 1: Instalação via pip (recomendado)

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

### Método 2: Instalação via código-fonte

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

Após a instalação, você pode iniciar o serviço com o comando `mcp-seedance`.

## Uso no Claude Desktop

Edite o arquivo de configuração do Claude Desktop:

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

Adicione a seguinte configuração:

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

Se usar `uvx` (não requer instalação prévia de pacotes):

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

Salve a configuração e reinicie o Claude Desktop para usar as ferramentas Seedance nas conversas.

## Uso no VS Code / Cursor

Crie `.vscode/mcp.json` na raiz do projeto:

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

Ou use `uvx`:

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

## Lista de Ferramentas Disponíveis

| Nome da Ferramenta                   | Descrição                                                   |
| ------------------------------------ | ----------------------------------------------------------- |
| `seedance_generate_video`            | Gera vídeo a partir de prompt de texto                      |
| `seedance_generate_video_from_image` | Gera vídeo com base em imagem de referência                 |
| `seedance_get_task`                  | Consulta o status de uma tarefa única                       |
| `seedance_get_tasks_batch`           | Consulta o status de múltiplas tarefas                      |
| `seedance_list_models`               | Lista todos os modelos disponíveis e suas capacidades       |
| `seedance_list_resolutions`          | Lista resoluções e proporções de tela disponíveis           |
| `seedance_list_actions`              | Lista todas as ferramentas e exemplos de fluxos de trabalho |

## Exemplos de Uso

Após a configuração, você pode chamar essas funcionalidades diretamente em linguagem natural nos clientes de IA, por exemplo:

* “Me ajude a gerar um vídeo de time-lapse de rua da cidade com Seedance”
* “Use esta foto como primeiro quadro para gerar um vídeo de 8 segundos”
* “Gere um vídeo curto em 1080p na orientação vertical 9:16”
* “Gere um vídeo com áudio usando o modelo Seedance 1.5 Pro”

## Mais Informações

* Repositório GitHub: [XHuoAPI/SeedanceMCP](https://github.com/XHuoAPI/SeedanceMCP)
* Pacote PyPI: [mcp-seedance](https://pypi.org/project/mcp-seedance/)
* Documentação da API: [Seedance Vídeo API](https://api.xhuoapi.ai/documents/seedance)