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

# Seedance MCP Integrationsguide

> seedance MCP 服务器集成

[MCP (Model Context Protocol)](https://modelcontextprotocol.io) är ett modellkontextprotokoll lanserat av Anthropic som tillåter AI-modeller (som Claude, GPT med flera) att anropa externa verktyg via ett standardiserat gränssnitt. Genom Seedance MCP Server som tillhandahålls av XHuoAPI kan du direkt använda ByteDance Seedance för att generera AI-videor i AI-klienter som Claude Desktop, VS Code, Cursor med flera.

## Funktionsöversikt

Seedance MCP Server erbjuder följande kärnfunktioner:

* **Text-till-video** — Generera högkvalitativa videor från textpromptar
* **Bild-till-video** — Generera video med bild som referens (första bildruta, sista bildruta, referensbild med mera)
* **Stöd för flera modeller** — Stöd för Seedance 1.5 Pro, 1.0 Pro, 1.0 Lite och fler modeller
* **Flera upplösningar** — Stöd för 480p, 720p, 1080p med flera upplösningar
* **Flera bildformat** — Stöd för 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 med flera format
* **Flexibel längd** — Stöd för videolängder mellan 2 och 12 sekunder
* **Ljudgenerering** — Vissa modeller stödjer samtidig ljudgenerering
* **Uppgiftsövervakning** — Övervaka genereringsprocessen och hämta resultat

## Förberedelser

Innan användning behöver du skaffa en XHuoAPI API-token:

1. Registrera dig eller logga in på [XHuoAPI-plattformen](https://api.xhuoapi.ai)
2. Gå till sidan för [Seedance Videos API](https://api.xhuoapi.ai/documents/seedance-videos)
3. Klicka på "Acquire" för att få API-token (första ansökan ger gratis kvot)

## Installation och konfiguration

### Metod 1: pip-installation (rekommenderas)

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

### Metod 2: Installation från källkod

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

Efter installation kan du starta tjänsten med kommandot `mcp-seedance`.

## Användning i Claude Desktop

Redigera Claude Desktop konfigurationsfil:

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

Lägg till följande konfiguration:

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

Om du använder `uvx` (ingen förhandsinstallation av paket krävs):

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

Spara konfigurationen och starta om Claude Desktop för att börja använda Seedance-verktygen i konversationer.

## Användning i VS Code / Cursor

Skapa `.vscode/mcp.json` i projektets rotkatalog:

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

Eller med `uvx`:

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

## Tillgängliga verktyg

| Verktygsnamn                         | Beskrivning                                             |
| ------------------------------------ | ------------------------------------------------------- |
| `seedance_generate_video`            | Generera video från textprompt                          |
| `seedance_generate_video_from_image` | Generera video med bild som referens                    |
| `seedance_get_task`                  | Hämta status för en enskild uppgift                     |
| `seedance_get_tasks_batch`           | Hämta status för flera uppgifter samtidigt              |
| `seedance_list_models`               | Lista alla tillgängliga modeller och deras kapaciteter  |
| `seedance_list_resolutions`          | Lista tillgängliga upplösningar och bildformat          |
| `seedance_list_actions`              | Lista alla tillgängliga verktyg och arbetsflödesexempel |

## Exempel på användning

När konfigurationen är klar kan du direkt använda naturligt språk i AI-klienten för att anropa funktionerna, till exempel:

* "Hjälp mig att generera en stadsgatans timelapse-video med Seedance"
* "Använd denna bild som första bildruta och generera en 8 sekunder lång video"
* "Generera en kort video i 1080p vertikalt format 9:16"
* "Generera en video med ljud med Seedance 1.5 Pro-modellen"

## Mer information

* GitHub-repo: [XHuoAPI/SeedanceMCP](https://github.com/XHuoAPI/SeedanceMCP)
* PyPI-paket: [mcp-seedance](https://pypi.org/project/mcp-seedance/)
* API-dokumentation: [Seedance Video Generation API](https://api.xhuoapi.ai/documents/seedance)
