Hoppa till huvudinnehåll

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.

MCP (Model Context Protocol) ä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
  2. Gå till sidan för Seedance Videos API
  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)

pip install mcp-seedance

​
Metod 2: Installation från källkod

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: 
{
  "mcpServers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "XHuoAPI_API_TOKEN": "din API-token"
      }
    }
  }
}
Om du använder uvx (ingen förhandsinstallation av paket krävs): 
{
  "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: 
{
  "servers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "XHuoAPI_API_TOKEN": "din API-token"
      }
    }
  }
}
Eller med uvx: 
{
  "servers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "XHuoAPI_API_TOKEN": "din API-token"
      }
    }
  }
}

​
Tillgängliga verktyg

VerktygsnamnBeskrivning
seedance_generate_videoGenerera video från textprompt
seedance_generate_video_from_imageGenerera video med bild som referens
seedance_get_taskHämta status för en enskild uppgift
seedance_get_tasks_batchHämta status för flera uppgifter samtidigt
seedance_list_modelsLista alla tillgängliga modeller och deras kapaciteter
seedance_list_resolutionsLista tillgängliga upplösningar och bildformat
seedance_list_actionsLista 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