¿Cómo usar la API de Seedance 2.0? Consigue tu primer video en 5 minutos

TL;DR

• Seedance 2.0 es el modelo de generación de video de ByteDance; en HiAPI se divide en tres niveles: Mini, Fast y estándar. Abre la página del modelo para generar en línea; los nuevos usuarios registrados reciben 200 créditos.
• Facturación por segundo: Mini 720p $0.0586 por segundo, versión estándar 720p $0.293 por segundo, 1080p mediante la ruta ext $0.342 por segundo; el audio no tiene costo adicional.
• La API solo tiene dos pasos: POST /v1/tasks para enviar y obtener el taskId para consultar el resultado. Los ejemplos en curl y Python de abajo se pueden copiar y ejecutar directamente.

¿Qué puede hacer Seedance 2.0?

• Texto a video: de 4 a 15 segundos, de 480p a 4K, seis relaciones de aspecto: 16:9, 9:16, 1:1, 4:3, 3:4 y 21:9; en la generación de video a partir de imágenes también se puede usar adaptive para seguir la imagen original.
• Imagen a video: envía el primer fotograma (first_frame_url) y, opcionalmente, añade el último fotograma (last_frame_url) para controlar la imagen final.
• Referencia multimodal: hasta 9 imágenes de referencia, 3 videos de referencia y 3 audios de referencia, para fijar personajes, movimientos de cámara o ritmo.
• Audio nativo: generate_audio está activado por defecto; el sonido ambiente y los efectos de sonido se generan sincronizados con la imagen.

Este plano de producto de 5 segundos en 720p se generó directamente con un solo prompt:

A slow cinematic dolly-in on a sleek matte-black smartwatch resting on a
brushed-concrete pedestal, soft diffused studio light, the screen wakes to
show a glowing minimalist watch face, faint reflections move across the metal
bezel, premium tech commercial look, calm and clean.

Generar con este prompt →

Dos formas de empezar

Prueba en línea (sin escribir código)

1. Abre la página del modelo Seedance 2.0 y regístrate o inicia sesión.
2. Pega el prompt y elige la duración, la resolución y la relación de aspecto.
3. Haz clic en generar y descarga el video cuando esté listo (los tres videos de muestra de latte de 5 segundos en 720p de la página de precios tardaron entre 168 y 230 segundos desde el envío hasta la finalización).

Llamada a la API

1. Crea una API Key en la consola.
2. POST https://api.hiapi.ai/v1/tasks para enviar la tarea; devuelve taskId.
3. GET /v1/tasks/{taskId} para consultar el estado; cuando status sea success, descarga el video desde output[0].url.

curl: el primer video

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "input": {
      "prompt": "A slow cinematic dolly-in on a sleek matte-black smartwatch resting on a brushed-concrete pedestal, soft diffused studio light.",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }'

Respuesta:

{"code": 200, "data": {"taskId": "tk-hiapi-..."}, "message": "success"}

Consultar el resultado:

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

Python: enviar, consultar y descargar

# pip install requests; primero export HIAPI_KEY=tu Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(prompt, model="seedance-2.0", timeout_s=900, **params):
    body = {"model": model, "input": {"prompt": prompt, **params}}
    # Al reintentar el envío de la misma tarea, usa el mismo Idempotency-Key para evitar cargos duplicados
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

url = generate(
    "A barista pours steamed milk into a latte, camera slowly pulls back",
    model="seedance-2.0-mini", duration=5, resolution="480p", aspect_ratio="9:16",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Al ajustar el prompt, cambia model a seedance-2.0-mini y usa la resolución 480p; 5 segundos cuestan solo $0.136; cuando el resultado esté finalizado, cambia a la versión estándar o a la ruta ext para obtener alta definición.

Imagen a video y referencia multimodal

Imagen a video con primer fotograma: añade first_frame_url dentro de input; si escribes adaptive en la relación de aspecto, se seguirá la proporción de la imagen:

{
  "model": "seedance-2.0",
  "input": {
    "prompt": "Slow cinematic push-in on the product with a soft light sweep, keep the product still and centered",
    "first_frame_url": "https://your-cdn.example.com/product.jpg",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "resolution": "720p"
  }
}

Imágenes, videos y audios de referencia: usa respectivamente reference_image_urls (imágenes de referencia más el primer y último fotograma, máximo 9 en total), reference_video_urls (máximo 3, con una duración total no superior a 15 segundos) y reference_audio_urls (máximo 3, con una duración total no superior a 15 segundos).

Combinación de entradas de Mini: en Mini, elige una de las tres opciones entre primer fotograma, imagen de referencia o video de referencia; duration y resolution son obligatorios; en la versión estándar, aspect_ratio es obligatorio.

Ruta ext: añade "route": "ext" en el nivel superior; el nombre del modelo no cambia. ext solo admite 720p, 1080p y 4K, es más económico por segundo, pero no acepta videos de referencia.

Consideraciones antes de salir a producción

• Usa callbacks en lugar de sondeo: añade "callback": {"url": "https://tu-dominio/hiapi/callback"} en el nivel superior de la solicitud; cuando la tarea termine (con éxito o con error), HiAPI notificará activamente; deduplica por taskId.
• Los videos se conservan por defecto unos 7 días: después de obtener output[0].url, guárdalo en tu propio almacenamiento; si necesitas conservarlo a largo plazo, puedes usar el almacenamiento persistente de HiAPI (se factura aparte según el volumen de almacenamiento).
• Escribe todos los parámetros: incluye explícitamente duration, resolution y aspect_ratio para que el costo coincida con tu tabla de presupuesto.
• Reembolso automático en caso de fallo: las tareas fallidas no se cobran; solo se factura por los segundos generados con éxito.

Preguntas frecuentes

¿Cómo elegir entre Mini, Fast y la versión estándar?

Usa Mini para ajustar prompts, Mini o Fast 720p para videos cortos de redes sociales, y la versión estándar o la ruta ext si necesitas 1080p / 4K. Consulta los precios detallados en Precios de la API de Seedance 2.0.

¿Se pueden escribir prompts en chino?

Sí. Se admiten tanto chino como inglés; para obtener resultados más estables, describe con claridad en frases separadas la cámara, la acción, la iluminación y el sonido.

¿Se puede generar en vertical?

Sí. Escribe 9:16 en aspect_ratio; en la generación de imagen a video, escribe adaptive para seguir la proporción del primer fotograma.

¿Cuánto tarda un video?

Los tres videos de muestra de latte de 5 segundos en 720p de la página de precios tardaron entre 168 y 230 segundos desde el envío hasta la finalización. En producción, usa callbacks para recibir los resultados; no dependas de tiempos de espera fijos.

Copia el prompt del reloj de arriba y ve a la página del modelo para generar tu primer video; si quieres más prompts listos para usar, consulta Ejemplos de prompts de Seedance 2.0.