Skip to main content
POST
POST /v1/videos/generations

Request body

string
required
El ID namespaced del modelo, ej. fal/kling-3-pro. Ver Modelos video.
string
required
Descripción del video. Máximo 4000 caracteres.
integer
Duración en segundos. Si no la mandas, usamos el default del modelo. Cap por modelo (ver catálogo).
string
Ratio del video. Ejemplos: 16:9, 9:16, 1:1, 4:5. Soporte depende del modelo.

Response (inmediata, ~100ms)

string
El job_id. Úsalo para polling.
string
Generalmente processing. Raro pero posible failed si la submission al provider explotó.
string
El model id que pediste.

Ejemplos

⚠️ Sobre el costo

Al crear el job NO se cobra todavía. El cobro ocurre cuando el job transita a completed. Si falla, no hay cargo. Cap de seguridad: tu saldo se valida al submit — si está ≤ 0 te devolvemos 402 insufficient_balance antes de crear el job.
Antes de mandar muchos jobs en paralelo, calcula tu cost máximo: duration × precio_modelo × markup × FX. Por ejemplo 10 videos Kling 5s = 10 × 5 × $0.04 × 1.05 × 20 = $42 MXN.

Siguiente paso

GET /v1/videos/{id}

Polea el estado del job hasta que llegue a completed.