API de Seedance: haz tu primer video en tres llamadas

Inicia un trabajo de video con Seedance, consulta su estado y descarga el MP4 con HTTP simple. Un recorrido completo con curl y Python, y lo que cuesta cada paso.

3 min de lectura

seedancevideotutorial

Vista aérea de una ciudad alrededor de una torre alta, fotograma de un video de Seedance

Los modelos de video no responden en una sola solicitud como los modelos de chat. Un video tarda de uno a cinco minutos en hacerse, así que la API lo ejecuta como un trabajo: lo inicias, consultas su estado y descargas el archivo cuando termina. Este post recorre las tres llamadas con un modelo de Seedance, primero con curl y luego como un script corto de Python.

Necesitas una cuenta de API Store con algo de saldo y una clave de API de la página Claves de API. Las claves empiezan con sk-.

Paso 1: inicia el trabajo

Envía a POST /videos el modelo, un prompt y, si quieres, la duración, la resolución y la relación de aspecto:

bash
curl https://api.apistore.cloud/v1/videos \
  -H "Authorization: Bearer $APISTORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-mini",
    "prompt": "A paper boat drifts down a rain gutter, close-up, soft morning light",
    "seconds": 5,
    "resolution": "720p",
    "ratio": "16:9"
  }'

La respuesta llega de inmediato. Trae el id del trabajo y su estado:

json
{ "id": "video_8f2c...", "status": "queued", "model": "seedance-2.0-mini" }

Si omites los campos opcionales, obtienes 5 segundos en 720p y 16:9, con sonido. El sonido (voz, música y efectos) se genera junto con la imagen; envía "audio": false si no lo quieres.

Paso 2: consulta hasta que termine

Pide el trabajo cada pocos segundos:

bash
curl https://api.apistore.cloud/v1/videos/video_8f2c... \
  -H "Authorization: Bearer $APISTORE_API_KEY"

status pasa de queued a in_progress y termina como completed o failed. Un trabajo completado también trae usage.video_tokens y usage.cost_usd, así sabes exactamente cuánto costó. Un trabajo fallido trae error.code y error.message, y no se cobra.

Paso 3: descarga el archivo

Un trabajo completado tiene una url: un enlace al MP4 que funciona durante una semana y se renueva cada vez que lees el trabajo. También puedes descargar el archivo siempre a través de la API:

bash
curl -L https://api.apistore.cloud/v1/videos/video_8f2c.../content \
  -H "Authorization: Bearer $APISTORE_API_KEY" -o boat.mp4

Lo mismo en Python

No hace falta un SDK: basta con el paquete requests.

python
import os, time, requests

BASE = "https://api.apistore.cloud/v1"
HEAD = {"Authorization": f"Bearer {os.environ['APISTORE_API_KEY']}"}

job = requests.post(f"{BASE}/videos", headers=HEAD, json={
    "model": "seedance-2.0-mini",
    "prompt": "A paper boat drifts down a rain gutter, close-up, soft morning light",
    "seconds": 5,
    "resolution": "720p",
}).json()

while job["status"] not in ("completed", "failed"):
    time.sleep(5)
    job = requests.get(f"{BASE}/videos/{job['id']}", headers=HEAD).json()

if job["status"] == "failed":
    raise SystemExit(f"{job['error']['code']}: {job['error']['message']}")

video = requests.get(f"{BASE}/videos/{job['id']}/content", headers=HEAD)
open("boat.mp4", "wb").write(video.content)
print("cost", job["usage"]["cost_usd"], "USD")

Cuánto cuesta

El video se cobra según el video que el modelo realmente generó. El precio depende del modelo y de la resolución, y el sitio lo muestra por segundo de salida. Seedance 2.0 mini en 480p, la combinación más barata hoy, cuesta USD 0.0202 por segundo, y USD 0.0454 por segundo en 720p.

Cuando el trabajo empieza, se reserva de tu saldo el costo del resultado más largo que podría producir. Cuando termina, pagas lo que se generó y el resto se libera. Si el trabajo falla, no se cobra nada. Cómo se cobra el video explica los números en detalle.

Con qué modelo empezar

  • Seedance 2.0 mini para pruebas y borradores: el precio más bajo, 480p y 720p.
  • Seedance 2.0 fast cuando quieres mejor calidad a un precio moderado.
  • Seedance 2.0 para la mejor imagen de la familia 2.0, hasta 1080p y 4K.
  • Seedance 2.5 para videos largos de hasta 30 segundos, muchos archivos de referencia y para editar o extender un video.

Los cuatro aceptan la misma solicitud, así que puedes cambiar de modelo cambiando una palabra. Qué modelo de Seedance elegir los compara lado a lado.

Próximos pasos

  • Dale al modelo un primer fotograma o imágenes de referencia: consulta la documentación de video.
  • Prueba un prompt en el playground antes de escribir código.
  • Revisa la lista de precios de cada modelo y resolución.

También en English, Tiếng Việt, Português