← Все статьи

Seedance 2.5 API a MCP: jak přidat generování videa do vašeho projektu

Seedance 2.5 API a MCP: jak přidat generování videa do vašeho projektu

Seedance 2.5 je na NeuralSpace k dispozici nejen ve webovém rozhraní, ale také prostřednictvím veřejného /v1 API a serveru Model Context Protocol (MCP). Vývojáři a agenti AI mohou generovat videa přímo v kódu: odesílat textové výzvy, předávat referenční obrázky a videa, volit dobu trvání a načítat hotový klip prostřednictvím adresy URL.

Jak funguje API

Generování videa trvá minuty, takže API je asynchronní. Nejprve odešlete požadavek POST na vytvoření úkolu — služba vypočítá náklady, okamžitě naúčtuje tokeny a vrátí identifikátor úkolu. Poté se dotazujete na stav úkolu, a když je klip připraven, obdržíte přímý odkaz na soubor videa. Při chybě nebo vypršení časového limitu jsou tokeny vráceny automaticky. Klíče API lze generovat na vašem řídicím panelu podKlíče API.

Koncové body API

Vytvořte úlohu pomocí POST /v1/videos/generations pomocí { model: "seedance-2.5", prompt, duration, resolution, aspect_ratio, image_urls, video_urls, audio_urls }. Zkontrolujte stav a načtěte výsledek přes GET /v1/videos/generations/:id. Úplný katalog modelů a aktuálních sazeb je zdokumentován naDokumentace APIa přes GET /v1/models.

Připojení přes MCP (Model Context Protocol)

Pro Claude Desktop, Cursor, Cline a další agenty AI hostuje NeuralSpace oficiální server MCP na adrese https://neuralspace.pro/mcp. Seedance 2.5 je podporována v nástroji generate_video, přičemž pokrok je sledován prostřednictvím check_video. Agent AI může autonomně formulovat výzvy, konfigurovat parametry a připojovat referenční soubory.

{
  "mcpServers": {
    "neuralspace": {
      "url": "https://neuralspace.pro/mcp",
      "headers": {
        "x-api-key": "nsk-your_key"
      }
    }
  }
}

Seedance 2.5 Schopnosti

Ve veřejném rozhraní API i MCP je model dostupný pod ID seedance-2.5. Podporuje rozlišení 480p, 720p a 1080p, trvání od 4 do 30 sekund, generování zvuku, poměry stran (16:9, 9:16, 1:1, 4:3, 3:4, 21:9 nebo adaptivní), stejně jako referenční obrázky a videa. Před kódováním můžete otestovat všechny parametrymodelová stránka.

A glowing connector and a stream of light particles between glass panels

Vzorový požadavek cURL

Vytvoření úlohy generování prostřednictvím veřejného rozhraní API:

curl https://neuralspace.pro/v1/videos/generations \
  -H "x-api-key: nsk-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "close-up of a futuristic crystal on a dark table, soft neon glow, cinematic motion",
    "duration": 5,
    "resolution": "720p"
  }'

Odpověď vrátí úkol id, stav pending a adresu URL dotazování. Chcete-li získat stav:

curl https://neuralspace.pro/v1/videos/generations/TASK_ID \
  -H "x-api-key: nsk-your_key"

Po dokončení bude odpověď obsahovat adresu URL videa v data[0].url.

FAQ

Je Seedance 2.5 k dispozici prostřednictvím API a MCP?

Ano, Seedance 2.5 je plně k dispozici jak ve veřejném REST API (model ID seedance-2.5), tak prostřednictvím oficiálního serveru MCP prostřednictvím nástroje generate_video. Kompletní dokumentace parametrů je k dispozici vDokumentace API.

Jak získám API klíč?

Klíče jsou vydávány okamžitě v řídicím panelu NeuralSpace naKlíče APIstrana.

Kolik stojí vytvoření API?

Účtování je za sekundu a odpovídá ceně webu na základě rozlišení (480p, 720p nebo 1080p). Ceny tokenů v reálném čase vrací GET /v1/models a zobrazují se na/v1/docs.