API Seedance

L'API vous permet de soumettre des tâches de génération vidéo Seedance 2.5 et Seedance 2.0 de manière programmatique. Seedance 2.5 est le modèle recommandé et prend en charge le text-to-video, l'image-to-video (première image ou première et dernière images) et le reference-to-video multimodal. La génération est asynchrone : vous créez une tâche, recevez immédiatement un ID de tâche, puis récupérez la vidéo finale en interrogeant l'API (polling) ou via un webhook.

Générez une clé API dans votre tableau de bord et transmettez-la en tant que jeton Bearer lors de chaque requête. La clé complète ne s'affiche qu'une seule fois au moment de sa création.

Authorization: Bearer sk_live_xxxxxxxx

Commencez par soumettre une tâche. Une fois celle-ci acceptée, choisissez votre méthode de récupération du résultat : interrogez le point de terminaison de la tâche (polling) ou recevez le résultat final via un webhook.

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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
    }
  }'

curl https://api.seevio.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 de génération vidéo via une requête POST sur /v1/videos/generations. Le corps de la requête doit contenir un modèle de niveau supérieur, un paramètre callback_url optionnel et un objet input contenant le prompt et les paramètres de génération.

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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
    }
  }'

Le paramètre generation_type détermine les types de médias acceptés en entrée et la manière dont le modèle les interprète.

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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
    }
  }'

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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": "720p"
    }
  }'

Les noms de paramètres, les valeurs d'énumération, les chemins d'accès et les exemples font partie intégrante du contrat de l'API. Les descriptions ci-dessous expliquent le comportement de chaque champ.

Il s'agit de la réponse de succès renvoyée par POST /v1/videos/generations. Elle confirme que la tâche a été acceptée et que les crédits ont été réservés. Utilisez le taskId retourné pour interroger le point de terminaison GET /v1/tasks/:id ou pour identifier la notification de succès ou d'échec.

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

Utilisez la requête GET /v1/tasks/:id pour récupérer l'état actuel d'une tâche. Limitez vos requêtes à une toutes les 10 secondes au maximum. Pour les systèmes en production, privilégiez l'usage des webhooks.

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

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-5",
  "billing_status": "charged",
  "credits": 100,
  "failed_reason": null,
  "data": {
    "results": ["https://cdn.seevio.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-5",
  "billing_status": "refunded",
  "credits": 100,
  "failed_reason": "provider_failed"
}

Si callback_url est renseigné, Seedance appelle votre point de terminaison dès que la tâche est terminée (succès ou échec) et lui transmet les données JSON du résultat final. Si votre serveur renvoie un code autre que 2xx ou ne répond pas dans les 15 secondes, la notification est tentée de nouveau jusqu'à 5 fois. Les tentatives successives conservent le même ID de tâche ; veillez à dédoublonner les requêtes reçues à l'aide de cet ID. Renvoyez une réponse HTTP 200 dès que vous avez enregistré les données du webhook.

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-5",
  "data": {
    "results": ["https://cdn.seevio.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-5",
  "data": {
    "failed_reason": "provider_failed",
    "credits_refunded": 100
  }
}

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 });
}

Les requêtes POST /v1/videos/generations et GET /v1/tasks/:id renvoient ce format d'erreur lorsque la requête API échoue (paramètres non valides, clé API incorrecte, crédits insuffisants, limite de requêtes atteinte ou tâche introuvable). Selon le cas, certaines erreurs contiennent des champs supplémentaires comme required, available ou retry_after.

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

Les limites de requêtes s'appliquent par clé API selon un principe de fenêtre glissante. Par défaut, la génération est limitée à 100 requêtes par minute ; les requêtes de statut de tâche bénéficient d'une limite plus souple. Les réponses HTTP 429 incluent l'en-tête Retry-After.

L'API applique un principe de réservation à la soumission, de facturation en cas de succès et de remboursement en cas d'échec. Les pages de suivi de consommation de votre tableau de bord affichent l'historique des crédits API, les journaux d'activité et des statistiques d'utilisation détaillées.