Guide Seedance 2.5 API

Seedance 2.5 API pour une generation video IA rapide

Cette page Seedance 2.5 API explique comment creer un flux leger sur Seedance API v2. Utilisez le modele seedance-2.0 pour des clips compacts, previews, social video et workflows produit a fort volume sans infrastructure GPU.

Duree clip
5-15s

Jobs de 5-15 secondes

Modele
v2

Utiliser seedance-2.0

Entrees
T2V + I2V

Prompt ou images

Interface
REST

JSON via HTTPS

Requete style Mini

Commencez par le modele Seedance 2.0 Mini natif

seedance-2.0
curl -X POST 'https://seedanceapi.org/v2/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance-2.0",
    "prompt": "A cinematic product reveal with smooth dolly-in camera motion",
    "duration": 10,
    "aspect_ratio": "16:9"
  }'

Seedance API v2 expose seedance-2.0 pour les jobs Mini. Utilisez des durees de 5-15 secondes, une sortie 480p ou 720p et des prompts cibles pour une generation legere.

Pourquoi utiliser un workflow Seedance 2.5 API ?

Le workflow Seedance 2.5 API convient lorsque la vitesse, les couts previsibles et l integration REST simple priment sur les rendus cinematographiques longs.

Fait pour les boucles preview rapides

Utilisez des requetes style Seedance 2.5 API pour tester des prompts, comparer des idees de mouvement et creer des clips compacts avant un rendu plus long.

Acces simple par cle API

Les developpeurs s authentifient avec Bearer token, creent des jobs via POST /v2/generate et interrogent GET /v2/status comme avec l API Seedance 2.0 complete.

Limites adaptees a la production

Duree courte, ratios clairs et polling asynchrone facilitent l integration du workflow Seedance 2.5 API dans les files produit et la moderation.

Capacites Seedance 2.5 API

Le workflow 2.5 API se concentre sur les fonctions Seedance 2.0 API utiles aux apps video legeres et aux previews automatiques.

Modele Mini natif

Definissez model sur seedance-2.0 pour obtenir un comportement Seedance 2.5 API adapte aux iterations rapides et aux petits jobs.

Clips text-to-video

Envoyez un prompt concis, un aspect ratio, une resolution et une duration pour generer des assets video courts pour apps, social media et tests creatifs.

Mouvement image-to-video

Fournissez une a quatre image URLs, ou des reference video URLs compatibles Mini, avec un payload Seedance 2.5 API compact.

Durees courtes

Utilisez toute duree entiere de 4 a 15 secondes, avec 8 secondes comme point de depart pratique pour des previews 2.5 API.

Polling statut asynchrone

Chaque requete retourne un task id, afin que votre app puisse suivre le statut, mettre a jour l UI et recuperer l URL finale.

Base v2 commune

Le workflow Seedance 2.5 API utilise les memes authentication, billing et response shape v2 que l API Seedance 2.0 generale.

Comment utiliser Seedance 2.5 API

Partez des endpoints Seedance API v2 existants et ajustez la requete pour un output compact.

1

Creer une cle API

Connectez-vous, ouvrez la page API Keys et copiez une cle pour usage serveur. Gardez-la hors du code navigateur et des repos publics.

2

Envoyer un job Mini

Appelez POST /v2/generate avec model seedance-2.0, un prompt serre, duration 8, resolution 720p et l aspect ratio requis.

3

Interroger et afficher

Utilisez GET /v2/status avec task_id. Quand le statut est SUCCESS, lisez data.response[0] puis affichez ou stockez l URL video.

Pattern de requete Seedance 2.5 API

Le flux 2.5 API reste volontairement simple : authentifier, creer une tache, puis interroger jusqu a la fin.

POST /v2/generate

Cree une tache Seedance 2.0 Mini. Utilisez des prompts texte pour text-to-video, images pour image-to-video ou reference_video_urls pour une entree video.

GET /v2/status

Retourne l etat, les details d echec ou le tableau response final avec l URL video generee.

Callback URL optionnel

Pour les systemes asynchrones, ajoutez un callback_url public si l integration le supporte. N utilisez pas localhost.

Parametres 2.5 API recommandes

ParametreValeur recommandee
modelUtilisez seedance-2.0 pour le workflow 2.5 API.
promptRestez precis et concret ; maximum 2000 caracteres.
durationToute valeur entiere de 4 a 15 secondes.
resolutionUtilisez 480p ou 720p pour la sortie Mini.
aspect_ratio16:9, 9:16, 4:3, 3:4, 1:1, 21:9 ou adaptive pour text-to-video.
imagesUne a quatre image URLs HTTPS pour image-to-video.
reference_video_urlsReference video URLs optionnelles compatibles Mini pour generation guidee par video.
reference_audio_urlsReference audio URLs optionnelles pour generation compatible Mini.
callback_urlWebhook URL public optionnel pour notifications async.

Consultez la documentation Seedance 2.0 API v2 pour la reference complete. Cette page reduit la meme API a une implementation 2.5 planning.

Meilleurs cas d usage Seedance 2.5 API

Les workflows 2.5 API sont adaptes aux previews de mouvement rapides ou a la video generee legere dans un produit existant.

Previews social video

Generez des clips verticaux compacts pour feed previews, idees publicitaires et outils createurs.

Tests de mouvement produit

Animez des product shots ou visuels de campagne avec de courtes requetes image-to-video avant validation finale.

Outils d iteration prompt

Permettez aux utilisateurs de tester vite de nombreuses variantes, comparer les resultats et promouvoir le meilleur prompt.

Automatisation a haut volume

Utilisez des short fast jobs pour batch previews, pipelines de contenu et apps a debit previsible.

Notes d integration production

Un workflow Seedance 2.5 API requiert le meme soin operationnel que toute integration video API en production.

Appeler depuis le backend

Stockez les cles API sur votre serveur, appelez Seedance API depuis le backend et n exposez aux clients que vos endpoints securises.

Mettre en file et retenter

Utilisez une queue pour gerer la concurrence, retenter les erreurs transitoires et garder l interface reactive.

Suivre credits et statut

Surveillez credit usage, task status et error responses pour garder le workflow 2.5 API previsible.

Seedance 2.5 API vs usage v2 standard

2.5 API est un choix de workflow au-dessus de Seedance API v2. Pour des clips rapides, utilisez-le ; pour qualite ou duree, passez au standard.

2.5 API privilegie la vitesse

Utilisez fast routing, durees courtes et prompts serres lorsque vous voulez un feedback rapide.

Standard v2 privilegie la qualite

Utilisez le chemin standard Seedance 2.0 lorsque qualite cinematographique et scenes riches sont prioritaires.

Une base API commune

Authentication, billing, status polling et response parsing restent coherents entre 2.5 planning et v2 standard.

Capacite2.5 planningUsage v2 standard
Model hintseedance-2.0seedance-2.0
Duree ideale5-15 secondes5, 10 ou 15 secondes
Meilleur usagePreviews, batches, iteration rapideCreative final, storytelling plus riche
Forme APIMemes /v2/generate et /v2/statusMemes /v2/generate et /v2/status

FAQ Seedance 2.5 API

Reponses pour les developpeurs qui evaluent une integration style Seedance 2.5 API.

Existe-t-il un endpoint Seedance 2.5 API separe ?

Oui. Utilisez Seedance API v2 avec model seedance-2.0. La route publique est POST /v2/generate puis GET /v2/status.

A quoi sert le mieux Seedance 2.5 API ?

Aux short previews, tests social video, brouillons product motion et iterations prompt a haut volume.

Puis-je utiliser image-to-video ?

Oui. Envoyez une a quatre image URLs dans images et gardez le prompt centre sur le mouvement voulu.

Quelle duree choisir au depart ?

Mini prend en charge toute duree entiere de 4 a 15 secondes. Commencez par 8 secondes pour des previews rapides, puis augmentez la duree pour une scene plus complete.

Quels aspect ratios sont supportes ?

Pour text-to-video, Mini accepte 16:9, 9:16, 4:3, 3:4, 1:1, 21:9 et adaptive. Choisissez le ratio adapte a votre placement.

Comment authentifier les requetes ?

Passez Authorization: Bearer YOUR_API_KEY sur chaque requete. Gardez cette cle dans votre backend.

Comment recuperer l URL video finale ?

Interrogez GET /v2/status avec task_id. Quand status vaut SUCCESS, lisez la premiere URL dans data.response[0].

Cela marche-t-il avec tout langage ?

Oui. Le workflow utilise HTTPS et JSON standard, donc cURL, Python, Node.js, Go, Java et autres clients HTTP.

Dois-je appeler l API depuis le navigateur ?

Non. Utilisez backend ou BFF pour proteger les cles API, valider les prompts, limiter le debit et gerer les retries.

Comment fonctionne la facturation ?

Seedance API utilise des credits. Le cout depend du modele et de la duree ; les short fast jobs sont plus faciles a prevoir.

Puis-je passer du 2.5 planning au standard Seedance 2.0 ?

Oui. Gardez le meme endpoint et changez model hint, duration et prompt strategy pour des rendus production de meilleure qualite.

Ou trouver la documentation complete ?

Ouvrez la doc Seedance 2.0 API v2 pour le schema complet, les exemples de reponse, les tarifs et les codes erreur.

Creez votre premier job Seedance 2.5 API

Creez une API key, envoyez une courte requete Mini et ajoutez la generation video IA legere a votre produit.