API du Générateur de Danse IA : Générez des Vidéos de Danse par Programmation

L'API publique d'AI Dance Generator vous permet de générer des vidéos de danse par programmation — depuis vos propres applications, scripts d'automatisation ou workflows. Téléchargez une image de personnage, fournissez une vidéo de danse de référence (ou un lien TikTok), et notre générateur de vidéos de danse IA s'occupe du reste.

Que vous construisiez un pipeline de création de contenu, intégriez la génération de vidéos IA dans votre produit, ou automatisiez des workflows de médias sociaux, l'API REST de Dance Generator vous donne un contrôle total sur le processus de création de vidéos de danse.

Ce guide couvre l'authentification, tous les endpoints disponibles, des exemples de requêtes/réponses et les bonnes pratiques pour intégrer l'API du générateur de danse IA dans votre projet.

Pour Commencer avec l'API Dance Generator

1. Créer une API Key

Connectez-vous à votre compte Dance Generator et naviguez vers Paramètres → API Keys. Cliquez sur Créer pour générer une nouvelle clé.

Votre clé ressemblera à sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx. Copiez-la immédiatement — elle n'est affichée qu'une seule fois.

2. Authentification

Toutes les requêtes API nécessitent un token Bearer dans l'en-tête Authorization :

Authorization: Bearer sk-your-api-key-here

3. URL de Base

https://dancegenerator.ai/api/v1

Tous les endpoints sont préfixés par /api/v1.

Endpoints de l'API du Générateur de Danse IA

Vérifier les Crédits

Vérifiez votre solde de crédits actuel avant de générer des vidéos de danse IA.

GET /api/v1/credits

Exemple :

curl https://dancegenerator.ai/api/v1/credits \
  -H "Authorization: Bearer sk-your-api-key"

Réponse :

{
  "remaining_credits": 500,
  "cost_reference": {
    "per_second": 7,
    "example_10s_video": 70
  }
}

Le coût est calculé ainsi : durée_vidéo_en_secondes × 7 crédits.

Télécharger une Image de Personnage

Téléchargez l'image du personnage qui sera animé dans la vidéo de danse.

POST /api/v1/upload/image

• Format : multipart/form-data
• Types autorisés : JPG, PNG, WebP
• Taille maximale : 10 Mo

Exemple :

curl https://dancegenerator.ai/api/v1/upload/image \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "file=@/path/to/character.jpg"

Réponse :

{
  "url": "https://file.dancegenerator.ai/abc123.jpg",
  "filename": "character.jpg",
  "size": 1024000
}

Conservez l'url — vous en aurez besoin pour la requête de génération.

Télécharger une Vidéo de Référence (Optionnel)

Si vous avez une vidéo de danse locale comme référence, téléchargez-la d'abord.

POST /api/v1/upload/video

• Format : multipart/form-data
• Types autorisés : MP4, MOV
• Taille maximale : 100 Mo

Exemple :

curl https://dancegenerator.ai/api/v1/upload/video \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "file=@/path/to/dance.mp4"

Réponse :

{
  "url": "https://file.dancegenerator.ai/videos/def456.mp4",
  "filename": "dance.mp4",
  "size": 5120000
}

Générer une Vidéo de Danse avec l'IA

C'est l'endpoint principal de l'API du générateur de danse IA. Soumettez une image de personnage et une vidéo de danse de référence (ou une URL TikTok) pour générer une vidéo de danse par IA.

POST /api/v1/generate

Corps de la requête (JSON) :

Exemple avec vidéo téléchargée :

curl https://dancegenerator.ai/api/v1/generate \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "character_image_url": "https://file.dancegenerator.ai/abc123.jpg",
    "reference_video_url": "https://file.dancegenerator.ai/videos/def456.mp4",
    "prompt": "Faites danser le personnage avec énergie",
    "character_orientation": "image"
  }'

Exemple avec URL TikTok :

curl https://dancegenerator.ai/api/v1/generate \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "character_image_url": "https://file.dancegenerator.ai/abc123.jpg",
    "tiktok_url": "https://www.tiktok.com/@user/video/1234567890",
    "character_orientation": "image"
  }'

Réponse (201) :

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "cost_credits": 70,
  "remaining_credits": 430,
  "estimated_duration_seconds": 180,
  "created_at": "2026-03-09T10:00:00.000Z"
}

La génération prend généralement 2-3 minutes. Utilisez l'ID de la tâche pour interroger les résultats.

Vérifier l'État de la Tâche

Interrogez cet endpoint pour vérifier si votre vidéo est prête.

GET /api/v1/tasks/:taskId

Exemple :

curl https://dancegenerator.ai/api/v1/tasks/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer sk-your-api-key"

Réponse (en cours) :

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "progress": 50,
  "result": null,
  "cost_credits": 70,
  "created_at": "2026-03-09T10:00:00.000Z",
  "completed_at": null,
  "error": null
}

Réponse (terminé) :

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "success",
  "progress": 100,
  "result": {
    "video_url": "https://..."
  },
  "cost_credits": 70,
  "created_at": "2026-03-09T10:00:00.000Z",
  "completed_at": "2026-03-09T10:03:22.000Z",
  "error": null
}

Valeurs de statut :

Lister les Tâches

Récupérez votre historique de tâches avec pagination et filtre de statut optionnel.

GET /api/v1/tasks

Paramètres de requête :

Exemple :

curl "https://dancegenerator.ai/api/v1/tasks?status=success&page=1&limit=10" \
  -H "Authorization: Bearer sk-your-api-key"

Réponse :

{
  "tasks": [
    {
      "task_id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "success",
      "cost_credits": 70,
      "created_at": "2026-03-09T10:00:00.000Z",
      "completed_at": "2026-03-09T10:03:22.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 42
  }
}

Workflow Complet de Génération de Vidéo de Danse IA

Voici un workflow complet montrant comment générer une vidéo de danse via l'API, de bout en bout avec curl :

# Étape 1 : Téléchargez votre image de personnage
curl https://dancegenerator.ai/api/v1/upload/image \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "[email protected]"
# → Notez l'"url" de la réponse

# Étape 2 : Générez une vidéo de danse avec une référence TikTok
curl https://dancegenerator.ai/api/v1/generate \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "character_image_url": "YOUR_UPLOADED_IMAGE_URL",
    "tiktok_url": "https://www.tiktok.com/@dancer/video/1234567890"
  }'
# → Notez le "task_id" de la réponse

# Étape 3 : Interrogez les résultats (répétez jusqu'à ce que le status soit "success" ou "failed")
curl https://dancegenerator.ai/api/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer sk-your-api-key"
# → Quand le status est "success", téléchargez la vidéo depuis result.video_url

Gestion des Erreurs de l'API

Toutes les erreurs de l'API Dance Generator suivent un format JSON cohérent :

{
  "error": "error_code",
  "message": "Description lisible",
  "details": {}
}

Codes d'erreur courants :

Conseils pour Utiliser l'API du Générateur de Danse IA

• Intervalle d'interrogation : Nous recommandons d'interroger le statut toutes les 5-10 secondes. La plupart des vidéos de danse IA sont terminées en 2-3 minutes.
• Remboursement des crédits : Si une tâche de génération de vidéo échoue, les crédits sont automatiquement remboursés.
• Intégration TikTok : Vous pouvez passer directement une URL TikTok comme référence de danse — l'API gère le téléchargement et le traitement de la vidéo.
• Déduplication des fichiers : Télécharger le même fichier deux fois retourne la même URL sans consommer de stockage supplémentaire.
• CORS activé : Tous les endpoints supportent les requêtes cross-origin, vous pouvez donc appeler l'API du générateur de danse depuis des applications web.

FAQ

Qu'est-ce que l'API AI Dance Generator ?

L'API AI Dance Generator est une API publique RESTful qui permet aux développeurs de générer des vidéos de danse par programmation. Vous fournissez une image de personnage et une vidéo de danse de référence, et notre IA crée une animation réaliste du personnage exécutant les mouvements de danse.

Quels formats vidéo l'API du générateur de danse supporte-t-elle ?

L'API accepte les fichiers MP4 et MOV pour les vidéos de référence, et JPG, PNG et WebP pour les images de personnages. Vous pouvez également passer directement une URL TikTok au lieu de télécharger un fichier vidéo.

Combien coûte la génération d'une vidéo de danse via l'API ?

Le générateur de danse IA utilise un modèle de tarification par crédits. Chaque seconde de vidéo générée coûte 7 crédits. Par exemple, une vidéo de danse de 10 secondes coûte 70 crédits. Si la génération échoue, les crédits sont automatiquement remboursés.

Puis-je utiliser l'API du générateur de danse dans ma propre application ?

Oui. L'API publique de Dance Generator est conçue pour l'intégration. Tous les endpoints supportent CORS, vous pouvez donc les appeler depuis des apps web, des backends mobiles, des scripts d'automatisation ou tout client HTTP.

Prêt à construire avec l'API du générateur de danse IA ? Rendez-vous dans Paramètres → API Keys pour créer votre première clé.