API Seedance 2.0 Mini

Référence API complète pour les modèles de génération vidéo Seedance 2.0 Mini de ByteDance.

Variantes de modèle

Cette API prend en charge trois variantes de modèle :

Comparaison rapide

Formats d'image pris en charge

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

Options de résolution

Seedance 2.0 Mini Text to Video

Point de terminaison

POST /api/v1/video/task

Paramètres de requête

Obligatoires

Optionnels

Exemple de requête

javascriptCopier
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

Paramètres de requête

Obligatoires

Optionnels

Exemple de requête

javascriptCopier
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

Paramètres de requête

Obligatoires

Médias de référence

Chaque requête doit inclure au moins une image ou une vidéo. Envoyez 1 à 9 images lorsque vous utilisez des références d'image. Le tableau images ne peut être omis ou vide que si le tableau videos contient au moins une vidéo de référence. Les requêtes contenant uniquement du contenu audio ne sont pas prises en charge.

Espaces réservés de référence @ (AT)

La fonction de référence @ (AT) relie les médias de référence au prompt au moyen d'espaces réservés <<<...>>> numérotés. La numérotation commence à 1 indépendamment pour chaque type de média et suit l'ordre du tableau correspondant :

Chaque espace réservé doit pointer vers un élément présent dans son tableau correspondant.

Optionnels

Tarification des vidéos de référence

Seedance V2.0 Mini Reference-to-Video suit la même structure de facturation à la seconde et basée sur la résolution que les autres variantes de référence Seedance 2.0. Lorsque le tableau videos contient au moins une vidéo de référence, le coût total de génération est multiplié par 2. Ce multiplicateur n'est appliqué qu'une seule fois, quels que soient le nombre ou la durée des vidéos de référence chargées.

Exemple de requête

javascriptCopier
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;

Format de réponse

Réponse initiale

Tous les modèles renvoient un task_id pour l'interrogation :

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

Réponse d'interrogation

Interrogez GET /api/v1/video/{taskId} pour vérifier le statut :

jsonCopier
{
  "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"
        }
      ]
    }
  }
}

Valeurs de statut

• submitted: Tâche acceptée et en attente de traitement
• processing: Génération vidéo en cours
• succeed: Génération vidéo terminée
• failed: Échec de la génération vidéo

Temps de traitement

Le temps de traitement typique est de 2 à 6 minutes selon la durée et la résolution.

Interrogez toutes les 5 à 10 secondes pour vérifier le statut.

Bonnes pratiques

1. Décrire clairement le mouvement : Incluez des descriptions de mouvement spécifiques dans les prompts
2. Sélection de la résolution : Utilisez 480p pour un traitement plus rapide, 720p pour une qualité supérieure
3. Amélioration audio : Gardez sound activé pour des expériences vidéo plus immersives
4. Image vers vidéo : Fournissez une première image claire via image_url; utilisez image_end_url lorsque vous avez besoin d'images de début et de fin contrôlées
5. Médias de référence : Utilisez des références d'image, de vidéo et de contenu audio prises en charge, et veillez à inclure au moins une image ou une vidéo
6. Tarification des vidéos de référence : Toute requête Reference-to-Video contenant au moins une vidéo de référence est facturée 2 fois le tarif, quels que soient le nombre ou la durée des vidéos chargées
7. Paramètre seed : N'envoyez pas seed ; les modèles Seedance 2.0 Mini ne le prennent pas en charge