Seedance 1.5 Pro API

Référence API complète pour les modèles de génération vidéo Seedance 1.5 Pro.

Variantes de modèle

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

Comparaison rapide

Ratios d’aspect pris en charge

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

Options de résolution

Seedance 1.5 Pro Text to Video

Point de terminaison

POST /api/v1/video/task

Paramètres de requête

Obligatoire

Facultatif

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-v1.5-pro-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    duration: 6,
    resolution: '1080p',
    aspect_ratio: '16:9'
  })
});

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

Exemple avec corps uniquement et paramètres facultatifs :

javascriptCopier
{
  model_name: 'seedance-v1.5-pro-text-to-video',
  prompt: 'A golden retriever running through a sunlit meadow',
  duration: 6,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  camera_fixed: false,
  seed: 42
}

Seedance 1.5 Pro Image to Video

Paramètres de requête

Obligatoire

Facultatif

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-v1.5-pro-image-to-video',
    image_url: 'https://example.com/image.jpg',
    prompt: 'Camera slowly pulls back to reveal the full landscape',
    duration: 6,
    resolution: '1080p',
    aspect_ratio: '16:9'
  })
});

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

Exemple avec corps uniquement :

javascriptCopier
{
  model_name: 'seedance-v1.5-pro-image-to-video',
  image_url: 'https://example.com/image.jpg',
  prompt: 'Camera slowly pulls back to reveal the full landscape',
  duration: 6,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true
}

Format de réponse

Réponse initiale

Les deux modèles renvoient un task_id pour le polling :

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

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: La génération vidéo a échoué

Temps de traitement

Temps de traitement typique : 2 à 5 minutes selon la durée et la résolution.

Les vidéos plus longues en 1080p peuvent prendre jusqu’à 8 minutes. Effectuez un polling toutes les 5 à 10 secondes pour vérifier le statut.

Bonnes pratiques

1. Décrivez clairement le mouvement : incluez des descriptions précises du mouvement dans les prompts pour des résultats plus prévisibles
2. Choix de la résolution : utilisez 480p ou 720p pour itérer plus vite, et 1080p pour la sortie finale
3. Contrôle de caméra : définissez camera_fixed: true lorsque vous voulez garder le sujet au centre sans dérive de caméra
4. Ratio d’aspect : adaptez le ratio à votre plateforme cible (par ex. 9:16 pour mobile, 16:9 pour desktop)
5. Reproductibilité : utilisez le paramètre seed pour reproduire ou itérer sur une génération spécifique
6. Qualité d’image : pour l’image-to-video, utilisez des images d’entrée haute résolution et bien éclairées pour de meilleurs résultats