API Seedance 1.0 Lite: Point d'extrémité de génération vidéo rapide

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

Pourquoi les développeurs intègrent l'API

La version UI de Seedance 1.0 Lite est excellente pour la génération manuelle. L'API déverrouille les workflows que l'utilisation manuelle ne peut pas supporter :

• Animation de catalogue automatisée : déclenchez une génération pour chaque nouveau SKU ajouté à votre backend e-commerce
• Pipelines de créatifs publicitaires : générez des variantes selon un calendrier, poussez vers les plateformes publicitaires via leurs API
• Systèmes de génération de contenu : alimentez les images CMS dans Arteza et obtenez des versions animées en retour
• Workflows en temps réel générés par les utilisateurs : laissez vos propres utilisateurs télécharger une image et obtenir une version animée
• Travaux par lots : traitez des centaines d'images source pendant la nuit

À 0,14 $ à 0,84 $ par appel et un délai d'exécution de 30 à 60 secondes, vous pouvez créer une automatisation vidéo de qualité production qui aurait été économiquement impossible il y a 18 mois.

Obtenir l'accès API

1. Inscrivez-vous sur la plateforme : 50 crédits gratuits arrivent immédiatement
2. Accédez aux paramètres API dans votre tableau de bord
3. Générez une clé API : stockez-la de manière sécurisée (ne la commitez jamais à git)
4. Optionnel : Achetez un forfait de crédits sur la page de tarification : 10 $, 25 $, 50 $ ou 100 $

Vos 50 crédits gratuits fonctionnent aussi pour les appels API. Vous pouvez valider l'intégration complète avant de payer quoi que ce soit.

Le modèle de requête

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

Paramètres obligatoires

Paramètres optionnels

Modèle de réponse

L'API retourne un ID de job et un statut. La génération est asynchrone : interrogez la 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 complet :

{
  "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 bearer token via l'en-tête Authorization :

Authorization: Bearer YOUR_API_KEY

Les clés API sont liées à votre compte et débítent contre votre solde de crédits. Faites tourner les clés via le tableau de bord si vous soupçonnez une fuite.

Exemple de code : Python

Voici une intégration Python minimale qui soumet un job, interroge la complétion 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"):
    # Submit the 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"]
    
    # Poll for completion
    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"Generation failed: {status.get('error')}")
        time.sleep(5)

video_url = generate_video(
    image_url="https://example.com/product.jpg",
    prompt="Product rotates smoothly, highlights catch across the surface, camera completely locked",
    duration=6,
    aspect="1:1",
)
print(f"Video ready: {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') {
  // Submit the 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}` },
    }
  );

  // Poll for completion
  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',
  'Product rotates smoothly, highlights catch across the surface, camera completely locked',
  6,
  '1:1'
).then((url) => console.log('Video ready:', url));

Modèle Webhook (Recommandé pour la production)

L'interrogation fonctionne, mais les webhooks sont plus propres à l'échelle. Transmettez une webhook_url dans votre requête de génération et l'API fera un POST du payload de complétion quand le job se termine.

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 gestionnaire webhook reçoit le même JSON de complétion que l'endpoint d'interrogation. Aucune boucle d'interrogation requise.

Vous voulez faire ça vous-même ? Essayez Seedance 1.0 Lite gratuitement →

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

Limites de taux et concurrence

Pour une concurrence plus élevée ou un volume plus important, contactez le support. La plateforme peut supporter des charges de travail par lot de 10 000+ jobs/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 :

• Backoff exponentiel pour les erreurs 429 et 500
• Vérifications du solde de crédits avant les grands travaux par lot
• Validation de signature webhook si vous utilisez les webhooks
• Clés d'idempotence pour éviter les débits en double en cas d'erreurs réseau

Gestion des coûts en production

Chaque appel débite des crédits au taux standard : 7 crédits par seconde de vidéo.

Conseils de contrôle des coûts en production :

• Testez les prompts à 2 secondes avant de vous engager dans des exécutions par lot de 12 secondes
• Définissez un budget de crédits mensuels et faites en sorte que votre code s'arrête quand il est atteint
• Surveillez le champ credits_charged dans chaque réponse pour suivre les dépenses par workflow
• Utilisez les webhooks pour éviter de brûler du temps en interrogation
• Mettez en cache les résultats réussis quand c'est possible, afin que les requêtes identiques ne se régénèrent pas

Modèles d'intégration réels

Animation du 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 de produits. Affichez automatiquement sur les PDP.

Pipeline de créatifs publicitaires

Le job cron quotidien génère 10 nouvelles variantes publicitaires à partir de différentes images source. Pousse les MP4s directement vers l'API Meta Ads en tant que nouveaux créatifs. Ferme la boucle entre la génération de contenu et la livraison publicitaire.

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

Permettez aux utilisateurs de télécharger une photo dans votre app. Votre backend appelle Seedance 1.0 Lite avec un prompt modélisé. Retournez la version animée à l'utilisateur en moins d'une minute. Facturez aux utilisateurs assez pour couvrir le coût API d'environ 0,30 $ avec une marge saine.

Amélioration du CMS

Intégrez-vous à votre CMS afin que chaque nouvelle image vedette obtienne automatiquement une version animée Seedance 1.0 Lite générée. Stockez les deux versions : statique pour le repli, animée pour les placements principaux.

Rafraîchissement de catalogue par lot

Le job nocturne régénère les versions animées de vos 500 meilleurs produits avec des prompts de mouvement saisonniers. Créatif frais sans intervention humaine.

Mise à niveau vers Pro ou 2.0 via API

Quand un job spécifique a besoin d'une qualité premium, changez d'endpoints :

• /seedance-1-lite/generate : 0,14 $ à 0,84 $, rapide, cheval de bataille volumé
• /seedance-1-pro/generate : 0,48 $ à 2,88 $, mouvement premium, contrôle de la dernière image
• /seedance-2.0/generate : 2,43 $ à 9,10 $, qualité cinéma + 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 faire la mise à niveau.

Commencez l'intégration aujourd'hui

Inscrivez-vous, récupérez votre clé API à partir du tableau de bord, et effectuez votre premier appel avec les 50 crédits gratuits. L'exemple Python ci-dessus s'exécute end-to-end en environ 45 secondes et vous donne un modèle d'intégration fonctionnel sur lequel vous pouvez construire.

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