Generación de video

HopBase ofrece dos APIs de video. Gemini Omni devuelve de forma síncrona un MP4 en base64 de 3-10 segundos, 720p, 24 FPS a través de POST /v1beta/interactions. Seedance 2.0 y 2.5 usan la API de tareas asíncronas descrita abajo y admiten resoluciones, duraciones y opciones de medios de referencia específicas de cada modelo. Use la clave del grupo del plan correspondiente y consulte primero GET /v1/models.

API de tareas asíncronas de Seedance 2.5 y 2.0

Variantes de China y de fuera de China

Los clientes existentes que pasen de fuera de China a China solo necesitan reemplazar la clave del grupo. La base_url, las rutas de la API, los parámetros de solicitud y la lógica de polling permanecen sin cambios. Use GET /v1/models con la nueva clave para seleccionar un ID de modelo completo disponible.

Seedance 2.5 está disponible en el grupo de fuera de China. Use el ID de modelo dreamina-seedance-2-5-260628. Para la generación ordinaria de texto a video y con medios de referencia, duration tiene por defecto -1 y acepta valores enteros de 4 a 30 segundos o -1; resolution tiene por defecto 720p y acepta 480p o 720p; y ratio acepta 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 o adaptive. Algunos modos de tarea tienen requisitos más estrictos: la edición de video usa duration: -1 y ratio: adaptive, mientras que los modos de extensión y primer/último fotograma requieren ratio: adaptive. Los valores predeterminados son audio generado, sin marca de agua y return_last_frame: true. Una tarea completada con return_last_frame: true incluye last_frame_url.

1. Enviar una tarea de generación

curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer sk-tu-clave" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-260628",
    "content": [
      { "type": "text", "text": "Un gato naranja corre por el pasto iluminado por el sol mientras la cámara lo sigue" }
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": false,
    "watermark": false
  }'

La respuesta contiene un task.id como vt... para consultas de estado posteriores. Para imagen a video, agregue este objeto a content:

{
  "type": "image_url",
  "image_url": { "url": "https://example.com/reference.jpg" },
  "role": "reference_image"
}

Otros parámetros de modelo admitidos se transmiten sin cambios.

2. Consultar el estado de la tarea

# Una sola tarea; se recomienda consultar cada 5 segundos
curl https://api.hop-base.com/v1/video/tasks/vt-tu-task-id \
  -H "Authorization: Bearer sk-tu-clave"

# Lista de tareas; opcionalmente agregue ?page=1&limit=20
curl https://api.hop-base.com/v1/video/tasks \
  -H "Authorization: Bearer sk-tu-clave"

status es pending, processing, completed o failed. Al completarse, lea la URL del video desde outputs. usage.completion_tokens contiene el conteo de tokens facturables. La generación en 480p y 720p suele tardar de 2 a 5 minutos; 1080p y 4K, disponible solo fuera de China, tardan más.

3. Subir medios de referencia de Seedance 2.0

curl https://api.hop-base.com/v1/sd/assets \
  -H "Authorization: Bearer sk-tu-clave" \
  -H "Content-Type: application/json" \
  -d '{
    "URL": "https://example.com/your-image.jpg",
    "Name": "character_front",
    "AssetType": "Image"
  }'

El data.Id devuelto es el ID del recurso. Referéncielo como asset://asset-id durante la generación de Seedance 2.0. URL debe ser accesible públicamente. Use AssetType: Image, Video o Audio según el elemento de referencia, y luego consulte el recurso con GET /v1/sd/assets/{asset-id} hasta que esté listo. Este flujo de subida aplica a Seedance 2.0. Los medios de referencia de Seedance 2.5 deben usar URLs HTTP(S) públicas directamente en content. La subida en sí solo acepta una URL pública — sin base64 ni multipart — así que hospede el archivo en algún lugar accesible primero. La subida es opcional para imágenes de referencia ordinarias y obligatoria para cualquier imagen que contenga una persona real.

Reglas de validación de medios de referencia

Todos los medios de referencia se validan de forma síncrona en el envío. Un medio inválido devuelve de inmediato un 400 con un código de error específico (como invalid_image_aspect_ratio) y no genera costo de tarea. Verificar previamente contra la siguiente tabla de su lado elimina la mayoría de las llamadas desperdiciadas:

URL del medio debe ser una dirección http(s) accesible públicamente: las direcciones privadas / loopback / link-local y las URLs con credenciales se rechazan, con como máximo 3 redirecciones; las imágenes y el audio también pueden pasarse en línea como base64 data:. Restricciones de rol: el modo de fotograma toma como máximo 2 imágenes — una sola imagen debe ser first_frame, dos imágenes deben ser exactamente un first_frame y un last_frame; las referencias multimodales deben declararse explícitamente como reference_image y no pueden mezclarse con el modo de fotograma.

Modelos de fuera de China y precios estándar actuales

Los precios están en USD por millón de tokens de video. El bucket de precio más bajo aplica solo cuando la solicitud contiene un video de referencia; una referencia de imagen o audio por sí sola permanece en el bucket sin entrada de video. Para la variante de China, use la Plaza de modelos tras iniciar sesión del grupo de China y el cargo real de la tarea como fuente de verdad.

La tabla lista los precios actuales. Los tokens facturables crecen con la resolución y la duración, aproximadamente píxeles x frecuencia de fotogramas x duración / 1024. El precio más bajo por token en 4k se compensa con un conteo de tokens mucho mayor. Un video Mini de 480p y 5 segundos es de aproximadamente 48,400 tokens o $0.15. La Plaza de modelos tras iniciar sesión y el consumo real de la tarea son la fuente autorizada.