Introduction
Seedance 1.5 Pro image vers vidéo commence le clip sur une image que vous fournissez et l’anime jusqu’à 12 secondes. Avec camera_fixed activé, le cadrage fourni reste exactement tel qu’il a été composé, et c’est pourquoi ce point de terminaison produit des plates exploitables.
ByteDance Seedance 1.5 Pro publie deux points de terminaison, texte vers vidéo et image vers vidéo. Tous deux renvoient des clips de 4 à 12 secondes en 480p, 720p ou 1080p avec un son natif, et tous deux disposent de l’interrupteur camera_fixed.
Choisir le mode Seedance 1.5 Pro selon votre matériau de départ
| Matériau de départ | Mode |
|---|---|
| Une image de départ validée | Seedance 1.5 Pro Image vers vidéo |
| Un script ou la description d’une scène | Seedance 1.5 Pro Texte vers vidéo |
Fonctionnalités et points forts
camera_fixed tient le cadre
Sur false, la valeur par défaut, le modèle invente ses propres mouvements : une dérive, un travelling avant, une orbite lente. Sur true, la caméra s’arrête tandis que le sujet continue de bouger dans le cadre. Un cadre fixe se tracke, s’incruste, se compose ou se boucle, et ni Seedance 2.0 ni 2.5 ne proposent cet interrupteur.
Le son dans la même passe
generate_audio vaut true par défaut et produit ambiance, bruits de mouvement et voix calés sur les images. La requête passe alors à un palier tarifaire supérieur : coupez-le pour les boucles produit et les plans qui seront sonorisés plus tard.
Un plafond clair
Les clips durent de 4 à 12 secondes pleines en 480p, 720p ou 1080p, dans six formats fixes avec 16:9 par défaut et sans option adaptative. Il n’y a pas de point de terminaison de références ; seed est disponible en 480p et 720p. Les projets qui demandent de la 4K, des prises plus longues ou une distribution à plusieurs images relèvent de Seedance 2.0 ou 2.5 ; ce que 1.5 Pro garde, c’est la caméra verrouillée.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Obligatoire, et il doit dire ce qui se passe après l’image plutôt que redire ce qui est déjà visible : l’action, l’écoulement du temps, le son. 3 caractères minimum |
image_url | Oui | Lien public et directement téléchargeable vers la première image ; obligatoire. |
last_image_url | Non | Image de fin facultative : envoyée avec |
aspect_ratio | Non | Cadrage de sortie, six valeurs fixes, 16:9 par défaut. |
resolution | Non | Résolution de sortie, 720p par défaut et 1080p au maximum ; rien de plus haut n’est proposé ici. Elle fixe un palier tarifaire. |
duration_seconds | Non | Durée en secondes entières, de 4 à 12, 5 par défaut, et c’est la quantité facturée. |
generate_audio | Non | Détermine si une bande-son native est rendue en synchronisation avec l’image. Valeur par défaut: |
camera_fixed | Non | Verrouille la caméra, false par défaut. Valeur par défaut: |
seed | Non | Entier de 0 à 2147483647 pour le départ aléatoire ; sans lui, chaque exécution tire le sien. |
Tarification
| Résolution | Générer l’audio: Non | Générer l’audio: Oui |
|---|---|---|
| $0.0112 / seconde | $0.0223 / seconde |
| $0.0227 / seconde | $0.0454 / seconde |
| $0.0491 / seconde | $0.0982 / seconde |
Cas d’utilisation
Des plates pour le compositing
Envoyez une image déjà validée, activez camera_fixed, et la composition tient pendant tout le clip tandis que seul le sujet bouge. Le résultat se comporte comme une prise sur pied : un fond propre pour l’incrustation, une surface stable pour tracker un titre, une plate qu’un monteur peut intégrer à une vraie séquence.
Présentoirs rotatifs et boucles produit
Un cadre fixe avec un objet qui tourne est le cas d’école : rien ne dérive, l’horizon reste droit et la dernière image tombe assez près de la première pour boucler. Coupez generate_audio, car une boucle produit ne veut presque jamais de son d’ambiance.
Un mouvement lent du décor
L’exemple publié superpose neige qui tombe, vapeur qui monte et eau sur une seule image, avec un travelling avant très lent pour que rien ne soit masqué par la vitesse de la caméra. La météo, la fumée et l’eau sont justement les mouvements qu’une composition tenue met le mieux en valeur.
Guide de prompt et conseils pratiques
Envoyez les deux champs obligatoires
Ici, prompt et image_url sont tous deux obligatoires, et le prompt doit compter au moins 3 caractères. L’image doit être un JPEG, PNG ou WebP public, téléchargeable directement, de moins de 10 Mo. Textes, filigranes et logos présents dans l’image passent dans la vidéo : retirez-les avant.
Accordez le format à l’image
Il n’y a pas d’option adaptative, et aspect_ratio vaut 16:9 par défaut. Si le format demandé diffère de la source, l’image est recadrée et le sujet peut perdre ses marges : choisissez le format de votre image.
Adaptez l’exemple fourni
L’exemple publié utilise aspect_ratio 16:9, duration_seconds 5 et resolution 720p, avec l’audio laissé sur sa valeur par défaut.
Snow keeps falling through the lantern light and steam pours off the water. She sets the folded towel robe down on the rock and sinks slowly into the spring up to her collarbone, tipping her head back and exhaling a long plume of breath into the cold air. Steam swells across the frame and snow settles on her wet hair. Very slow push-in, warm lantern gold against deep blue snow.
L’image apporte les lanternes et le décor ; le prompt ne fait que la plonger dans la source et la laisser expirer. Gardez ce partage en utilisant votre propre image.
Gardez le mouvement dans un cadre verrouillé
Avec camera_fixed sur true, ne décrivez que du mouvement à l’intérieur du cadre, car une consigne de caméra et une caméra verrouillée se contredisent. Validez le mouvement à 4 ou 5 secondes avant de passer à 12, puisqu’une prise plus longue s’éloigne davantage de son image de départ.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedance-1.5-pro/image-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"generate_audio": true,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
















