> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API ByteDance Seedance sur Krea

> Utilisez ByteDance Seedance 2.5 et 2.0 via l'API Krea. Générez des vidéos à partir de texte ou d'images avec des exemples REST et JavaScript, des clés API et les tarifs.

Krea donne accès par API aux modèles de génération vidéo Seedance de ByteDance. Utilisez l'API Seedance sur Krea pour générer des vidéos à partir de texte, animer des images ou guider la génération avec des références image, vidéo et audio. Les requêtes utilisent un jeton API Krea et l'URL de base `https://api.krea.ai`.

## Modèles disponibles dans l'API Seedance

| Modèle | Endpoint POST | Durée de la vidéo | Résolution de sortie |
| - | - | - | - |
| Seedance 2.5 | `/generate/video/bytedance/seedance-2-5` | 4 à 30 secondes | 480p, 720p, 1080p |
| Seedance 2.0 | `/generate/video/bytedance/seedance-2` | 4 à 15 secondes | 480p, 720p, 1080p, 4K |
| Seedance 2.0 Fast | `/generate/video/bytedance/seedance-2-fast` | 4 à 15 secondes | 480p, 720p |
| Seedance 2.0 Mini | `/generate/video/bytedance/seedance-2-mini` | 4 à 15 secondes | 480p, 720p |

Ces modèles prennent en charge le texte vers vidéo, les images de début et de fin, les médias de référence et l'audio natif. Consultez la [référence de l'API](https://www.krea.ai/docs/api-reference/introduction.md) pour le schéma de requête actuel de chaque modèle. Vérifiez les [tarifs de l'API ↗](https://www.krea.ai/app/api/pricing) avant de soumettre un job : le prix dépend du modèle et des paramètres de génération.

> [!NOTE]
>
> Les endpoints Seedance 2.0 et 2.0 Fast de Krea incluent, en option, l'amélioration de prompt et l'upscaling de Krea en plus du modèle de base. Seedance 2.5 inclut, en option, l'amélioration de prompt de Krea. Pour les requêtes de montage vidéo Seedance 2.5 avec `reference_videos`, la durée et le format de sortie proviennent de la vidéo source ; `duration` et `aspect_ratio` sont ignorés pour ces requêtes.

## Obtenir une clé API Seedance

Créez un jeton API Krea et ajoutez du solde API en suivant [Clés API et facturation](https://www.krea.ai/docs/fr/developers/api-keys-and-billing.md). Stockez le jeton dans la variable d'environnement `KREA_API_KEY` sur votre serveur. Envoyez-le sous la forme `Authorization: Bearer $KREA_API_KEY` et ne l'exposez jamais dans du code exécuté dans le navigateur.

Le compute de l'application Krea et le solde API sont distincts. Les requêtes Seedance passant par l'API Krea utilisent le solde API de votre espace de travail.

## Générer une vidéo

Soumettez un prompt à l'endpoint Seedance 2.5 pour une génération texte vers vidéo. Ces exemples demandent une vidéo de cinq secondes, en 720p et au format paysage.

```bash cURL theme={"theme":{"light":"github-light-default","dark":"vesper"}}
curl --fail-with-body https://api.krea.ai/generate/video/bytedance/seedance-2-5 \
  -H "Authorization: Bearer $KREA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A slow camera orbit around a ceramic vase in warm studio light",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'
```

```javascript JavaScript theme={"theme":{"light":"github-light-default","dark":"vesper"}}
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const job = await krea.video("bytedance/seedance-2-5", {
  prompt: "A slow camera orbit around a ceramic vase in warm studio light",
  duration: 5,
  aspect_ratio: "16:9",
  resolution: "720p"
});

const completed = await krea.jobs.wait(job.job_id);
console.log(completed.result.urls[0]);
```

Installez le SDK JavaScript avec `npm install @krea-ai/sdk`. La requête REST renvoie un `job_id`, et non la vidéo terminée. Interrogez `GET /jobs/{job_id}` toutes les 2 à 5 secondes jusqu'à ce que `status` vaille `completed`, puis lisez l'URL de la vidéo dans `result.urls[0]`. Arrêtez le polling en cas de `failed` ou `cancelled`. La méthode `jobs.wait` du SDK gère le polling pour vous.

```bash cURL theme={"theme":{"light":"github-light-default","dark":"vesper"}}
curl --fail-with-body "https://api.krea.ai/jobs/YOUR_JOB_ID" \
  -H "Authorization: Bearer $KREA_API_KEY"
```

Pour les intégrations en production, utilisez les [webhooks](https://www.krea.ai/docs/fr/developers/webhooks.md) pour recevoir les événements de fin de job. Consultez [Cycle de vie d'un job](https://www.krea.ai/docs/fr/developers/job-lifecycle.md) et [Erreurs et débogage](https://www.krea.ai/docs/fr/developers/errors-and-debugging.md) pour les états des jobs et la gestion des échecs.

## Animer une image

Pour la génération image vers vidéo avec Seedance, utilisez le même endpoint et ajoutez `start_image` à votre requête. Fournissez une URL d'image accessible publiquement, l'URL d'un asset téléversé ou une data URI en base64.

```json theme={"theme":{"light":"github-light-default","dark":"vesper"}}
{
  "prompt": "The camera slowly moves closer as soft light shifts across the scene",
  "start_image": "https://your-domain.example/product.png",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p"
}
```

Remplacez `start_image` par l'URL de votre propre image. Pour contrôler l'image finale, ajoutez `end_image`. Pour une génération guidée par des références, utilisez `reference_images`, `reference_videos` et `reference_audios` conformément au [schéma de l'API](https://www.krea.ai/docs/api-reference/introduction.md) du modèle sélectionné.

## Questions fréquentes

### Krea propose-t-il une API ByteDance Seedance ?

Oui. Krea propose ByteDance Seedance 2.5, Seedance 2.0, Seedance 2.0 Fast et Seedance 2.0 Mini via son API REST à l'adresse `https://api.krea.ai`. Authentifiez-vous avec un jeton API Krea et envoyez une requête à l'un des endpoints Seedance listés ci-dessus.

### Puis-je utiliser Seedance pour le texte vers vidéo et l'image vers vidéo ?

Oui. Envoyez un `prompt` pour le texte vers vidéo, ou ajoutez `start_image` pour animer une image. Les deux workflows utilisent le même endpoint de modèle Seedance et renvoient un job asynchrone.

### Ai-je besoin d'une clé API ByteDance distincte ?

Non. Les appels à Seedance via Krea utilisent votre jeton API Krea et le solde API de votre espace de travail. Vous n'avez pas besoin d'envoyer d'identifiant ByteDance distinct avec ces requêtes.

### Combien coûte l'API Seedance sur Krea ?

Consultez les [tarifs de l'API Krea ↗](https://www.krea.ai/app/api/pricing) pour connaître les prix actuels de Seedance et les paramètres disponibles. L'utilisation de l'API est facturée séparément du compute de l'application Krea. Les jobs échoués et annulés ne sont pas facturés.

### Puis-je appeler Seedance depuis un agent IA ?

Oui. Connectez un agent au [serveur MCP de Krea](https://www.krea.ai/docs/fr/developers/mcp.md) pour découvrir les modèles vidéo disponibles et leurs schémas. Vous pouvez aussi appeler l'API REST ou le SDK JavaScript directement depuis votre application.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.