Vai al contenuto

API di Mage · Modello video

API Seedance

Seedance, con filtro rigoroso

POST https://api.mage.space/v1/seedance/generate

In breve

L'API Seedance esegue Seedance 2.5 e altre 3 varianti tramite Mage su POST https://api.mage.space/v1/seedance/generate. Una richiesta con le impostazioni predefinite costa 618 Gems (circa 0,618 $), senza abbonamento. Seedance accetta nel prompt personaggi salvati, riferimenti e riferimenti audio tramite @handle.

  • VideoOutput
  • 4Varianti
  • 618Gems per clip, predefinito
  • $0.618Circa, in USD

Panoramica

Cosa fa l'API Seedance

Seedance di ByteDance, da Seedance 2.0 Mini per le bozze a Seedance 2.5, con clip fino a 30 secondi, molti riferimenti o Characters e modifiche di video di partenza. Filtro rigoroso: si applica il filtro dei contenuti del provider.

La linea di video Seedance di ByteDance, con movimento cinematografico e audio: Seedance 2.0 Mini, Seedance 2.0 Fast, Seedance 2.0 e Seedance 2.5, il più potente, con clip fino a 30 secondi. Filtro rigoroso: il filtro dei contenuti del provider controlla il prompt, i media in input e il video finito; una richiesta rifiutata dal filtro non va a buon fine, restituisce `content_blocked` con un motivo e viene rimborsata.

Accetta image, additional_images, videos come input.

Guida rapida

Chiama l'API Seedance

Imposta MAGE_API_KEY, invia la richiesta a /seedance/generate e interroga status_url finché la richiesta non è completata.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seedance/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "4",
  "model_id": "seedance-2.5"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('seedance', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '4',
  model_id: 'seedance-2.5',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("seedance", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "4",
    "model_id": "seedance-2.5",
})

print(request["result"]["url"])

Modelli

Valori model_id di Seedance

Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.

model_idNomePredefinito
seedance-2.0-miniSeedance 2.0 Mini
seedance-2.0-fastSeedance 2.0 Fast
seedance-2.0Seedance 2.0
seedance-2.5Seedance 2.5Sì

Opzioni

Parametri di Seedance

Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.

CampoValori
aspect_ratio16:9, 9:16, 1:1
resolution480p, 720p, 1080p, 4k
duration4, 5, 8, 10, 15, 20, 25, 30

Input

Contenuti multimediali accettati da Seedance

Invia ciascuno come URL https, data URL o upload fino a 100 MB.

CampoRuolo
imageL'immagine di riferimento.
additional_imagesImmagini di riferimento aggiuntive.
videosI video di partenza.

Regole

Cosa impone l'API Seedance

  • La modifica video richiede esattamente un video di partenza, da 4 a 30 secondi su `seedance-2.5` e da 2 a 15 secondi sugli altri modelli.
  • Su `seedance-2.5` una modifica mantiene la durata e il formato del video di partenza: `duration` e `aspect_ratio` vengono ignorati e il prezzo segue la durata del video.

Altri modelli video

Altre API per generare video su Mage

  • Video · da 245 Gems

    API Wan 3.0

    Wan 3.0, con un filtro rigoroso

  • Video · da 40 Gems

    API Wan Video v2.2

    Video open-weights con variante Lightning

  • Video · da 189 Gems

    API Berry

    Video fedeli ai tuoi riferimenti

  • Video · da 360 Gems

    API di Blueberry

    Fissa il primo e l'ultimo fotogramma

  • Video · da 618 Gems

    API Cherry

    La nostra famiglia di modelli video di punta

  • Video · da 375 Gems

    API di Grok Video

    Grok Imagine, in movimento

FAQ

Domande frequenti

Quanto costa l'API Seedance?
Una richiesta Seedance con le impostazioni predefinite (Seedance 2.5) costa 618 Gems, circa 0,618 $. Altre risoluzioni, durate e varianti cambiano il prezzo; la risposta indica l'importo esatto addebitato. Una generazione non riuscita viene rimborsata; una bloccata dalla policy sui contenuti di Mage no.
Qual è l'endpoint dell'API Seedance?
POST https://api.mage.space/v1/seedance/generate con un header Authorization: Bearer che contiene la tua chiave API di Mage. La risposta include uno status_url da interrogare per ottenere il risultato.
Quali modelli Seedance posso usare?
seedance-2.0-mini (Seedance 2.0 Mini), seedance-2.0-fast (Seedance 2.0 Fast), seedance-2.0 (Seedance 2.0), seedance-2.5 (Seedance 2.5). Il modello predefinito è Seedance 2.5.
Seedance supporta immagini di riferimento o personaggi?
Seedance accetta image, additional_images, videos. Seedance accetta nel prompt personaggi salvati, riferimenti e riferimenti audio tramite @handle.
Posso usare Seedance da Claude o ChatGPT?
Sì. Collega il server MCP di Mage a Claude, ChatGPT, Claude Code, Grok o Cursor e chiedi Seedance per nome. Il tuo assistente legge le opzioni con get_model e ti indica il prezzo prima di generare.
Per quanto tempo vengono conservati i risultati di Seedance?
Risultati e input vengono conservati per 30 giorni. Scarica tutto ciò che vuoi tenere nel tuo spazio di archiviazione.

Inizia a creare con Mage

Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.