API Seedance 2.0 Fast : point de terminaison pour la génération vidéo économique

Une requête HTTP, un clip vidéo IA de qualité cinéma, 1,94 dollar. Voilà l'économie unitaire que propose l'API Seedance 2.0 Fast. Des endpoints dédiés pour le text-to-video et l'image-to-video, une tarification déterministe, le même moteur de qualité que Seedance 2.0 standard, et un avantage de coût d'environ 20 % qui compte vraiment quand on opère à grande échelle.

Voici le guide complet pour les développeurs.

En bref

• Endpoints : bytedance/seedance-2.0/fast/text-to-video et fast/image-to-video
• Coût : 0,2419 dollar par seconde, soit 10-55 crédits par clip ($1,00-$5,50)
• Réponse : ID de job asynchrone, interrogation jusqu'à la fin, téléchargement du MP4
• Auth : Clé API depuis votre Tableau de bord Arteza
• Vitesse : 30-150 secondes par génération

À quoi sert l'API Fast

Si vous construisez une application, un outil ou un service qui génère des vidéos pour vos utilisateurs - planificateur de réseaux sociaux, plateforme d'automatisation marketing, moteur de contenu e-commerce, outil créatif interne - l'API Seedance 2.0 Fast est l'endpoint de qualité cinéma le plus abordable sur lequel vous pouvez vous appuyer en 2026.

Même qualité visuelle que Seedance 2.0 standard. Coût par seconde plus bas. Débit de calcul plus élevé. Conçu pour s'intégrer dans des workflows qui produisent de la vidéo en volume.

L'utilisateur cible typique est un développeur ou une équipe qui doit générer des vidéos de façon programmatique à partir des entrées utilisateur, et non un créateur isolé produisant un clip à la fois via l'interface.

Les deux endpoints

Endpoint text-to-video :

POST https://arteza.ai/api/v1/bytedance/seedance-2.0/fast/text-to-video

Génère une vidéo à partir d'un prompt textuel. Aucune image source requise.

Endpoint image-to-video :

POST https://arteza.ai/api/v1/bytedance/seedance-2.0/fast/image-to-video

Génère une vidéo en partant d'une image source importée, accompagnée d'un prompt de mouvement.

Les deux endpoints acceptent des corps de requête similaires et renvoient le même format de réponse. Choisissez selon que vous disposez ou non d'une image source à animer.

Authentification

Chaque requête nécessite une clé API dans l'en-tête Authorization. Générez une clé depuis votre Tableau de bord Arteza.

Authorization: Bearer YOUR_API_KEY

Les clés sont liées à votre compte et puisent dans votre solde de crédits. Faites-les pivoter selon vos besoins depuis le tableau de bord.

Format de requête : text-to-video

POST /api/v1/bytedance/seedance-2.0/fast/text-to-video
{
  "prompt": "Slow dolly in on a ceramic coffee cup on a wooden cafe table, morning window light, shallow depth of field, cinematic 35mm film look",
  "duration": 5,
  "aspect_ratio": "16:9"
}

Paramètres :

• prompt (requis, string) : le prompt textuel décrivant la vidéo souhaitée.
• duration (requis, integer) : durée du clip en secondes. Plage : 4-15.
• aspect_ratio (requis, string) : l'une des valeurs "16:9", "9:16", "1:1".

Format de requête : image-to-video

POST /api/v1/bytedance/seedance-2.0/fast/image-to-video
{
  "image_url": "https://your-cdn.com/source-image.jpg",
  "prompt": "Slow push in with shallow depth of field, cinematic 35mm film look",
  "duration": 5,
  "aspect_ratio": "16:9"
}

Paramètres :

• image_url (requis, string) : URL accessible publiquement de l'image source. Formats pris en charge : JPG, PNG, WebP.
• prompt (requis, string) : prompt de mouvement décrivant comment animer l'image.
• duration (requis, integer) : durée du clip en secondes. Plage : 4-15.
• aspect_ratio (requis, string) : doit correspondre au ratio de l'image source pour de meilleurs résultats.

Format de réponse

Les deux endpoints renvoient un ID de job asynchrone :

{
  "job_id": "sdf_2026_abc123xyz",
  "status": "queued",
  "estimated_seconds": 45,
  "cost_credits": 242
}

Interrogez l'endpoint de statut jusqu'à ce que le job soit terminé :

GET /api/v1/jobs/sdf_2026_abc123xyz

Une réponse complète :

{
  "job_id": "sdf_2026_abc123xyz",
  "status": "completed",
  "video_url": "https://cdn.arteza.ai/output/sdf_2026_abc123xyz.mp4",
  "duration_seconds": 5,
  "resolution": "720p",
  "credits_consumed": 242
}

Téléchargez la video_url et vous obtenez votre MP4.

Exemple complet en Python

import requests
import time

API_KEY = "your_api_key_here"
BASE_URL = "https://arteza.ai/api/v1"

def generate_fast_video(prompt, duration=5, aspect_ratio="16:9"):
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    
    # Soumettre le job de génération
    response = requests.post(
        f"{BASE_URL}/bytedance/seedance-2.0/fast/text-to-video",
        headers=headers,
        json={
            "prompt": prompt,
            "duration": duration,
            "aspect_ratio": aspect_ratio
        }
    )
    job = response.json()
    job_id = job["job_id"]
    print(f"Job en file d'attente : {job_id}, estimé à {job['estimated_seconds']}s")
    
    # Interroger jusqu'à la fin
    while True:
        time.sleep(10)
        status = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers=headers
        ).json()
        
        if status["status"] == "completed":
            print(f"Terminé : {status['video_url']}")
            return status["video_url"]
        elif status["status"] == "failed":
            raise Exception(f"Génération échouée : {status.get('error')}")
        else:
            print(f"Statut : {status['status']}")

# Utilisation
video_url = generate_fast_video(
    "Slow tracking shot of a golden retriever running through autumn leaves, golden hour, cinematic 35mm film look",
    duration=5,
    aspect_ratio="16:9"
)

Exemple complet en JavaScript

const API_KEY = 'your_api_key_here';
const BASE_URL = 'https://arteza.ai/api/v1';

async function generateFastVideo(prompt, duration = 5, aspectRatio = '16:9') {
  const headers = {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  };

  // Soumettre le job de génération
  const submitRes = await fetch(
    `${BASE_URL}/bytedance/seedance-2.0/fast/text-to-video`,
    {
      method: 'POST',
      headers,
      body: JSON.stringify({ prompt, duration, aspect_ratio: aspectRatio })
    }
  );
  const job = await submitRes.json();
  console.log(`Job en file d'attente : ${job.job_id}`);

  // Interroger jusqu'à la fin
  while (true) {
    await new Promise(r => setTimeout(r, 10000));
    const statusRes = await fetch(
      `${BASE_URL}/jobs/${job.job_id}`,
      { headers }
    );
    const status = await statusRes.json();

    if (status.status === 'completed') {
      return status.video_url;
    } else if (status.status === 'failed') {
      throw new Error(`Génération échouée : ${status.error}`);
    }
  }
}

// Utilisation
const videoUrl = await generateFastVideo(
  'Slow dolly in on a matcha latte in a ceramic cup, morning window light, cinematic 35mm',
  5,
  '9:16'
);

Prêt à construire sur l'API ? Obtenez votre clé API →

Tarification par appel API

Chaque appel API déduit des crédits de votre solde en fonction de la durée :

Les crédits n'expirent pas. Achetez en volume via le niveaux de crédits pour réduire le coût par appel : le niveau Enterprise diminue le coût effectif d'environ 17 %.

Limites de débit et débit global

L'API Seedance 2.0 Fast autorise la soumission de jobs en parallèle dans des limites raisonnables. Les comptes standard peuvent soumettre 5 à 10 jobs en parallèle sans atteindre les seuils de limitation. Les comptes Enterprise peuvent demander une concurrence plus élevée.

Les jobs de génération individuels prennent 30-150 secondes selon la durée. Avec 5 jobs simultanés, vous pouvez produire efficacement un clip toutes les 15-30 secondes de temps réel.

Pour la génération en lot (50 clips ou plus), soumettez par vagues de 5 à 10, attendez la fin, puis soumettez la vague suivante. N'inondez pas l'API avec des centaines de requêtes simultanées.

Gestion des erreurs

Réponses d'erreur courantes :

400 Bad Request : paramètres invalides. Vérifiez la plage de durée, les valeurs du ratio et la longueur du prompt.

401 Unauthorized : clé API manquante ou invalide.

402 Payment Required : crédits insuffisants. Rechargez via le tableau de bord.

429 Too Many Requests : limite de débit dépassée. Réduisez le rythme et réessayez.

500 Internal Server Error : problème serveur temporaire. Réessayez avec un backoff exponentiel.

Concevez votre intégration pour gérer les erreurs 429 et 500 de façon robuste avec une logique de nouvelle tentative. Un simple backoff exponentiel (1 s, 2 s, 4 s, 8 s) couvre la plupart des échecs transitoires.

Fast vs standard dans le contexte de l'API

Le choix entre les endpoints Fast et standard est avant tout économique :

• Utilisez Fast pour la génération programmatique à fort volume, les applications sensibles aux coûts, et tout ce qui n'est pas un clip phare.
• Utilisez standard pour le contenu de vitrine où le léger avantage de qualité justifie le surcoût de 20 %.

La plupart des applications optent par défaut pour Fast. L'endpoint standard est généralement réservé aux fonctionnalités « niveau premium » ou aux demandes spécifiques des utilisateurs.

URLs des endpoints :

• Fast text : bytedance/seedance-2.0/fast/text-to-video
• Fast image : bytedance/seedance-2.0/fast/image-to-video
• Standard text : bytedance/seedance-2.0/text-to-video
• Standard image : bytedance/seedance-2.0/image-to-video

Support des webhooks

Pour les jobs de longue durée, l'interrogation répétée est inefficace. L'API Seedance 2.0 Fast prend en charge les callbacks webhook : incluez un webhook_url dans le corps de votre requête et vous recevrez un POST à la fin du job :

POST /api/v1/bytedance/seedance-2.0/fast/text-to-video
{
  "prompt": "...",
  "duration": 5,
  "aspect_ratio": "16:9",
  "webhook_url": "https://your-app.com/api/seedance-callback"
}

Votre endpoint webhook reçoit le même payload JSON que l'endpoint de statut renverrait à la fin. Implémentez l'idempotence : les webhooks peuvent réessayer en cas d'échec.

Questions fréquentes, réponses rapides

Quel est le nombre maximum de jobs simultanés que je peux soumettre ? Comptes standard : 5 à 10. Enterprise : négociable.

Les crédits sont-ils déduits en cas de job échoué ? Non. Les jobs échoués remboursent automatiquement les crédits.

Puis-je annuler un job en cours ? Oui, via POST /api/v1/jobs/{job_id}/cancel. Les crédits sont remboursés si l'annulation intervient avant la fin.

Quel est le format du fichier de sortie ? MP4, vidéo H.264, audio AAC, résolution 720p.

Combien de temps les URLs de sortie restent-elles valides ? Les URLs CDN de sortie sont valides 7 jours. Téléchargez-les et stockez-les dans votre propre système pour une conservation à long terme.

Existe-t-il un mode sandbox ou test ? Pas de sandbox dédié. Utilisez vos 10 crédits gratuits à l'inscription pour tester. Le plan Starter à 5 dollars est aussi une façon peu risquée de développer contre de vrais endpoints.

Commencez à construire sur l'API Seedance 2.0 Fast

L'API est volontairement simple : deux endpoints, une tarification déterministe, un modèle de job asynchrone et un plafond de qualité qui correspond au niveau Seedance 2.0 phare. Appuyez-vous dessus pour des outils sociaux, l'automatisation marketing, des plateformes créatives, des moteurs de contenu e-commerce ou des applications créatives internes. L'économie unitaire rend enfin la génération vidéo viable en tant que fonctionnalité intégrée à d'autres produits.

Prêt à construire ? Obtenez votre clé API →

Continuer la lecture : Guide complet de Seedance 2.0 Fast • Tarifs de Seedance 2.0 Fast • Création par lots avec Seedance 2.0 Fast