API Seedance 2.0 Fast : Point de terminaison de génération vidéo économique

Une requête HTTP, un clip vidéo de qualité cinéma en IA, 1,94 dollars. C'est l'économie unitaire de la construction sur l'API rapide Seedance 2.0. Des endpoints dédiés pour la génération texte-vers-vidéo et image-vers-vidéo, 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 quand vous fonctionnez à grande échelle.

Voici le guide complet pour les développeurs.

À quoi sert l'API rapide

Si vous construisez une application, un outil ou un service qui génère de la vidéo pour les utilisateurs - planificateur de réseaux sociaux, plateforme d'automatisation marketing, moteur de contenu e-commerce, outil créatif interne - l'API rapide Seedance 2.0 est l'endpoint de qualité cinéma le moins cher sur lequel vous pouvez construire en 2026.

La même qualité visuelle que Seedance 2.0 standard. Coût par seconde inférieur. Débit de calcul plus élevé. Conçu pour l'intégration dans des workflows qui produisent de la vidéo en volume.

L'utilisateur cible typique est un développeur ou une équipe qui a besoin de générer de la vidéo par programme en fonction de l'entrée de l'utilisateur - pas un créateur unique générant un clip à la fois via l'interface.

Les deux endpoints

Endpoint texte-vers-vidéo:

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

Génère une vidéo à partir d'une invite textuelle. Aucune image source requise.

Endpoint image-vers-vidéo:

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

Génère une vidéo en commençant par une image source téléchargée avec une invite de mouvement.

Les deux endpoints acceptent des corps de requête similaires et retournent le même format de réponse. Choisissez en fonction de si vous avez une image source à animer.

Authentification

Chaque requête a besoin d'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. Rotationnez-les au besoin via le tableau de bord.

Format de requête: Texte-vers-vidéo

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 (obligatoire, chaîne): L'invite textuelle décrivant la vidéo désirée.
• duration (obligatoire, entier): Durée du clip en secondes. Plage: 4-15.
• aspect_ratio (obligatoire, chaîne): L'une de "16:9", "9:16", "1:1".

Format de requête: Image-vers-vidéo

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 (obligatoire, chaîne): URL publiquement accessible de l'image source. Formats supportés: JPG, PNG, WebP.
• prompt (obligatoire, chaîne): Invite de mouvement décrivant comment animer l'image.
• duration (obligatoire, entier): Durée du clip en secondes. Plage: 4-15.
• aspect_ratio (obligatoire, chaîne): Doit correspondre au format d'image source pour les meilleurs résultats.

Format de réponse

Les deux endpoints retournent un ID de tâche asynchrone:

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

Vérifiez le statut via l'endpoint de statut jusqu'à ce que la tâche soit complète:

GET /api/v1/jobs/sdf_2026_abc123xyz

Une réponse complétée:

{
  "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 l'video_url et vous avez 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"
    }
    
    # Submit generation job
    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 queued: {job_id}, estimated {job['estimated_seconds']}s")
    
    # Poll for completion
    while True:
        time.sleep(10)
        status = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers=headers
        ).json()
        
        if status["status"] == "completed":
            print(f"Complete: {status['video_url']}")
            return status["video_url"]
        elif status["status"] == "failed":
            raise Exception(f"Generation failed: {status.get('error')}")
        else:
            print(f"Status: {status['status']}")

# Usage
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'
  };

  // Submit generation job
  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 queued: ${job.job_id}`);

  // Poll for completion
  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(`Generation failed: ${status.error}`);
    }
  }
}

// Usage
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? Obtenir 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 gros via niveaux de crédits pour de meilleures économies par appel - le tier Enterprise réduit le coût effectif d'environ 17%.

Limites de débit et débit

L'API rapide Seedance 2.0 permet les soumissions de tâches concurrentes dans des limites raisonnables. Les comptes typiques peuvent soumettre 5-10 tâches en parallèle sans atteindre les limites. Les comptes tier Enterprise peuvent demander une concurrence plus élevée.

Les tâches de génération individuelles prennent 30-150 secondes selon la durée. Avec 5 tâches concurrentes, vous pouvez effectivement produire un clip toutes les 15-30 secondes de temps mural.

Pour la génération par lot en masse (50+ clips), soumettez par vagues de 5-10, attendez la fin, puis soumettez la vague suivante. Ne surchargez 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 de format d'image, la longueur de l'invite.

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. Attendez et réessayez.

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

Construisez votre intégration pour gérer gracieusement 429 et 500 avec une logique de retry. Un simple backoff exponentiel (1s, 2s, 4s, 8s) couvre la plupart des défaillances transitoires.

Fast vs Standard dans le contexte de l'API

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

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

La plupart des applications utilisent par défaut Fast. L'endpoint standard est généralement réservé aux fonctionnalités "tier premium" ou aux demandes utilisateur spécifiques.

URLs des endpoints:

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

Support des webhooks

Pour les tâches longues, le polling est gaspilleur. L'API rapide Seedance 2.0 supporte les callbacks webhook - incluez une webhook_url dans votre corps de requête et vous recevrez un POST quand la tâche se termine:

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 retournerait lors de la fin. Implémentez l'idempotence - les webhooks peuvent réessayer en cas d'échec.

Questions courantes, réponses rapides

Quel est le maximum de tâches concurrentes que je peux soumettre? Comptes typiques: 5-10. Enterprise: négociable.

Les crédits se déduisent sur les tâches échouées? Non. Les tâches échouées remboursent automatiquement les crédits.

Puis-je annuler une tâche en cours? Oui, via POST /api/v1/jobs/{job_id}/cancel. Rembourse les crédits si annulé avant la fin.

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

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

Y a-t-il un mode sandbox/test? Pas de sandbox dédié. Utilisez vos 50 crédits gratuits d'inscription pour tester. Le tier Starter à 10 dollars est aussi un moyen peu risqué de construire contre des endpoints réels.

Commencez à construire sur l'API rapide Seedance 2.0

L'API est délibérément simple: deux endpoints, tarification déterministe, modèle de tâche asynchrone, et un plafond de qualité qui correspond au tier phare Seedance 2.0. Construisez dessus pour les outils sociaux, l'automatisation marketing, les plateformes créateur, les moteurs de contenu e-commerce, ou les applications créatives internes. L'économie unitaire rend enfin la génération vidéo viable comme fonctionnalité à l'intérieur d'autres produits.

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

Continuez à lire: Guide complet Seedance 2.0 Fast • Tarification Seedance 2.0 Fast • Création par lot Seedance 2.0 Fast