APIMaster.ai

API de generación de videos Seedance 2.0

Genera videos con Seedance 2.0 a través de APIMaster.

Generación de videos con Seedance 2.0

Verificación del titular y recursos de retrato. Los cuatro modelos utilizan las mismas interfaces de APIMaster. El servidor adapta las rutas, identificadores y estados del proveedor. La verificación oficial del titular, la revisión de retratos del canal y los recursos normales o virtuales son procesos distintos. Utilice únicamente fotos expresamente autorizadas.

Seedance 2.0 admite generación de texto a video, imagen a video y medios de referencia mediante tareas asíncronas.

URL base: https://apimaster.ai/v1 es https://apimaster.ai/v1. No agregues otro /v1 a las rutas.

Límites de duración (verificados el 2026-10-06)

Para compatibilidad entre canales, indique explícitamente 4–15 segundos con Seedance 2.0. Algunas rutas no admiten duration: -1; la duración automática del proveedor no está disponible en todas las rutas. duration: 20 supera el límite; reintentar no lo resuelve.

Hasta 3 vídeos de referencia, cada uno de 2–15 segundos y un total máximo de 15 segundos; el audio de referencia tiene los mismos límites de duración y cantidad. Entrada y salida tienen límites separados. Los segundos facturables pueden incluir ambos, sin aumentar el límite de salida.

Compruebe los parámetros antes de enviar. HTTP 200 y task_id solo confirman la aceptación; un HTTP 400 / InvalidParameter posterior puede hacer fallar la tarea. Lea el error y corrija los parámetros antes de crear otra tarea. No repita la misma solicitud sin cambios. Las tareas fallidas reembolsan la reserva de generación.

Fuente de verificación: Seedance API.

Compatibilidad y validación

Se admiten POST https://apimaster.ai/v1/video/generations y POST https://apimaster.ai/v1/videos/generations. Para un mismo modelo, los parámetros y la facturación son iguales; cada ruta conserva su formato de respuesta de creación. Los clientes actuales pueden mantener su ruta.

En Seedance, ratio y aspect_ratio son alias; sin resolución se usa 720p. Los valores no admitidos o los alias contradictorios devuelven HTTP 400, sin cambiar silenciosamente a una resolución superior. Indique resolución, proporción y duración explícitamente.

Parámetros

Campo Tipo Obligatorio Descripción
model string sí seedance-2.0
prompt string sí Descripción del video
duration integer no duration es la duración del vídeo de salida en segundos: un entero de 4 a 15.
resolution string no 480p, 720p, 1080p o 4K
aspect_ratio string no 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 o adaptive
image_urls string[] no URLs públicas de imágenes de referencia
video_urls string[] no URLs públicas de videos de referencia
audio_urls string[] no URLs públicas de audio de referencia
generate_audio boolean no Generar audio
watermark boolean no Agregar marca de agua
seed integer no Semilla de reproducibilidad
output_format string no mp4

Enviar una tarea

curl -s "https://apimaster.ai/v1/videos/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "Sunlight through a forest, smooth forward camera movement",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": false
  }'

La respuesta contiene un task_id:

{"code":200,"data":[{"status":"submitted","task_id":"task_xxxxxxxx"}]}

Consultar y descargar

curl -s "https://apimaster.ai/v1/videos/task_xxxxxxxx" -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_xxxxxxxx/content" -H "Authorization: Bearer YOUR_API_KEY" -o output.mp4

Los estados incluyen submitted, in_progress, completed y failed. Descarga de inmediato después de que se complete.

Facturación

  • Sin vídeo de referencia: coste = segundos facturables del vídeo generado × tarifa efectiva de su resolución.
  • Con vídeo de referencia: coste = (suma de segundos facturables de los vídeos de referencia + segundos facturables generados) × tarifa del nivel con entrada de vídeo para esa resolución. No calcule solo la duración de salida ni use la tarifa sin entrada de vídeo.
  • Por ejemplo, una referencia de 4 segundos y una salida de 5 se estiman como 9 segundos facturables. Las imágenes y el audio de referencia no añaden segundos de vídeo.

Al enviar se reserva un importe que incluye la duración verificada de las referencias y la salida solicitada; la duración automática o el límite de reserva usan la estimación superior aplicable. Tras el éxito se liquida el trabajo facturable real del proveedor, con un cargo adicional o devolución de la diferencia. La reserva puede diferir del coste final. Las tareas fallidas devuelven la reserva de generación.

Consulte la ficha del modelo y Video/media pricing en la cartera. La resolución, el nivel de entrada y su tarifa de cuenta afectan al precio. El coste final es el importe neto de la reserva, cargos adicionales y devoluciones.

Errores

400 parámetros no válidos, 401 clave de API no válida, 402 saldo insuficiente, 429 límite de velocidad excedido y 500/502 errores temporales del servicio.

Ver también: Descripción general de generación de videos y Seedance 2.5.

Presupuestos y recibos de facturación de Seedance

Presupuestos y recibos de facturación de Seedance

Webhooks de tareas asíncronas

Webhooks de tareas asíncronas

Idempotencia de Seedance y recuperación de envíos