Seedance 2.5 texte-vers-vidéo : créer des clips courts avec l'API hiapi

La vidéo courte est un jeu de volume : TikTok, Reels et Shorts récompensent la fréquence de publication, et filmer manuellement des B-roll pour chaque post ne passe pas à l'échelle. Le point d'accès texte-vers-vidéo de Seedance 2.5 transforme un seul prompt en un clip vertical fini, avec audio synchronisé, en un seul appel d'API — sans caméra, sans timeline de montage, sans voix off séparée.

Ce guide parcourt de bout en bout un clip réel que nous avons généré via l'API hiapi : le prompt exact, le workflow asynchrone qui l'a produit, la tarification vérifiée, et un patron directement réutilisable pour la production en série afin de produire une série de clips courts plutôt que des clips isolés. Pour la référence complète des paramètres des trois points d'accès seedance-2.5, consultez le guide API complet.

Pourquoi le contenu vidéo court se prête bien au texte-vers-vidéo

Les plateformes de vidéos courtes n'ont pas besoin d'une durée de niveau cinéma — elles ont besoin d'un approvisionnement régulier de clips de 6 à 15 secondes qui bouclent proprement et accrochent le spectateur en une seconde. seedance-2.5/text-to-video correspond exactement à ce besoin :

• Jusqu'à 30 secondes par clip, avec sept ratios d'image, dont le 9:16 pour TikTok/Reels/Shorts.
• Synchronisation audio native — le modèle génère les sons d'ambiance et les indices audio à partir des actions du prompt, au lieu de produire un clip muet que vous devrez doubler ensuite.
• Prompts pris en charge en 11 langues, utile si vous localisez des campagnes de vidéos courtes.
• Deux paliers de résolution (480p et 720p), pour générer des brouillons à moindre coût et ne payer le tarif 720p que pour les clips réellement publiés.

Un clip réel, de bout en bout

Voici un clip que nous avons généré pour ce guide : un gros plan sur un latte art versé, cadré verticalement, pour une vidéo courte de café.

Le prompt exact que nous avons soumis, sans retouche :

La main sûre d'un barista verse du lait vapeur d'une carafe en acier inoxydable dans une tasse à espresso en céramique blanche, le flux de lait se repliant en un tourbillon de rosetta qui se forme en temps réel, une lumière dorée de fin de journée balayant obliquement le comptoir, croissants et pâtisseries légèrement flous en arrière-plan, composition verticale en gros plan, vapeur légère, sons d'ambiance de café.

Paramètres : aspect_ratio: "9:16", resolution: "720p", duration: 8. La sortie ci-dessus est le résultat réel et non retouché de la tâche — 8,06 secondes, avec le bruit du versement et le bourdonnement d'ambiance du café générés directement par le modèle, et non ajoutés en post-production.

Le workflow API

seedance-2.5/text-to-video fonctionne via l'API de tâches asynchrones de hiapi — soumettre, interroger, télécharger. Il n'y a pas de point d'accès vidéo synchrone ; chaque clip est une tâche en arrière-plan.

import time
import requests

API_KEY = "YOUR_HIAPI_KEY"
BASE = "https://api.hiapi.ai/v1"

def generate_clip(prompt: str, aspect_ratio: str = "9:16",
                   resolution: str = "720p", duration: int = 8) -> str:
    submit = requests.post(
        f"{BASE}/tasks",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "model": "seedance-2.5/text-to-video",
            "input": {
                "prompt": prompt,
                "aspect_ratio": aspect_ratio,
                "resolution": resolution,
                "duration": duration,
            },
        },
        timeout=30,
    )
    task_id = submit.json()["data"]["taskId"]

    while True:
        poll = requests.get(
            f"{BASE}/tasks/{task_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
            timeout=30,
        ).json()["data"]
        if poll["status"] == "success":
            return poll["output"][0]["url"]   # 临时链接——立即下载
        if poll["status"] == "fail":
            raise RuntimeError(poll)
        time.sleep(5)

clip_url = generate_clip(
    "La main sûre d'un barista verse du lait vapeur d'une carafe en acier inoxydable "
    "dans une tasse à espresso en céramique blanche, le flux de lait se repliant en "
    "un tourbillon de rosetta qui se forme en temps réel, une lumière dorée de fin "
    "de journée balayant obliquement le comptoir, croissants et pâtisseries "
    "légèrement flous en arrière-plan, composition verticale en gros plan, "
    "vapeur légère, sons d'ambiance de café."
)

# L'URL de sortie expire (horodatage expireAt) — téléchargez immédiatement et
# persistez dans votre propre stockage, ne la conservez pas comme lien direct
video_bytes = requests.get(clip_url, timeout=60).content
open("clip.mp4", "wb").write(video_bytes)

La réponse de la tâche ne renvoie jamais votre prompt d'origine — seulement model, status, output et des horodatages — donc si vous devez reproduire ou faire varier un clip plus tard, consignez vous-même ce que vous avez soumis.

Tarification : deux paliers, pas de 1080p

Vérifié en temps réel sur le point d'accès tarifaire de hiapi — seedance-2.5/text-to-video est facturé à la seconde de sortie, avec deux paliers de résolution, sans option 1080p :

Résolution	Prix par seconde	Clip de 8 s
480p	$0.1395	environ $1.12
720p	$0.3019	environ $2.42

Le prix par seconde en 720p est environ 2,2 fois celui du 480p — il vaut la peine de générer d'abord des brouillons en 480p, puis de ne payer le 720p qu'une fois le prompt peaufiné. Les détails complets des paramètres et de la tarification se trouvent sur la page du modèle seedance-2.5/text-to-video ; les tarifs sont valables à la date de 2026-08 et peuvent changer, donc consultez cette page avant de budgétiser de gros volumes.

Produire une série de clips courts, pas un seul

Un clip unique n'est qu'une démonstration ; un calendrier éditorial exige de la production en série. Traitez chaque clip comme une tâche idempotente indexée par le prompt, afin qu'une relance après un plantage ne facture pas deux fois :

import hashlib

PROMPTS = [
    "Un barista verse du lait vapeur dans une tasse à espresso, une rosetta se forme, lumière dorée de fin de journée, composition verticale en gros plan.",
    "Vapeur s'élevant d'un café filtre fraîchement préparé qui s'écoule à travers le filtre, lumière du matin à travers la vitrine du café, composition verticale.",
    "Une main tapote un sachet de grains de café sur une balance en bois, les grains se stabilisent, atmosphère douce de café, composition verticale en gros plan.",
]

def job_key(prompt: str) -> str:
    return hashlib.sha1(prompt.encode()).hexdigest()[:12]

results = {}
for prompt in PROMPTS:
    key = job_key(prompt)
    if key in results:          # 本轮已生成过
        continue
    results[key] = generate_clip(prompt, resolution="480p", duration=6)
    # 立即持久化每个结果——参见上面的下载步骤

Générez d'abord toute la série en 480p, évaluez quels clips conviennent réellement à la campagne, puis relancez uniquement les clips retenus en 720p. Lorsque vous devez produire en série plutôt que faire une création ponctuelle, cette habitude en deux passes est le plus grand levier sur les coûts.

Comparaison avec Seedance 2.0

Si vous avez utilisé Seedance 2.0, le niveau texte-vers-vidéo de la 2.5 conserve la même forme de tâche soumettre-interroger-télécharger — aucun changement côté intégration. Différences concrètes à connaître avant de migrer un pipeline : la 2.5 ajoute par défaut une synchronisation audio native à chaque clip, et son échelle de résolution est plus simple (uniquement 480p/720p, alors que la 2.0 a des paliers supplémentaires). Si votre workflow dépend d'une résolution que la 2.5 ne propose pas, consultez la page du modèle pour connaître ses spécifications actuelles avant de supposer une équivalence.

Questions fréquentes

seedance-2.5/text-to-video prend-il en charge le 1080p ? Non — à la date de 2026-08, le modèle propose uniquement 480p et 720p. Si vous avez besoin d'une sortie 1080p, cherchez dans le catalogue de modèles un modèle qui le prend en charge avant de construire un pipeline autour de ce point d'accès.

L'audio est-il réel, ou faut-il l'ajouter séparément ? Il est généré par le modèle dans le cadre de la tâche — le bruit du versement et le bourdonnement d'ambiance du café dans le clip de démonstration ci-dessus n'ont pas été ajoutés en post-production. Si vous avez besoin d'une musique de marque ou d'une voix off spécifique, vous pouvez toujours superposer votre propre audio par la suite.

Combien de temps prend la génération d'un clip ? Le temps d'achèvement d'une tâche varie selon la durée et la résolution ; comptez globalement de une à quelques minutes par clip, et interrogez toujours la tâche plutôt que de supposer un délai d'attente fixe.

Puis-je réutiliser le même prompt sur différents ratios d'image pour plusieurs plateformes ? Oui — aspect_ratio est un paramètre distinct du prompt, donc le même prompt peut être soumis à nouveau en 9:16 pour TikTok/Reels et en 16:9 pour YouTube, sans réécrire la description de scène.

Que faire si l'URL de sortie expire avant que je ne la télécharge ? Vous devez soumettre à nouveau la tâche — output[0].url est un lien temporaire lié à un horodatage expireAt, et non un stockage permanent. Téléchargez et persistez chaque clip immédiatement après que la tâche a rapporté success.

À retenir

• seedance-2.5/text-to-video est un point d'accès prompt en entrée, clip en sortie pour le contenu vidéo court — choisissez 480p pour les brouillons et le contenu de remplissage social, et 720p lorsque le clip est l'actif final.
• Budgétisez à la durée plutôt qu'au clip : le coût par seconde en 720p est environ 2,2 fois celui du 480p, donc un clip 720p de 8 secondes coûte déjà environ $2.42.
• Les URL de sortie des tâches expirent — téléchargez et persistez dans un stockage permanent immédiatement après une interrogation réussie.
• La synchronisation audio native signifie que le contenu de remplissage vidéo court n'a généralement pas besoin de voix off ni de traitement d'effets sonores séparés.
• Le modèle n'a actuellement pas de palier 1080p — consultez la page du modèle avant de construire un pipeline qui suppose son existence.

Prêt à essayer ? Rendez-vous sur la page du modèle seedance-2.5/text-to-video pour la référence complète des paramètres, ou parcourez le catalogue complet de modèles vidéo de hiapi pour le comparer à des options image-vers-vidéo comme Kling 3.0 Turbo, afin de préparer votre prochain lot de vidéos courtes.