Seedance 2.5 texto a video: crea clips de formato corto con la API de hiapi

El video de formato corto es un juego de volumen: TikTok, Reels y Shorts recompensan la frecuencia de publicación, y grabar material B-roll a mano para cada publicación no escala.El endpoint de texto a video de Seedance 2.5 convierte un solo prompt en un clip vertical terminado, con audio sincronizado, en una única llamada a la API: sin cámara, sin línea de tiempo de edición, sin grabación de voz por separado.

Esta guía recorre de principio a fin un clip real que generamos a través de la API de hiapi: el prompt exacto, el flujo de trabajo asíncrono que lo produjo, los precios verificados y un patrón listo para producción en lote que sirve para crear un conjunto de videos cortos en lugar de clips sueltos. Para la referencia completa de parámetros de los tres endpoints de seedance-2.5, consulta la guía completa de la API.

Por qué el contenido de formato corto encaja con el texto a video

Las plataformas de formato corto no necesitan duración de nivel cinematográfico: necesitan un suministro constante de clips de 6 a 15 segundos que se reproduzcan en bucle sin cortes y atrapen al espectador en un segundo. seedance-2.5/text-to-video encaja exactamente con esa necesidad:

• Hasta 30 segundos por clip, con siete relaciones de aspecto, incluida 9:16 para TikTok/Reels/Shorts.
• Sincronización de audio nativa: el modelo genera ambiente y pistas de audio según la acción del prompt, en lugar de producir un clip mudo que luego tengas que doblar.
• Prompts en 11 idiomas, útil si estás localizando campañas de formato corto.
• Dos niveles de resolución (480p y 720p), para que puedas generar borradores a bajo coste y pagar la tarifa de 720p solo por los clips que realmente vas a publicar.

Un clip real, de principio a fin

Este es un clip que generamos para esta guía: un primer plano de un latte art siendo vertido, con encuadre vertical, para un video corto de cafetería.

El prompt exacto que enviamos, sin editar:

La mano firme del barista vierte leche vaporizada de una jarra de acero inoxidable en una taza de espresso de cerámica blanca, el chorro de leche se pliega en un remolino de roseta que se forma en tiempo real, luz cálida de hora dorada barriendo lateralmente la barra, croissants y bollería suavemente desenfocados al fondo, composición vertical en primer plano, vapor suave, sonido ambiente de cafetería.

Parámetros: aspect_ratio: "9:16", resolution: "720p", duration: 8. La salida de arriba es el resultado real de la tarea, sin editar: 8,06 segundos, con el sonido del vertido y el murmullo ambiental de la cafetería generados directamente por el modelo, no añadidos en posproducción.

Flujo de trabajo de la API

seedance-2.5/text-to-video funciona a través de la API de tareas asíncronas de hiapi: enviar, sondear, descargar. No hay endpoint de video síncrono; cada clip es una tarea en segundo plano.

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"]   # enlace temporal: descárgalo de inmediato
        if poll["status"] == "fail":
            raise RuntimeError(poll)
        time.sleep(5)

clip_url = generate_clip(
    "La mano firme del barista vierte leche vaporizada de una jarra de acero inoxidable "
    "en una taza de espresso de cerámica blanca, el chorro de leche se pliega en un remolino "
    "de roseta que se forma en tiempo real, luz cálida de hora dorada "
    "barriendo lateralmente la barra, croissants y bollería suavemente desenfocados al fondo, "
    "composición vertical en primer plano, vapor suave, sonido ambiente de cafetería."
)

# La URL de salida caduca (lleva una marca de tiempo expireAt): descárgala de inmediato y
# guárdala en tu propio almacenamiento; no la conserves como enlace directo
video_bytes = requests.get(clip_url, timeout=60).content
open("clip.mp4", "wb").write(video_bytes)

La respuesta de la tarea nunca devuelve tu prompt original: solo devuelve model, status, output y marcas de tiempo, así que si más adelante necesitas reproducir o variar un clip, registra tú mismo lo que enviaste.

Precios: dos niveles, sin 1080p

Verificado en tiempo real con el endpoint de precios de hiapi: seedance-2.5/text-to-video se factura por segundos de salida, con dos niveles de resolución y sin opción de 1080p:

Resolución	Precio por segundo	Clip de 8 segundos
480p	$0.1395	unos $1.12
720p	$0.3019	unos $2.42

El precio por segundo de 720p es aproximadamente 2,2 veces el de 480p: merece la pena generar borradores en 480p y pagar 720p solo cuando el prompt esté pulido. Los detalles completos de parámetros y precios están en la página del modelo seedance-2.5/text-to-video; las tarifas están vigentes a fecha de 2026-08 y pueden cambiar, así que consulta esa página antes de presupuestar un lote grande.

Producir un conjunto de videos cortos, no solo uno

Un solo clip es solo una demostración; un calendario de contenido necesita producción en lote. Trata cada clip como una tarea idempotente con el prompt como clave, para que volver a ejecutar tras un fallo no duplique el cobro:

import hashlib

PROMPTS = [
    "Un barista vierte leche vaporizada en una taza de espresso, se forma una roseta de latte art, luz de hora dorada, composición vertical en primer plano.",
    "Vapor que se eleva de un café de filtro recién hecho mientras gotea por el filtro de papel, luz de la mañana a través de la ventana de la cafetería, composición vertical.",
    "Una mano golpea suavemente una bolsa de granos de café sobre una báscula de madera, los granos se asientan, ambiente suave de cafetería, composición vertical en primer plano.",
]

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:          # ya generado en esta ronda
        continue
    results[key] = generate_clip(prompt, resolution="480p", duration=6)
    # guarda de inmediato cada resultado: consulta el paso de descarga de arriba

Genera todo el conjunto primero en 480p, evalúa qué clips encajan realmente en la campaña y luego vuelve a ejecutar solo los ganadores en 720p. Cuando necesitas producción en lote en lugar de piezas puntuales, este hábito de dos rondas es la mayor palanca de coste.

Comparación con Seedance 2.0

Si has usado Seedance 2.0, el nivel de texto a video de 2.5 mantiene la misma forma de tarea de enviar-sondear-descargar: no hay cambios en la integración. Diferencias prácticas que conviene conocer antes de migrar la línea de producción: 2.5 añade por defecto audio sincronizado nativo a cada clip, y su escalera de resolución es más simple (solo 480p/720p, mientras que 2.0 tiene niveles adicionales). Si tu flujo de trabajo depende de una resolución que 2.5 no ofrece, consulta la página del propio modelo para conocer las especificaciones actuales antes de asumir equivalencia.

Preguntas frecuentes

¿seedance-2.5/text-to-video admite 1080p? No: a fecha de 2026-08, el modelo solo ofrece 480p y 720p. Si necesitas salida en 1080p, busca en el catálogo de modelos un modelo que lo admita antes de construir una línea de producción en torno a este endpoint.

¿El audio es real o hay que añadirlo por separado? Lo genera el modelo como parte de la tarea: el sonido del vertido y el murmullo ambiental de la cafetería del clip de demostración de arriba no se añadieron en posproducción. Si necesitas música de marca o voz en off específicas, siempre puedes superponer tu propio audio después.

¿Cuánto tarda en generarse un clip? El tiempo de finalización de la tarea varía según la duración y la resolución; aproximadamente entre uno y varios minutos por clip, y conviene sondear en lugar de asumir un tiempo de espera fijo.

¿Puedo reutilizar el mismo prompt en distintas relaciones de aspecto para diferentes plataformas? Sí: aspect_ratio es un parámetro independiente del prompt, así que el mismo prompt puede reenviarse en 9:16 para TikTok/Reels y en 16:9 para YouTube sin reescribir la descripción de la escena.

¿Qué pasa si la URL de salida caduca antes de que la descargue? Tendrás que reenviar la tarea: output[0].url es un enlace temporal vinculado a una marca de tiempo expireAt, no almacenamiento permanente. Descarga y guarda cada clip en cuanto la tarea indique success.

Puntos clave

• seedance-2.5/text-to-video es un endpoint de entrada de prompt y salida de clip para contenido de formato corto: 480p para borradores y relleno de redes sociales, 720p cuando el clip es el activo final.
• Presupuesta por duración, no por clip: el coste por segundo de 720p es aproximadamente 2,2 veces el de 480p, así que un clip de 8 segundos en 720p ya cuesta unos $2.42.
• Las URL de salida de las tareas caducan: descarga y guarda en almacenamiento permanente en cuanto el sondeo tenga éxito.
• La sincronización de audio nativa significa que el relleno de formato corto normalmente no necesita doblaje ni efectos de sonido por separado.
• El modelo no tiene actualmente nivel 1080p: consulta la página del modelo antes de construir una línea de producción que asuma que lo tiene.

¿Listo para probarlo? Visita la página del modelo seedance-2.5/text-to-video para ver la referencia completa de parámetros, o explora el catálogo completo de modelos de video de hiapi para compararlo con opciones de imagen a video como Kling 3.0 Turbo y preparar tu próximo lote de videos cortos.