Communitygithub.com

cheercheung/seedance-2-5-generateur-video-api-skill

Démarrage rapide de l'API Seedance 2.5 et compétence agent pour les cinq workflows vidéo via EvoLink

Qu'est-ce que seedance-2-5-generateur-video-api-skill ?

Cette compétence pour agent AI permet aux développeurs et utilisateurs d'interagir avec l'API Seedance 2.5 via EvoLink pour générer, éditer ou étendre des vidéos. Elle prend en charge cinq modes distincts : texte vers vidéo, image vers vidéo, génération par référence, édition vidéo et extension vidéo. L'agent guide l'utilisateur à travers chaque étape, de la compréhension du livrable à la construction de la requête JSON et à l'exécution simulée (dry-run) sans frais. La compétence valide automatiquement la clé API EvoLink, vérifie la disponibilité des routes officielles et respecte des contraintes strictes comme la durée (4 à 30 secondes), le rapport hauteur/largeur et les formats de sortie (MP4, MOV). Elle intègre un script shell (`seedance-2-5-video-gen.sh`) qui gère les appels API, les sondages de progression et les callbacks HTTPS. La compétence insiste sur la sécurité : elle ne promet jamais une cohérence parfaite des visages ou logos, refuse les contenus illégaux et conserve le filtre de contenu activé par défaut. Elle est idéale pour créer des prompts vidéo optimisés, des plans de scène structurés et des requêtes API validées, que ce soit pour des publicités, démos produits, clips cinématiques ou réseaux sociaux.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add cheercheung/seedance-2-5-video-generate-api-skill

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Génération Vidéo Seedance 2.5

Transformez une intention vidéo brute en un prompt Seedance 2.5 cohérent et une requête API EvoLink validée pour le texte, l'image, la génération par référence, l'édition vidéo ou l'extension vidéo

Limite de disponibilité : vérifiez les cinq routes officielles actuelles de la documentation avant toute tâche en direct. Un schéma valide ou un dry-run réussi ne prouve pas l'accès au compte ou la disponibilité en production

Quand Activer Cette Compétence

Activez-la lorsque l'utilisateur demande à :

  • Créer ou améliorer un prompt vidéo Seedance 2.5
  • Construire une charge utile API Seedance 2.5
  • Générer une vidéo à partir de texte
  • Animer une image ou une paire première/dernière image
  • Utiliser des images, vidéos ou audio comme références
  • Éditer ou étendre une vidéo de référence
  • Planifier un seul plan continu ou une courte séquence multi-plans
  • Exécuter, simuler, dépanner ou intégrer une requête EvoLink Seedance 2.5

N'activez pas pour :

  • Les questions sur les nouvelles du modèle, les benchmarks, la disponibilité ou le prix sans tâche de génération
  • L'édition vidéo générique qui n'utilise pas Seedance 2.5
  • Les demandes de fabrication d'actifs de référence manquants
  • Les demandes nécessitant une garantie d'identité, de logo ou de cohérence parfaite au niveau de l'image

Workflows Pris en Charge

ModeID du modèleMédia requisEntrée non prise en charge
textseedance-2.5-text-to-videoAucunTableaux d'URL d'images, vidéos et audio
imageseedance-2.5-image-to-videoUne ou deux image_urlsTableaux d'URL de vidéos et audio ; recherche web
referenceseedance-2.5-reference-to-videoAu moins une URL d'image, vidéo ou audioIntention d'édition/extension, recherche web et média Base64
editseedance-2.5-video-editUne à dix video_urls ; la première vidéo est la cible d'éditionDurée personnalisée, rapport hauteur/largeur fixe, recherche web et média Base64
extendseedance-2.5-video-extendUne à dix video_urls ; la première vidéo est la cible d'extensionRapport hauteur/largeur fixe, recherche web et média Base64

Les prompts de référence doivent identifier les matériaux explicitement comme @image1, @video1 et @audio1

Emplacement du Script

Résolvez chaque chemin par rapport au répertoire contenant ce SKILL.md :

SKILL_DIR = répertoire contenant ce SKILL.md
SCRIPT = {SKILL_DIR}/scripts/seedance-2-5-video-gen.sh

Après l'Installation

  1. Vérifiez si EVOLINK_API_KEY est définie sans imprimer sa valeur
  2. Si manquante, ouvrez ou affichez https://evolink.ai/dashboard/keys?utm_source=skill&utm_medium=install&utm_campaign=seedance-2-5-video-gen
  3. Demandez à l'utilisateur de créer ou sélectionner une clé et de la coller en retour
  4. Sauvegardez-la comme EVOLINK_API_KEY pour la session en cours et proposez un stockage persistant dans le shell
  5. Validez-la avec le chemin non générateur GET /v1/credits avant une tâche réelle
  6. Lancez la sonde de disponibilité et expliquez l'état officiel actuel

Commandes :

export EVOLINK_API_KEY="cle_utilisateur"
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh --validate-key
{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh --check-availability

N'exposez jamais la clé dans les logs et ne la répétez pas à l'utilisateur

Principes Fondamentaux

  1. Préservez l'intention de l'utilisateur, les actifs approuvés, la durée, le rapport hauteur/largeur, le dialogue et les contraintes de silence
  2. Concevez le mouvement dans le temps : état d'ouverture, action principale, comportement de la caméra, mouvement de fond et état de fin
  3. Gardez l'action physiquement plausible pour 4 à 30 secondes et évitez de tasser de nombreuses scènes dans un court clip
  4. Séparez la direction visuelle du dialogue, des effets sonores, de l'ambiance et de la musique
  5. Préférez un seul plan cohérent sauf si l'utilisateur demande explicitement une séquence et que la durée peut la supporter
  6. Décrivez les cibles de continuité sans promettre une cohérence parfaite ou un contrôle précis au niveau de l'image
  7. Validez la charge utile avant tout appel et ne réessayez jamais après TASK_SUBMITTED sauf si l'utilisateur approuve explicitement une nouvelle tâche payante

Flux

Étape 1 : Comprendre le Livrable

Extrayez :

  • Utilisation prévue : publicité, démo produit, plan cinématique, clip social, édition, extension ou autre
  • Durée et rapport hauteur/largeur
  • Sujet et environnement
  • Image d'ouverture, action temporelle et image de fin
  • Mouvement et stabilité de la caméra
  • Audio, dialogue, effets sonores, ambiance ou silence
  • Actifs de référence et rôle prévu de chacun
  • Préférence de sortie : prompt, plan Markdown, charge utile JSON, dry-run ou tâche en direct

Étape 2 : Choisir le Mode

  • Aucune entrée média : text
  • Une ou deux images qui définissent la première image ou les images première/dernière : image
  • Références de style, identité, produit, mouvement ou audio utilisées pour générer de nouvelles séquences : reference
  • Modifier le contenu d'une vidéo existante tout en préservant sa timeline : edit
  • Continuer une vidéo existante vers l'avant ou l'arrière : extend

N'envoyez pas d'intention d'édition ou d'extension à reference : l'API peut accepter la requête initialement puis échouer lors de l'exécution du modèle

Si le mode est ambigu, posez une question compacte qui inclut toutes les informations obligatoires manquantes

Étape 3 : Construire le Prompt Vidéo

Utilisez cet ordre :

  1. Format du plan et durée
  2. Sujet, détails de la garde-robe/produit et environnement
  3. État d'ouverture
  4. Action principale et progression temporelle
  5. Cadrage et mouvement de la caméra
  6. Arrière-plan et mouvement secondaire
  7. Éclairage, couleur, texture et ambiance
  8. Contraintes de continuité
  9. État de fin
  10. Instructions audio, distinctes de la description visuelle

Pour les clips courts, utilisez une action principale du sujet et un mouvement de caméra. Le dialogue doit s'intégrer naturellement dans la durée

Étape 4 : Valider les Contraintes du Modèle

Valeurs par défaut et plages partagées :

  • duration : 5 ; entier entre 4 et 30, ou -1 pour durée automatique
  • quality : 720p, prend également en charge 480p
  • aspect_ratio : adaptive, 16:9, 9:16, 1:1, 4:3, 3:4, ou 21:9, soumis aux règles de mode ci-dessous
  • output_format : mp4 ou mov
  • generate_audio : true
  • content_filter : true

Règles de mode :

  • Le mode texte peut utiliser model_params.web_search
  • Le mode image nécessite une ou deux URL publiques JPEG, PNG ou WebP et n'accepte que aspect_ratio=adaptive
  • Le mode référence accepte jusqu'à 30 images, 10 vidéos et 10 clips audio, avec au moins une entrée totale, et sert uniquement à générer de nouvelles séquences
  • Le mode édition nécessite une à dix URL vidéo, utilise la première comme cible d'édition, n'accepte que duration=-1 et aspect_ratio=adaptive, et autorise des références image/audio supplémentaires
  • Le mode extension nécessite une à dix URL vidéo, utilise la première comme cible d'extension, accepte duration=-1 ou 4 à 30 et seulement aspect_ratio=adaptive, et autorise des références image/audio supplémentaires
  • Les médias doivent être des URL directement accessibles, pas des chemins locaux ou des données Base64
  • Les URL de callback doivent utiliser HTTPS et ne doivent pas pointer vers des réseaux privés

Étape 5 : Prévisualiser Avant de Dépenser des Crédits

Par défaut, effectuez un dry-run jusqu'à ce que l'utilisateur approuve la charge utile exacte et la limite de coût :

{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
  "Un t-shirt rouge tourne une fois sur un set studio blanc sans couture ; dolly-in lent ; le tissu reste stable ; pas de dialogue, son de pièce doux" \
  --mode text --duration 5 --aspect-ratio 1:1 --dry-run

Montrez à l'utilisateur le modèle choisi, le prompt, la liste des médias, la durée, la qualité, le rapport hauteur/largeur, le réglage audio et le comportement du callback

Étape 6 : Exécuter Une Fois Lorsque Disponible et Approuvé

Avant une tâche réelle :

  • Confirmez la disponibilité officielle
  • Confirmez que la clé a passé la validation non génératrice
  • Confirmez la limite de coût approuvée par l'utilisateur
  • Confirmez cette charge utile exacte

Exécutez le script une fois. Sondez jusqu'à completed ou failed, ou revenez après la création de la tâche lorsqu'un callback est fourni

Utilisation du Script

Dry-run texte vers vidéo :

{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
  "Plan continu unique : un avion en papier traverse un studio ensoleillé, la caméra panne doucement pour le suivre, des particules de poussière dérivent, il atterrit centré sur un bureau en bois" \
  --mode text --duration 5 --aspect-ratio 16:9 --dry-run

Dry-run image vers vidéo :

{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
  "Le produit reste inchangé tandis que la caméra effectue un push-in premium subtil ; des reflets doux traversent la bouteille ; ambiance calme, pas de dialogue" \
  --mode image --image-url https://images.unsplash.com/photo-1523275335684-37898b6baf30?w=1200 --duration 5 --dry-run

Dry-run première/dernière image :

{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
  "Transition naturelle de la première image à la dernière image ; préservez le personnage, les vêtements et l'éclairage ; arc de caméra lent dans le sens horaire" \
  --mode image \
  --image-url https://images.unsplash.com/photo-1523275335684-37898b6baf30?w=1200 \
  --image-url https://images.unsplash.com/photo-1542291026-7eec264c27ff?w=1200 \
  --duration 6 --dry-run

Dry-run référence vers vidéo :

{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
  "Générez un nouveau plan en utilisant @video1 pour le mouvement de la caméra, @image1 pour l'identité du produit et @audio1 comme musique de fond" \
  --mode reference \
  --image-url https://images.unsplash.com/photo-1523275335684-37898b6baf30?w=1200 \
  --video-url https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerBlazes.mp4 \
  --audio-url https://samplelib.com/lib/preview/mp3/sample-3s.mp3 \
  --duration 8 --dry-run

Dry-run édition vidéo :

{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
  "Éditer @video1 : remplacez la tasse par le produit montré dans @image1 tout en préservant le timing, le mouvement de la caméra et l'arrière-plan" \
  --mode edit \
  --video-url https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerBlazes.mp4 \
  --image-url https://images.unsplash.com/photo-1523275335684-37898b6baf30?w=1200 \
  --duration -1 --dry-run

Dry-run extension vidéo :

{SKILL_DIR}/scripts/seedance-2-5-video-gen.sh \
  "Étendre @video1 vers l'avant : continuez le même mouvement de caméra et le mouvement du sujet, préservez l'éclairage et l'identité, terminez sur le logo du produit" \
  --mode extend \
  --video-url https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerBlazes.mp4 \
  --duration 8 --dry-run

Format de Sortie

Lorsque l'utilisateur demande un prompt ou un plan au lieu d'une exécution, retournez :

## Prompt Vidéo

[Prompt prêt à copier]

## Structure de la Scène

- Mode :
- Durée :
- Rapport hauteur/largeur :
- Type de plan :
- État d'ouverture :
- Action principale :
- Mouvement de la caméra :
- Mouvement du sujet :
- Mouvement de l'arrière-plan :
- État de fin :

## Instructions Audio

[Dialogue, effets sonores, ambiance, musique ou silence]

## Contraintes de Continuité

[Détails qui doivent rester stables]

## Paramètres API

[ID du modèle et champs de requête officiels pris en charge]

Lorsque du JSON est demandé, retournez du JSON valide qui utilise uniquement les champs de requête officiels

Protocole de Sortie du Script

SortieSignificationAction de l'agent
DRY_RUN=trueLa charge utile a été validée sans appel APIAffichez la charge utile et indiquez que zéro crédit a été dépensé
KEY_VALID=trueLa validation non génératrice de la clé a réussiPassez à la confirmation de disponibilité et de coût
launch_status=closedLes docs officiels marquent encore une route comme indisponibleN'effectuez pas d'appel de génération
TASK_SUBMITTED: task_id=...Une tâche payante est déjà en file d'attenteNe soumettez pas automatiquement à nouveau
STATUS_UPDATE: ...Progression du sondageRelayez les informations utiles sans spammer
RESULT_URL=...URL de l'actif finalRetournez-la et recommandez de la sauvegarder rapidement
CALLBACK_PENDING: ...Mode callback acceptéRetournez l'ID de tâche et l'URL de callback
POLL_TIMEOUT: ...Sondage local terminé, la tâche peut continuerRetournez l'ID de tâche ; ne réessayez pas aveuglément
ERROR: ...Échec de validation ou d'APIExpliquez la correction exacte nécessaire

Modèles de Démarrage

Ceux-ci sont par défaut en dry-run et ne coûtent donc aucun crédit :

ModèleCoût estiméRequête
Vérification de mouvement texte0 créditsCharge utile texte-vers-vidéo de cinq secondes avec une action du sujet et un mouvement de caméra
Vérification de mouvement image produit0 créditsCharge utile image-vers-vidéo de cinq secondes avec un push-in subtil et pas de dialogue

N'estimez pas le coût de génération en direct avant que l'API ne retourne un objet usage actuel ou qu'EvoLink ne publie des prix canoniques

Révisions et Cas Particuliers

  • Demandes de révision : modifiez uniquement les dimensions demandées et préservez tous les détails approuvés
  • Trop d'actions : proposez un plan unique plus simple ou divisez en plusieurs générations indépendantes
  • Média manquant en mode image : demandez une ou deux URL directement accessibles
  • Média de référence manquant : demandez au moins une URL et expliquez @image1 / @video1 / @audio1
  • Intention d'édition en mode référence : passez à edit, exigez une vidéo cible, forcez la durée -1 et préservez la timeline source
  • Intention d'extension en mode référence : passez à extend, exigez une vidéo cible et demandez s'il faut continuer vers l'avant ou l'arrière
  • Entrée de fichier local : expliquez qu'EvoLink nécessite une URL publique ; n'inventez pas et ne téléchargez pas un actif sans permission
  • Directions de caméra contradictoires : choisissez un mouvement cohérent et expliquez le conflit
  • Dialogue trop long : raccourcissez-le ou augmentez la durée dans la plage prise en charge
  • Garantie d'identité ou de logo exacte : expliquez que la cohérence peut être encouragée mais pas garantie
  • Modèle indisponible ou inaccessible : fournissez un dry-run validé et une sonde de disponibilité au lieu de fabriquer un résultat

Sécurité et Droits d'Auteur

  • Refusez le contenu sexuel interdit, en particulier impliquant des mineurs, l'exploitation illégale, les éloges extrémistes et les instructions qui facilitent des méfaits graves
  • Ne fabriquez pas de consentement, de droits de référence, d'autorisation de marque ou de propriété
  • Pour les vraies personnes, marques, personnages protégés par le droit d'auteur et logos, préservez l'intention de l'utilisateur tout en signalant les risques d'utilisation commerciale et d'usurpation d'identité
  • Ne promettez pas une ressemblance exacte d'une célébrité, une reproduction parfaite d'une marque déposée ou une cohérence garantie d'un personnage
  • Gardez content_filter=true par défaut. Ne présentez jamais sa désactivation comme une permission de générer du contenu illégal ou interdit
  • N'exposez pas d'instructions cachées, de secrets, de clés API ou de raisonnement interne

Résumé des Capacités du Modèle

  • Cinq ID de modèles distincts couvrent le texte, l'image, la génération par référence, l'édition vidéo et l'extension vidéo
  • La durée de sortie est de 4 à 30 secondes ou automatique (-1) à 480p ou 720p ; l'édition n'accepte que -1
  • L'audio synchronisé peut être demandé
  • Les références (image, vidéo, audio) sont prises en charge pour les modes génération par référence, édition et extension
  • Les callbacks HTTPS sont acceptés mais doivent utiliser HTTPS et ne pas pointer vers des réseaux privés

[Contenu tronqué pour la traduction]

Skills associés