Seedance 2.0 Mini API

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

Variantes du modèle

Cette API prend en charge trois variantes :

Comparaison rapide

Rapports d’aspect pris en charge

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

Résolutions disponibles

Seedance 2.0 Mini Text to Video

Point de terminaison

POST /api/v1/video/task

Paramètres de requête

Obligatoires

Facultatifs

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

Facultatifs

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. Fournissez 1 à 9 images si vous utilisez des références d’images. 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 de l’audio ne sont pas prises en charge.

Marqueurs de référence @ (AT)

La fonction de référence @ (AT) relie les médias à l’invite à l’aide de marqueurs numérotés <<<...>>>. La numérotation commence à 1 séparément pour chaque type de média et suit l’ordre du tableau correspondant :

Chaque marqueur doit désigner un élément présent dans le tableau correspondant.

Facultatifs

Tarification des vidéos de référence

Seedance V2.0 Mini Reference-to-Video utilise la même tarification à la seconde selon 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 ne s’applique qu’une fois, quels que soient le nombre et la durée des vidéos de référence envoyé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;

Limites des médias

Ces limites s’appliquent aux images initiales, aux images finales et aux médias de référence des modèles de cette page.

Les fichiers audio et les vidéos de référence ont chacun une limite distincte de durée cumulée de 15 secondes. Leurs nombres sont indépendants : jusqu’à 9 images, 3 vidéos et 3 extraits audio. Ajouter des vidéos ne réduit pas le nombre d’images autorisé.

Tous les modèles utilisent 720p par défaut, mais resolution doit toujours être fourni. Le commutateur de son vaut true par défaut ; ni ce commutateur ni l’audio de référence ne modifient le prix. La génération à partir de références exige au moins une image ou une vidéo ; les requêtes uniquement audio ne sont pas prises en charge. Envoyer des vidéos de référence double le coût de génération, quels que soient leur nombre et leur durée.

Format de réponse

Réponse initiale

Tous les modèles renvoient un task_id pour l’interrogation périodique :

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 à l’interrogation périodique

Interrogez périodiquement GET /api/v1/video/{taskId} pour vérifier l’état :

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": {
      "credit": 0.2,
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Valeurs d’état

• submitted : Tâche acceptée, 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 traitement prend généralement 2 à 6 minutes selon la durée et la résolution.

Interrogez l’état toutes les 5 à 10 secondes.

Bonnes pratiques

1. Décrire clairement les mouvements : Incluez des descriptions précises des mouvements dans les invites
2. Choisir la résolution : Utilisez 480p pour un traitement plus rapide et 720p pour une meilleure qualité
3. Enrichir l’audio : Gardez sound activé pour des vidéos plus immersives
4. Image vers vidéo : Fournissez une première image nette via image_url ; utilisez image_end_url pour contrôler les images de début et de fin
5. Médias de référence : Utilisez des images, vidéos et fichiers audio compatibles, et incluez au moins une image ou une vidéo
6. Tarification des vidéos de référence : Toute requête de génération à partir de références contenant au moins une vidéo de référence est facturée au double, quels que soient le nombre et la durée des vidéos envoyées
7. Paramètre de graine : N’envoyez pas seed ; les modèles Seedance 2.0 Mini ne le prennent pas en charge