API Seedance 2.0

L'API vous permet de soumettre des tâches de génération vidéo Seedance 2.0 par programmation. La génération est asynchrone : créez une tâche, recevez un ID de tâche immédiatement, puis obtenez la vidéo terminée en interrogeant le point de terminaison de la tâche ou en recevant un webhook.

Créez une clé API dans le tableau de bord et envoyez-la en tant que jeton Bearer à chaque requête. La clé complète n'est affichée qu'une seule fois au moment de la création.

Authorization: Bearer sk_live_xxxxxxxx

Soumettez d'abord une tâche. Une fois la tâche acceptée, choisissez une méthode de livraison des résultats : interrogez le point de terminaison de la tâche ou recevez le résultat terminal via un webhook.

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "callback_url": "https://your-domain.com/api/seedance/webhook",
    "input": {
      "prompt": "a cat surfing on a neon wave, cinematic lighting",
      "generation_type": "text-to-video",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "generate_audio": true,
      "watermark": false,
      "web_search": false,
      "return_last_frame": false,
      "seed": -1
    }
  }'

curl https://api.seedance2.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer sk_live_xxx"

export async function POST(request: Request) {
  const callbackData = await request.json();

  if (callbackData.status === "completed") {
    const videoUrl = callbackData.data.results[0];
    // Save the video URL or update your own task record here.
  }

  if (callbackData.status === "failed") {
    const errorMessage = callbackData.data.failed_reason;
    // Mark your own task record as failed here.
  }

  return new Response(null, { status: 200 });
}

Créez une tâche vidéo avec POST /v1/videos/generations. Le corps de la requête contient un modèle de niveau supérieur, un callback_url facultatif et un objet d'entrée contenant des paramètres de promtp et de génération.

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "callback_url": "https://your-domain.com/api/seedance/webhook",
    "input": {
      "prompt": "a cat surfing on a neon wave, cinematic lighting",
      "generation_type": "text-to-video",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "generate_audio": true,
      "watermark": false,
      "web_search": false,
      "return_last_frame": false,
      "seed": -1
    }
  }'

generation_type contrôle les entrées média acceptées et la façon dont le modèle les interprète.

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "callback_url": "https://your-domain.com/api/seedance/webhook",
    "input": {
      "prompt": "a cinematic drone shot over a futuristic coastal city at sunrise",
      "generation_type": "text-to-video",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "generate_audio": true,
      "watermark": false,
      "web_search": false,
      "return_last_frame": false,
      "seed": -1
    }
  }'

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "input": {
      "prompt": "the subject turns toward camera, soft studio motion",
      "generation_type": "image-to-video",
      "image_urls": ["https://your.cdn.com/first-frame.jpg"],
      "duration": 5,
      "resolution": "720p"
    }
  }'

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "input": {
      "prompt": "use the product from image 1 and the camera motion from the reference video",
      "generation_type": "reference-to-video",
      "image_urls": ["https://your.cdn.com/product.jpg"],
      "video_urls": ["https://your.cdn.com/camera-motion.mp4"],
      "audio_urls": [],
      "duration": 8,
      "resolution": "1080p"
    }
  }'

Les noms de paramètres, les valeurs d'énumération, les chemins de point de terminaison et les exemples font partie du contrat API. Les descriptions ci-dessous expliquent comment chaque champ se comporte.

Ceci est la réponse de succès de POST /v1/videos/generations. Cela signifie que la tâche a été acceptée et que des crédits ont été réservés. Utilisez le taskId renvoyé pour interroger GET /v1/tasks/:id ou pour correspondre à un rappel de réussite ou d'échec.

{
  "taskId": "3f2aK9mR...",
  "credits": 60
}

Utilisez GET /v1/tasks/:id pour récupérer l'état actuel de la tâche. N'interrogez pas plus d'une fois toutes les 10 secondes. Pour les systèmes de production, préférez les webhooks.

curl https://api.seedance2.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer sk_live_xxx"

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-0",
  "billing_status": "charged",
  "credits": 60,
  "failed_reason": null,
  "data": {
    "results": ["https://cdn.seedance2.ai/.../x.mp4"],
    "video_expires_at": "2026-06-13T10:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

{
  "id": "3f2aK9mR...",
  "status": "failed",
  "created_at": 1781234567,
  "model": "seedance-2-0",
  "billing_status": "refunded",
  "credits": 60,
  "failed_reason": "provider_failed"
}

Lorsque callback_url est présent, Seedance appelle votre point de terminaison lorsque la tâche est terminée ou échouée, et envoie des données JSON décrivant le résultat final. Si votre point de terminaison renvoie une réponse non 2xx ou ne répond pas dans les 15 secondes, la livraison est relancée jusqu'à 5 fois. Les relances réutilisent le même ID de tâche, donc dédoublonnez par ID. Renvoyez une réponse 200 dès que vous avez enregistré les données de rappel en toute sécurité.

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-0",
  "data": {
    "results": ["https://cdn.seedance2.ai/.../x.mp4"],
    "video_expires_at": "2026-06-13T10:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

{
  "id": "3f2aK9mR...",
  "status": "failed",
  "created_at": 1781234567,
  "model": "seedance-2-0",
  "data": {
    "failed_reason": "provider_failed",
    "credits_refunded": 60
  }
}

export async function POST(request: Request) {
  const callbackData = await request.json();

  if (callbackData.status === "completed") {
    const videoUrl = callbackData.data.results[0];
    // Save the video URL or update your own task record here.
  }

  if (callbackData.status === "failed") {
    const errorMessage = callbackData.data.failed_reason;
    // Mark your own task record as failed here.
  }

  return new Response(null, { status: 200 });
}

POST /v1/videos/generations et GET /v1/tasks/:id renvoient cette forme d'erreur lorsque la requête API elle-même échoue, par exemple des paramètres non valides, une clé API non valide, des crédits insuffisants, une limitation de débit ou une tâche introuvable. Certaines erreurs incluent des champs supplémentaires tels que required, available ou retry_after selon la situation.

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits for this task.",
    "required": 60,
    "available": 12
  }
}

Les limites de débit sont appliquées par clé API avec une fenêtre glissante. La génération est par défaut de 60 requêtes par minute ; les requêtes de statut sont plus indulgentes. Les réponses HTTP 429 incluent Retry-After.

L'API utilise la réservation à la soumission, la facturation au succès et le remboursement à l'échec. Les pages d'utilisation du tableau de bord affichent l'historique des crédits API, les journaux de tâches et les statistiques d'utilisation basées sur le temps.