Ir al contenido
Zabio está en beta: los modelos, los precios y las funciones pueden cambiar. Cuéntanos qué falla en hello@zabio.ai.

Videos

Zabio hace videos con POST /v1/videos, con la forma que los SDK de OpenAI conocían para Sora. Un video tarda de uno a varios minutos en hacerse, así que la solicitud responde al instante con un id de video; lo descargas cuando está listo. Cambia base_url y tu key, y mantén lo demás.

Para la forma exacta de la solicitud y la respuesta, consulta la referencia de la API.

Envía un prompt, una duración y un tamaño. La key necesita el alcance chat (las keys lo tienen por defecto).

Terminal window
curl https://api.zabio.ai/v1/videos \
-H "Authorization: Bearer insert your zabio.ai key here" \
-H "Content-Type: application/json" \
-d '{"model": "auto", "prompt": "Un faro rojo sobre una costa rocosa al atardecer, olas suaves, paneo lento de cámara", "seconds": "5", "size": "1280x720"}'

La respuesta llega al instante, con estado 202:

{"id": "video_...", "object": "video", "status": "queued", "model": "auto", "seconds": "5", "size": "720p", "progress": 0, "created_at": 1793743200, "expires_at": 1796335200}

Después pídelo con GET /v1/videos/{id} cada pocos segundos. Mientras se hace, el estado es queued o in_progress, con progress de 0 a 100 cuando el modelo lo informa. Cuando está completed:

{
"id": "video_...", "object": "video", "status": "completed", "model": "auto", "seconds": "5", "size": "720p", "progress": 100,
"created_at": 1793743200, "completed_at": 1793743390, "expires_at": 1796335200,
"zabio": {"model_served": "grok-imagine-video-1.5-lite", "vendor": "xai", "cost_micros": 105000, "call_id": "call_...", "file_id": "file_...",
"url": "https://api.zabio.ai/v1/videos/content/file_...?exp=1793746990&sig=...", "url_expires_at": 1793746990}
}

Descarga el MP4 con tu key en GET /v1/videos/{id}/content, o con zabio.url, un enlace que funciona sin la key durante 60 minutos desde la solicitud que lo devolvió, así que puede ir directo en una etiqueta <video>. Quien tenga el enlace puede abrir el video hasta entonces: compártelo como compartirías el video. Pide el video de nuevo para obtener un enlace nuevo. El video también es un archivo: GET /v1/files/{file_id}/content lo devuelve.

Modelo Duraciones Resoluciones Parte de Sonido Precio por segundo
grok-imagine-video-1.5 (xAI) de 1 a 15 s 480p, 720p, 1080p un prompt, una imagen, un primer y un último cuadro sí, se puede quitar 0.08 USD, más 0.01 por imagen enviada
grok-imagine-video-1.5-lite (xAI) de 1 a 15 s 480p, 720p, 1080p (ampliado desde 720p) un prompt, una imagen sí, se puede quitar 0.02 USD, más 0.01 por imagen enviada
wan2.6-t2v (Alibaba) de 2 a 15 s 720p, 1080p un prompt siempre 0.10 USD a 720p, 0.15 a 1080p
wan2.6-i2v (Alibaba) de 2 a 15 s 720p, 1080p una imagen siempre 0.10 USD a 720p, 0.15 a 1080p
gemini-omni-1.1-flash (Google) de 3 a 10 s 360p, 720p, 1080p y 4k (las dos últimas ampliadas) un prompt, una imagen, un primer y un último cuadro siempre 17.50 USD por millón de tokens de video, unos 0.10 USD por segundo a 720p

Los precios son los de lista de los proveedores; la tarifa del plan se suma. GET /v1/models lista las duraciones de cada modelo de video (zabio.media.durations), sus resoluciones (zabio.media.sizes), sus entradas (zabio.media.inputs), su sonido (zabio.media.audio) y su precio (zabio.pricing.per_second, o per_second_by_resolution). Los modelos de xAI se hacen en el endpoint global de xAI, así que su lugar de procesamiento no está garantizado; los modelos de Alibaba se hacen en Estados Unidos (Virginia); el modelo de Google, en Estados Unidos.

gemini-omni-1.1-flash hace el video mientras Zabio espera del lado de Google, así que puede tardar más que los otros modelos en pasar a completed. Hace de 3 a 10 segundos, la duración que fija seconds como en los otros modelos (la API de Google no tiene un campo de duración, así que Zabio la pide en el prompt que envía, y el modelo la hace: 3 s pedidos fueron 3 s hechos cuando Zabio lo probó el 2026-11-05). Hace videos horizontales (16:9, por defecto) o verticales (9:16); un size cuadrado recibe horizontal. Se cobra según los tokens que informa Google: los tokens de video a 17.50 USD por millón, y la resolución cambia cuántos cuesta un segundo (unos 1,931 por segundo a 360p cuando Zabio lo probó, unos 0.034 USD por segundo; 5,792 a 720p según Google, unos 0.10 USD por segundo; sin tasa indicada para 1080p y 4k, que se amplían), el prompt y las imágenes a 1.50 USD por millón de tokens de entrada, y el razonamiento del modelo a 9.00 USD por millón.

Se aplican los límites que indica Google: Gemini Omni no hace videos que muestren ciertas personas reconocibles, a partir de un prompt o de una imagen, y una solicitud así falla con moderation_blocked y un mensaje que lo dice. Editar imágenes de menores, y editar o extender videos subidos, no está disponible en el Espacio Económico Europeo, Suiza y el Reino Unido; Zabio no toma videos subidos para generar, así que el segundo límite hoy no alcanza tus solicitudes.

model: auto (el valor por defecto) elige el modelo más barato que hace la duración y la resolución que pides, a partir de lo que envías (un prompt, una imagen, un último cuadro), con el sonido que pides, según los precios de los propios proveedores. El video aún no tiene un listón de calidad, así que todas las líneas de auto eligen el mismo modelo. Una duración o una resolución que ningún modelo hace es un 400 que nombra el límite de cada modelo.

Campo Qué hace
model un modelo de video, o auto
prompt lo que muestra el video, hasta 4,000 caracteres. Opcional cuando envías una imagen a un modelo que parte solo de una imagen
seconds la duración en segundos enteros, como texto ("5") o número. Por defecto: 8 segundos si el modelo hace 8, si no el más corto
size ANCHOxALTO, leído como su resolución (el lado menor: 480 es 480p, 720 es 720p, 1080 es 1080p) y su orientación (horizontal, vertical o cuadrada). El modelo hace sus propios píxeles a esa resolución, así que el size de la respuesta es la resolución
resolution en lugar de size: 480p, 720p, 1080p o 4k. Por defecto: la más baja del modelo
input_reference una imagen de la que partir (el primer cuadro): una URL de datos en base64 de un png, jpeg o webp, {"image_url": "data:..."}, {"file_id": "file_..."} de un archivo que subiste con propósito user_data, o un archivo en el formulario multipart que envían los SDK. Como mucho 20 MB. No se descargan direcciones web
zabio.audio false para un video sin sonido, en un modelo cuyo sonido se puede quitar
zabio.last_frame el último cuadro, en las formas de input_reference, en un modelo que toma dos imágenes
zabio.expires_after {"anchor": "created_at", "seconds": N}, N al menos 3600: borra el video antes que la retención de tu organización

Un video por solicitud. El objeto zabio es una extensión de Zabio; los SDK de OpenAI lo pasan con extra_body, y un formulario multipart lo lleva como un campo llamado zabio con el JSON. remix, las miniaturas y los webhooks no están disponibles: pide el estado del video en su lugar.

El video se hace del lado de Zabio. Zabio pide al proveedor del modelo que lo empiece, pregunta cómo va cada pocos segundos y, en cuanto está listo, lo descarga, lo guarda y lo cobra. Los proveedores guardan su copia como mucho un día; la copia de Zabio es la que descargas. Un video que no se puede hacer termina failed con un error que tiene un código y un mensaje. Un video que Zabio no pudo guardar después de que el proveedor lo hizo no cobra nada; uno que se cobró y luego se perdió tiene su cargo devuelto a tu saldo, y su error lo dice. Un video que aún no está listo seis horas después de empezar termina failed con generation_timeout y no cobra nada.

DELETE /v1/videos/{id} cancela un video que sigue en cola, y no se cobra nada. Uno que ya se está haciendo responde 409 video_in_progress: está con el proveedor y se cobrará. Cuando ha terminado, DELETE lo borra junto con su archivo.

GET /v1/videos lista tus videos, los más nuevos primero, como los objetos de estado de arriba (sin enlace: pide un video por su id para eso). limit (de 1 a 100, por defecto 20) fija el tamaño de la página, after toma el last_id de la página anterior y status deja un estado. Una key de un proyecto ve los videos de su proyecto.

Cada segundo del video hecho, al precio del modelo para la resolución hecha: los segundos que cobra el proveedor (Alibaba los informa; xAI informa la duración del video), más el precio del modelo por imagen de referencia cuando lo tiene. En gemini-omni-1.1-flash, los tokens que informa Google (consulta Gemini Omni arriba). La tarifa del plan se suma, y la tarifa de auto cuando auto eligió el modelo. Un video que falló no cobra nada, salvo cuando el proveedor cobra un rechazo: xAI cobra un video que su moderación rechaza (0.02 USD en grok-imagine-video-1.5-lite cuando Zabio lo probó el 2026-11-05), y entonces la solicitud se cobra lo que cobró xAI más la tarifa del plan, y su mensaje de error dice cuánto.

El crédito se revisa cuando el video entra en cola. El coste estimado del video (la duración por el precio por segundo más alto del modelo, comisión incluida) se aparta de tu saldo, así que los videos puestos en cola a la vez no pueden dejar juntos el saldo por debajo de cero. Un video cuya estimación no cabe en el saldo que queda tras las llamadas aún en curso se rechaza con 402 insufficient_credits: el mensaje dice la estimación, el saldo y la cantidad mínima que añadir, y no se pone nada en cola. La cantidad apartada se devuelve cuando el video falla o se cancela, y se sustituye por el cargo real cuando el video se produce. El crédito se revisa de nuevo cuando el video empieza: uno cuyo saldo llegó a cero mientras esperaba termina failed con insufficient_credits y no cobra nada. El plan gratuito no hace videos.

El prompt y las imágenes que envías van al proveedor que hace el video. Zabio guarda la solicitud (con el prompt y las imágenes) hasta que el video termina, y el video hasta que lo borras o se acaba la retención de tu organización (30 días por defecto), o antes con zabio.expires_after; ambos se cifran con la clave de tu organización. Con el registro de cuerpos por key activado, el prompt y una referencia a las imágenes y al video (cantidad, tipo, bytes, duración) se guardan bajo la retención, nunca sus bytes. Avisa a tus usuarios de que los videos son generados por IA donde los muestres, como piden los términos de los proveedores.

Estado code Cuándo
400 invalid_value un campo está fuera de rango (seconds que no es un número entero, un size que no es ANCHOxALTO, una resolution fuera de la lista, size y resolution que no coinciden, n mayor que 1, un prompt de más de 4,000 caracteres, zabio.expires_after de menos de 3600 segundos), o un modelo nombrado no hace esos seconds o esa resolución; param dice cuál
400 invalid_value ni prompt ni input_reference; un zabio.last_frame sin input_reference; un input_reference que no es un png, jpeg o webp, o un file_id que tu key no puede leer
400 unsupported_value ningún modelo puede hacer el video pedido; o el modelo nombrado no parte de una imagen (o necesita una), no toma un último cuadro o siempre hace sonido (zabio.audio: false); una dirección web como input_reference; variant distinto de video en /content
400 unsupported_for_model el modelo nombrado no es un modelo de video
402 insufficient_credits el coste estimado del video, comisión incluida, no cabe en el saldo que queda tras las llamadas aún en curso, cada una con su estimación apartada hasta que termina (pide un video más corto o de menor resolución, o añade crédito); también el error de un video cuyo saldo llegó a cero antes de empezar
404 model_not_found no es un modelo o no está permitido para la key
404 video_not_ready /content antes de que el video esté completed
404 not_found ningún video con ese id; un enlace que expiró, se cambió o cuyo video se borró
409 video_in_progress DELETE de un video que se está haciendo
410 expired /content de un video que se borró o expiró
410 model_retired el modelo pasó su fecha de retirada (el mensaje dice la fecha); nada llegó al proveedor
413 media_too_large, payload_too_large una imagen de más de 20 MB, o un cuerpo de más de unos 55 MB
503 video_unavailable, no_provider_available la generación de video no está disponible en este servidor, o el proveedor del modelo no está configurado

El error.code de un video fallido es uno de: moderation_blocked (el sistema de seguridad del proveedor rechazó el prompt, la imagen o el video), invalid_value (el proveedor rechazó una entrada), generation_interrupted (el servidor se reinició en mal momento; el mensaje dice si se cobró algo), generation_timeout, insufficient_credits, storage_unavailable, internal_error (un error del lado de Zabio; cuando el video ya se había cobrado, el cargo se devuelve y el mensaje lo dice), no_provider_available, api_key_revoked, key_expired, o los códigos de fallo del proveedor de la página de errores. Se aplica el límite de solicitudes por minuto de la key. Un video que ya se hizo, se guardó y se cobró es tuyo aunque Zabio tenga un error al terminarlo: queda completed y lo puedes descargar.

import time
from openai import OpenAI
client = OpenAI(base_url="https://api.zabio.ai/v1", api_key="insert your zabio.ai key here")
video = client.videos.create(model="auto", prompt="Un faro rojo sobre una costa rocosa al atardecer, paneo lento", seconds="5", size="1280x720")
while video.status in ("queued", "in_progress"):
time.sleep(10)
video = client.videos.retrieve(video.id)
if video.status == "completed":
client.videos.download_content(video.id).write_to_file("faro.mp4")
print(video.status, video.model_extra.get("zabio"))
# A partir de una imagen, sin sonido
video = client.videos.create(model="grok-imagine-video-1.5-lite", prompt="Las olas se mueven", seconds="4",
input_reference=open("cuadro.png", "rb"), extra_body={"zabio": '{"audio": false}'})

Con el formulario multipart que envían los SDK cuando hay un archivo, el campo zabio es un texto JSON, como arriba; en una solicitud JSON es un objeto.