API Seedance 2.0 Mini

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

Rapporti d'aspetto supportati

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

Richiesta di esempio

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

Richiesta di esempio

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

Media di riferimento

Ogni richiesta deve includere almeno un'immagine o un video. Invia da 1 a 9 immagini quando usi riferimenti di immagini. 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 funzionalità di riferimento @ (AT) collega i media di riferimento al prompt tramite segnaposto <<<...>>> numerati. La numerazione inizia da 1 in modo indipendente per ogni tipo di media e segue l'ordine dell'array corrispondente:

Ogni segnaposto deve puntare a un elemento presente nell'array corrispondente.

Facoltativi

Prezzi dei video di riferimento

Seedance V2.0 Mini Reference-to-Video segue la stessa struttura di fatturazione 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. Questo moltiplicatore viene applicato una sola volta, indipendentemente dal numero o dalla durata dei video di riferimento caricati.

Richiesta di esempio

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;

Formato della risposta

Risposta iniziale

Tutti i modelli restituiscono un task_id per il polling:

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 di polling

Esegui il polling di 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": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Valori di stato

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

Tempo di elaborazione

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

Esegui il polling ogni 5-10 secondi per controllare lo stato.

Best practice

1. Descrivi chiaramente il movimento: Includi descrizioni specifiche del movimento nei prompt
2. Selezione della risoluzione: Usa 480p per elaborazione più rapida, 720p per qualità superiore
3. Miglioramento audio: Mantieni sound abilitato per esperienze video più immersive
4. Image to Video: Fornisci un primo fotogramma chiaro tramite image_url; usa image_end_url quando hai bisogno di controllare fotogrammi iniziali e finali
5. Media di riferimento: Usa riferimenti di immagini, video e audio supportati e assicurati che sia inclusa almeno un'immagine o un video
6. Prezzi dei video di riferimento: Qualsiasi richiesta Reference-to-Video contenente almeno un video di riferimento viene addebitata al doppio, indipendentemente dal numero o dalla durata dei video caricati
7. Parametro seed: Non inviare seed; i modelli Seedance 2.0 Mini non lo supportano