API Seedance 1.0 Lite : endpoint de génération vidéo rapide

Une seule requête POST, une attente de 30 à 60 secondes, et vous récupérez un MP4 1080p. C'est tout ce qu'est l'API Seedance 1.0 Lite. Pour les développeurs qui construisent des workflows vidéo automatisés, qu'il s'agisse d'animations de produits e-commerce, de pipelines de créations publicitaires ou de systèmes de génération de contenu, voici le guide d'intégration.

En résumé

• Un seul endpoint POST prend une image + un prompt de mouvement, et retourne un MP4 1080p
• Modèle de job asynchrone : soumettez la requête, interrogez l'état, téléchargez le résultat
• Coût par appel : $0,20-$1,00 selon la durée (2-12 secondes)
• Latence totale typique : 30-60 secondes
• 10 crédits offerts à l'inscription, suffisants pour valider l'intégration avant tout engagement
• Le même pool de crédits fonctionne sur tous les modèles Arteza et Seedream

Pourquoi les développeurs intègrent l'API

La version UI de Seedance 1.0 Lite est idéale pour la génération manuelle. L'API, elle, débloque les workflows que l'usage manuel ne peut pas prendre en charge :

• Animation automatisée de catalogue : déclenchez une génération pour chaque nouveau SKU ajouté à votre backend e-commerce
• Pipelines de créations publicitaires : générez des variantes selon un planning et poussez-les vers les plateformes publicitaires via leurs API
• Systèmes de génération de contenu : injectez des images CMS dans Arteza et récupérez les versions animées
• Workflows en temps réel générés par les utilisateurs : permettez à vos propres utilisateurs de téléverser une image et d'obtenir une version animée
• Traitements par lots : traitez des centaines d'images sources durant la nuit

À $0,20-$1,00 par appel et un délai de 30 à 60 secondes, vous pouvez construire une automatisation vidéo de niveau production qui aurait été économiquement impossible il y a 18 mois.

Obtenir l'accès à l'API

1. Inscrivez-vous sur la plateforme : 10 crédits gratuits sont crédités immédiatement
2. Accédez aux paramètres API depuis votre tableau de bord
3. Générez une clé API et conservez-la en sécurité (ne la commitez jamais dans git)
4. Optionnel : choisissez un abonnement mensuel sur la page des tarifs : 5, 25, 50 ou 120 dollars

Vos 10 crédits gratuits fonctionnent également pour les appels API. Vous pouvez valider l'intégration complète avant tout paiement.

Le modèle de requête

L'interaction principale est un simple POST vers l'endpoint de génération de Seedance 1.0 Lite.

Paramètres requis

Paramètres optionnels

Modèle de réponse

L'API retourne un identifiant de job et un statut. La génération est asynchrone : interrogez l'état de complétion ou utilisez un webhook.

{
  "job_id": "sd1lite_abc123xyz",
  "status": "processing",
  "credits_charged": 42,
  "estimated_time_seconds": 45,
  "created_at": "2026-04-10T12:00:00Z"
}

Une fois terminé :

{
  "job_id": "sd1lite_abc123xyz",
  "status": "completed",
  "video_url": "https://cdn.arteza.ai/...",
  "duration_seconds": 6,
  "resolution": "1080p",
  "credits_charged": 42,
  "completed_at": "2026-04-10T12:00:45Z"
}

Authentification

Toutes les requêtes utilisent l'authentification par jeton bearer via l'en-tête Authorization :

Authorization: Bearer YOUR_API_KEY

Les clés API sont liées à votre compte et débitent votre solde de crédits. Faites tourner vos clés depuis le tableau de bord si vous suspectez une fuite.

Exemple de code : Python

Voici une intégration Python minimale qui soumet un job, interroge son état et télécharge le résultat.

import requests
import time
import os

API_KEY = os.environ["SEEDANCE_API_KEY"]
BASE_URL = "https://api.arteza.ai/v1"

def generate_video(image_url, prompt, duration=6, aspect="9:16"):
    # Soumettre le job
    response = requests.post(
        f"{BASE_URL}/seedance-1-lite/generate",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "image": image_url,
            "prompt": prompt,
            "duration": duration,
            "resolution": "1080p",
            "aspect_ratio": aspect,
            "camera_lock": True,
        },
    )
    job = response.json()
    job_id = job["job_id"]
    
    # Interroger l'état jusqu'à complétion
    while True:
        status_response = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
        )
        status = status_response.json()
        if status["status"] == "completed":
            return status["video_url"]
        if status["status"] == "failed":
            raise Exception(f"Génération échouée : {status.get('error')}")
        time.sleep(5)

video_url = generate_video(
    image_url="https://example.com/product.jpg",
    prompt="Le produit tourne doucement, les reflets jouent sur la surface, la caméra est totalement fixe",
    duration=6,
    aspect="1:1",
)
print(f"Vidéo prête : {video_url}")

Exemple de code : Node.js

const axios = require('axios');

const API_KEY = process.env.SEEDANCE_API_KEY;
const BASE_URL = 'https://api.arteza.ai/v1';

async function generateVideo(imageUrl, prompt, duration = 6, aspect = '9:16') {
  // Soumettre le job
  const { data: job } = await axios.post(
    `${BASE_URL}/seedance-1-lite/generate`,
    {
      image: imageUrl,
      prompt,
      duration,
      resolution: '1080p',
      aspect_ratio: aspect,
      camera_lock: true,
    },
    {
      headers: { Authorization: `Bearer ${API_KEY}` },
    }
  );

  // Interroger l'état jusqu'à complétion
  while (true) {
    const { data: status } = await axios.get(
      `${BASE_URL}/jobs/${job.job_id}`,
      { headers: { Authorization: `Bearer ${API_KEY}` } }
    );

    if (status.status === 'completed') return status.video_url;
    if (status.status === 'failed') throw new Error(status.error);

    await new Promise((r) => setTimeout(r, 5000));
  }
}

generateVideo(
  'https://example.com/product.jpg',
  'Le produit tourne doucement, les reflets jouent sur la surface, la caméra est totalement fixe',
  6,
  '1:1'
).then((url) => console.log('Vidéo prête :', url));

Pattern webhook (recommandé en production)

L'interrogation fonctionne, mais les webhooks sont plus propres à grande échelle. Passez un webhook_url dans votre requête de génération et l'API enverra un POST avec le payload de complétion dès que le job est terminé.

response = requests.post(
    f"{BASE_URL}/seedance-1-lite/generate",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "image": image_url,
        "prompt": prompt,
        "duration": 6,
        "webhook_url": "https://your-app.com/webhooks/seedance",
    },
)

Votre handler webhook reçoit le même JSON de complétion que l'endpoint d'interrogation. Aucune boucle de polling n'est nécessaire.

Vous voulez le faire vous-même ? Essayer Seedance 1.0 Lite gratuitement →

Prêt à essayer Seedance 1.0 Lite ? Commencer à créer gratuitement →

Limites de débit et concurrence

Pour une concurrence ou un volume plus élevés, contactez le support. La plateforme peut prendre en charge des charges de traitement par lots de plus de 10 000 jobs par jour sur des configurations dédiées.

Gestion des erreurs

Les codes de statut HTTP standard s'appliquent :

Pour les intégrations en production, implémentez toujours :

• Le backoff exponentiel pour les erreurs 429 et 500
• La vérification du solde de crédits avant les grands traitements par lots
• La validation de la signature webhook si vous utilisez les webhooks
• Des clés d'idempotence pour éviter les doubles débits en cas d'erreurs réseau

Gestion des coûts en production

Chaque appel débite des crédits selon la durée : 2 crédits pour un clip de 2-3 secondes, jusqu'à 7 crédits à 12 secondes.

Conseils pour maîtriser les coûts en production :

• Testez vos prompts à 2 secondes avant de lancer des traitements par lots de 12 secondes
• Définissez un budget mensuel de crédits et programmez votre code pour s'arrêter une fois ce plafond atteint
• Surveillez le champ credits_charged dans chaque réponse pour suivre les dépenses par workflow
• Utilisez les webhooks pour ne pas gaspiller du temps en polling
• Mettez en cache les résultats réussis dans la mesure du possible, afin que des requêtes identiques ne déclenchent pas une nouvelle génération

Patterns d'intégration concrets

Animation de catalogue e-commerce

Déclenchez un job Seedance 1.0 Lite chaque fois qu'un nouveau SKU est ajouté à votre catalogue. Écrivez l'URL MP4 résultante dans votre base de données produits. Affichez-la automatiquement sur les pages produit.

Pipeline de créations publicitaires

Un cron job quotidien génère 10 nouvelles variantes d'annonces à partir de différentes images sources. Il pousse les MP4 directement vers l'API Meta Ads en tant que nouveaux visuels. Cela boucle la boucle entre la génération de contenu et la diffusion publicitaire.

Applications de contenu généré par les utilisateurs

Laissez les utilisateurs téléverser une photo dans votre application. Votre backend appelle Seedance 1.0 Lite avec un prompt modélisé. Renvoyez la version animée à l'utilisateur en moins d'une minute. Facturez vos utilisateurs suffisamment pour couvrir le coût API d'environ 0,20 dollar avec une marge confortable.

Enrichissement du CMS

Connectez-vous à votre CMS pour que toute nouvelle image mise en avant génère automatiquement une version animée via Seedance 1.0 Lite. Stockez les deux versions : la version statique en fallback, la version animée pour les emplacements hero.

Actualisation de catalogue par lots

Un job nocturne régénère les versions animées de vos 500 meilleurs produits avec des prompts de mouvement saisonniers. Des créations fraîches sans intervention humaine.

Passer à la version Pro ou 2.0 via l'API

Lorsqu'un job spécifique nécessite une qualité premium, changez d'endpoint :

• /seedance-1-lite/generate : $0,20-$1,00, rapide, le cheval de bataille pour les grands volumes
• /seedance-1-pro/generate : $0,20-$1,00, mouvement premium, contrôle de l'image finale
• /seedance-2.0/generate : 1,20-4,40 dollars, qualité cinéma et audio natif

Même clé API, même pool de crédits, même authentification. Changez de modèle en appelant un endpoint différent. Consultez le guide de comparaison Pro pour savoir quand passer à la version supérieure.

Commencez l'intégration dès aujourd'hui

Inscrivez-vous, récupérez votre clé API depuis le tableau de bord et effectuez votre premier appel avec les 10 crédits gratuits. L'exemple Python ci-dessus s'exécute de bout en bout en environ 45 secondes et vous offre un pattern d'intégration fonctionnel sur lequel vous appuyer.

Obtenir votre clé API gratuitement → : 10 crédits à l'inscription, sans carte bancaire requise, intégration prête pour la production en moins d'une heure.