Seedance 2.5 API és MCP: hogyan adhat hozzá videógenerálást a projekthez

A Seedance 2.5 a NeuralSpace-en nem csak a webes felületen, hanem a nyilvános /v1 API-n és a Model Context Protocol (MCP) szerveren keresztül is elérhető. A fejlesztők és az AI-ügynökök közvetlenül kódban generálhatnak videókat: szöveges üzeneteket küldhetnek be, referenciaképeket és videókat adhatnak át, kiválaszthatják az időtartamokat, és lekérhetik a kész klipet URL-en keresztül.

Hogyan működik az API

A videó létrehozása percekig tart, így az API aszinkron. Először küldjön egy POST-kérést egy feladat létrehozásához – a szolgáltatás kiszámítja a költségeket, azonnal felszámítja a tokeneket, és visszaküld egy feladatazonosítót. Ezután lekérdezi a feladat állapotát, és amikor a klip készen van, közvetlen linket kap a videofájlra. Hiba vagy időtúllépés esetén a tokeneket automatikusan visszatérítjük. Az API-kulcsok az irányítópulton generálhatókAPI kulcsok.

API-végpontok

Hozzon létre egy feladatot a POST /v1/videos/generations segítségével a { model: "seedance-2.5", prompt, duration, resolution, aspect_ratio, image_urls, video_urls, audio_urls } használatával. Ellenőrizze az állapotot, és kérje le az eredményt a következőn keresztül: GET /v1/videos/generations/:id. A modellek és az élő árak teljes katalógusa a következő címen található:API dokumentációés ezen keresztül: GET /v1/models.

Csatlakozás MCP-n keresztül (Model Context Protocol)

A Claude Desktop, a Cursor, a Cline és más AI-ügynökök számára a NeuralSpace hivatalos MCP-kiszolgálót ad otthon a https://neuralspace.pro/mcp címen. A Seedance 2.5-öt az generate_video eszköz támogatja, a folyamatot az check_video segítségével követi nyomon. Az AI-ügynök önállóan tud promptokat megfogalmazni, paramétereket konfigurálni és referenciafájlokat csatolni.

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

Seedance 2.5 képességek

A nyilvános API-ban és az MCP-ben is a modell seedance-2.5 azonosítóval érhető el. Támogatja a 480p, 720p és 1080p felbontásokat, 4-30 másodperces időtartamot, hanggenerálást, képarányokat (16:9, 9:16, 1:1, 4:3, 3:4, 21:9 vagy adaptív), valamint referenciaképeket és videókat. A kódolás előtt minden paramétert tesztelhetmodell oldal.

Minta cURL kérés

Generációs feladat létrehozása a nyilvános API-n keresztül:

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"
  }'

A válasz egy id feladatot, pending állapotot és lekérdezési URL-t ad vissza. Állapot lekérése:

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

Ha elkészült, a válasz tartalmazza a videó URL-jét a következőben: data[0].url.

GYIK

A Seedance 2.5 elérhető API-n és MCP-n keresztül?

Igen, a Seedance 2.5 teljes mértékben elérhető mind a nyilvános REST API-ban (modellazonosító seedance-2.5), mind a hivatalos MCP-kiszolgálón keresztül az generate_video eszközön keresztül. A paraméterek teljes dokumentációja elérhető aAPI dokumentáció.

Hogyan szerezhetek API-kulcsot?

A kulcsok azonnal megjelennek a NeuralSpace irányítópultjánAPI kulcsokoldalon.

Mennyibe kerül az API generálása?

A számlázás másodpercenként történik, és megegyezik a webhely áraival a felbontás alapján (480p, 720p vagy 1080p). A valós idejű token árakat GET /v1/models adja vissza, és megjeleníti/v1/docs.