Seedance 2.0 Mini API

Riferimento API completo per i modelli di generazione video Seedance 2.0 Mini di ByteDance.

Varianti del modello

Questa API supporta tre varianti del modello:

Confronto rapido

Proporzioni supportate

21:9, 16:9, 9:16, 1:1, 4:3, 3:4

Opzioni di risoluzione

Seedance 2.0 Mini Text to Video

Punto di accesso

POST /api/v1/video/task

Parametri della richiesta

Obbligatori

Facoltativi

Esempio di richiesta

javascriptCopia
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Seedance 2.0 Mini Image to Video

Parametri della richiesta

Obbligatori

Facoltativi

Esempio di richiesta

javascriptCopia
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-image-to-video',
    image_url: 'https://example.com/image.jpg',
    image_end_url: 'https://example.com/end-frame.jpg',
    prompt: 'Camera slowly pulls back to reveal the full landscape',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Seedance 2.0 Mini Reference to Video

Parametri della richiesta

Obbligatori

Contenuti di riferimento

Ogni richiesta deve includere almeno un’immagine o un video. Invia da 1 a 9 immagini quando usi riferimenti visivi. L’array images può essere omesso o vuoto solo quando l’array videos contiene almeno un video di riferimento. Le richieste contenenti solo audio non sono supportate.

Segnaposto di riferimento @ (AT)

La funzione di riferimento @ (AT) collega i contenuti di riferimento al prompt tramite segnaposto numerati <<<...>>>. La numerazione parte da 1 separatamente per ciascun tipo di contenuto e segue l’ordine dell’array corrispondente:

Ogni segnaposto deve indicare un elemento presente nel relativo array.

Facoltativi

Tariffe dei video di riferimento

Seedance V2.0 Mini Reference-to-Video adotta la stessa struttura tariffaria al secondo basata sulla risoluzione delle altre varianti di riferimento Seedance 2.0. Quando l’array videos contiene almeno un video di riferimento, il costo totale di generazione viene moltiplicato per 2. Il moltiplicatore si applica una sola volta, indipendentemente dal numero o dalla durata dei video di riferimento caricati.

Esempio di richiesta

javascriptCopia
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-reference-to-video',
    prompt: 'Place the explorer from <<<image_1>>> in the environment from <<<image_2>>>, following the camera movement in <<<video_1>>> and speaking with the reference voice from <<<audio_1>>>',
    duration: 8,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true,
    images: [
      'https://example.com/explorer-reference.jpg',
      'https://example.com/environment-reference.jpg'
    ],
    videos: ['https://example.com/camera-movement-reference.mp4'],
    audios: ['https://example.com/voice-reference.mp3']
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Limiti dei contenuti multimediali

Questi limiti si applicano alle immagini del primo e dell’ultimo fotogramma e ai contenuti di riferimento dei modelli di questa pagina.

L’audio e i video di riferimento hanno ciascuno un limite separato di durata complessiva di 15 secondi. Anche i conteggi sono indipendenti: fino a 9 immagini, 3 video e 3 clip audio. Aggiungere video non riduce il numero di immagini consentite.

Tutti i modelli usano 720p per impostazione predefinita, ma resolution deve comunque essere fornito. L’interruttore audio è impostato su true per impostazione predefinita; né questo interruttore né l’audio di riferimento modificano il prezzo. La generazione da riferimenti richiede almeno un’immagine o un video; le richieste con solo audio non sono supportate. Caricare video di riferimento raddoppia il costo di generazione, indipendentemente dal loro numero o dalla loro durata.

Formato della risposta

Risposta iniziale

Tutti i modelli restituiscono un task_id per le interrogazioni periodiche:

jsonCopia
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Risposta all’interrogazione periodica

Interroga periodicamente GET /api/v1/video/{taskId} per controllare lo stato:

jsonCopia
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.2,
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Valori di stato

• submitted: Attività accettata e in attesa di elaborazione
• processing: Generazione video in corso
• succeed: Generazione video completata
• failed: Generazione video non riuscita

Tempi di elaborazione

Il tempo di elaborazione tipico è di 2-6 minuti, a seconda della durata e della risoluzione.

Controlla lo stato ogni 5-10 secondi.

Buone pratiche

1. Descrivi chiaramente il movimento: Includi descrizioni specifiche del movimento nei prompt
2. Scelta della risoluzione: Usa 480p per un’elaborazione più rapida e 720p per una qualità superiore
3. Valorizza l’audio: Mantieni sound attivo per esperienze video più coinvolgenti
4. Da immagine a video: Fornisci un primo fotogramma nitido tramite image_url; usa image_end_url quando devi controllare i fotogrammi iniziale e finale
5. Contenuti di riferimento: Usa immagini, video e audio di riferimento supportati e assicurati di includere almeno un’immagine o un video
6. Tariffe dei video di riferimento: Qualsiasi richiesta di generazione da riferimenti contenente almeno un video di riferimento viene addebitata al doppio, indipendentemente dal numero o dalla durata dei video caricati
7. Parametro del seme: Non inviare seed; i modelli Seedance 2.0 Mini non lo supportano