Przejdź do głównej treści

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) to protokół kontekstowy modeli opracowany przez Anthropic, który pozwala modelom AI (takim jak Claude, GPT itp.) na wywoływanie zewnętrznych narzędzi przez ustandaryzowany interfejs. Dzięki Seedance MCP Server dostarczanemu przez XHuoAPI możesz bezpośrednio korzystać z generowania AI wideo Seedance ByteDance w klientach AI takich jak Claude Desktop, VS Code, Cursor i innych.

​
Przegląd funkcji

Seedance MCP Server oferuje następujące kluczowe funkcje:
  • Generowanie wideo z tekstu — tworzenie wysokiej jakości wideo na podstawie tekstowych promptów
  • Generowanie wideo z obrazu — generowanie wideo z odniesieniem do obrazu (tryby: pierwsza klatka, ostatnia klatka, obraz referencyjny itp.)
  • Wsparcie wielu modeli — obsługa modeli Seedance 1.5 Pro, 1.0 Pro, 1.0 Lite i innych
  • Różne rozdzielczości — wsparcie dla 480p, 720p, 1080p i innych rozdzielczości
  • Różne proporcje obrazu — obsługa proporcji 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 i innych
  • Elastyczna długość — wsparcie dla długości wideo od 2 do 12 sekund
  • Generowanie audio — niektóre modele obsługują generowanie dźwięku wraz z wideo
  • Zapytania o zadania — monitorowanie postępu generowania i pobieranie wyników

​
Wymagania wstępne

Przed użyciem musisz uzyskać XHuoAPI API Token:
  1. Zarejestruj się lub zaloguj na XHuoAPI Platform
  2. Przejdź do strony Seedance Videos API
  3. Kliknij „Acquire”, aby uzyskać API Token (pierwsze zgłoszenie daje darmowy limit)

​
Instalacja i konfiguracja

​
Metoda 1: instalacja przez pip (zalecane)

pip install mcp-seedance

​
Metoda 2: instalacja ze źródeł

git clone https://github.com/XHuoAPI/SeedanceMCP.git
cd SeedanceMCP
pip install -e .
Po instalacji możesz uruchomić serwer poleceniem mcp-seedance.

​
Użycie w Claude Desktop

Edytuj plik konfiguracyjny Claude Desktop:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Dodaj następującą konfigurację: 
{
  "mcpServers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój API Token"
      }
    }
  }
}
Jeśli używasz uvx (nie wymaga wcześniejszej instalacji pakietów): 
{
  "mcpServers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "XHuoAPI_API_TOKEN": "Twój API Token"
      }
    }
  }
}
Po zapisaniu konfiguracji i ponownym uruchomieniu Claude Desktop możesz korzystać z narzędzi Seedance w rozmowach.

​
Użycie w VS Code / Cursor

W katalogu głównym projektu utwórz plik .vscode/mcp.json: 
{
  "servers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "XHuoAPI_API_TOKEN": "Twój API Token"
      }
    }
  }
}
Lub użyj uvx: 
{
  "servers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "XHuoAPI_API_TOKEN": "Twój API Token"
      }
    }
  }
}

​
Lista dostępnych narzędzi

Nazwa narzędziaOpis
seedance_generate_videoGenerowanie wideo na podstawie tekstu
seedance_generate_video_from_imageGenerowanie wideo z odniesieniem do obrazu
seedance_get_taskZapytanie o status pojedynczego zadania
seedance_get_tasks_batchMasowe zapytanie o status zadań
seedance_list_modelsLista dostępnych modeli i ich możliwości
seedance_list_resolutionsLista dostępnych rozdzielczości i proporcji obrazu
seedance_list_actionsLista dostępnych narzędzi i przykładów workflow

​
Przykłady użycia

Po konfiguracji możesz bezpośrednio w kliencie AI wywoływać funkcje w naturalnym języku, np.:
  • „Proszę wygeneruj wideo poklatkowe z miejskiej ulicy za pomocą Seedance”
  • „Użyj tego zdjęcia jako pierwszej klatki i wygeneruj 8-sekundowe wideo”
  • „Wygeneruj krótkie wideo 1080p w pionowym formacie 9:16”
  • „Użyj modelu Seedance 1.5 Pro do wygenerowania wideo z dźwiękiem”

​
Więcej informacji