Generación de video

Crea un video a partir de texto: la solicitud, los estados, la descarga y el precio por segundo.

Modelos de video disponibles

720p, no sound

0,672 US$ / segundo

1080p, no sound

0,896 US$ / segundo

720p, with sound

1,008 US$ / segundo

1080p, with sound

1,344 US$ / segundo

720p, sound included

0,896 US$ / segundo

1080p, sound included

1,12 US$ / segundo

Cómo funciona el flujo

1. Envía POST /v1/videos/generations con el modelo, un prompt y las opciones. La respuesta trae un request_id.
2. Los videos se generan de forma asíncrona, normalmente en 1–3 minutos. Consulta el estado cada 10 segundos hasta que sea done o failed.
3. Cuando el estado es done, descarga el archivo desde la ruta de video.url con la misma clave.

Solicitud

curl -sS https://api.oneprovider.dev/v1/videos/generations \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-3.0",
"prompt": "A red balloon rises over a quiet harbor at sunrise",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}'
# {"request_id":"task_..."}

Una combinación que no está en la tabla de precios se rechaza de inmediato con un error 400 y no se cobra nada.

Estado

curl -sS https://api.oneprovider.dev/v1/videos/generations/$REQUEST_ID \
-H "Authorization: Bearer $ONEPROVIDER_KEY"
# {"request_id":"task_...","status":"pending","progress":50}
# {"request_id":"task_...","status":"done","progress":100,
# "video":{"url":"/v1/videos/generations/$REQUEST_ID/content","duration":5}}

Descarga

curl -sS https://api.oneprovider.dev/v1/videos/generations/$REQUEST_ID/content \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-o video.mp4

La respuesta es un archivo video/mp4 y se admite el encabezado Range. Guarda el archivo en tu sistema de inmediato; no cuentes con que el enlace funcione para siempre.

Precios

Pagas por segundo de video según la tarifa de la fila correspondiente de la tabla de arriba (resolución y sonido). El cobro se hace una sola vez, cuando el estado pasa a done; los videos fallidos o sin terminar no se cobran.

Ejemplo: kling-3.0, 720p, sin sonido, 5 segundos = 0,672 US$ × 5 = 3,36 US$.

Errores

Respuestas rápidas

¿Qué base URL uso?

Claude Code y los SDK de Anthropic usan https://api.oneprovider.dev. Los SDK de OpenAI y los clientes compatibles con OpenAI usan https://api.oneprovider.dev/v1. Una misma clave funciona con ambas; la lista de modelos está en la página de modelos y las tarifas, en la página de precios .

¿Cómo me autentico?

Envía la clave sk-… tal cual en x-api-key o en Authorization: Bearer: en uno de los dos, nunca en ambos. Guarda la clave en una variable de entorno, no en un archivo que se suba al repositorio. Más sobre la autenticación .

¿Dónde obtengo una clave?

Abre tu panel en el bot de Telegram @oneprovider_robot o en app.oneprovider.dev, recarga el saldo y pulsa “Emitir una clave”. Cada clave puede tener su propio límite de gasto. Panel y claves de API .

¿Qué significan 401, 404 y 429?

401: falta la clave, está mal escrita o se envió en un encabezado equivocado; pega la clave completa, sin comillas ni espacios. 404: casi siempre es una base URL incorrecta, por ejemplo con /v1 ausente o duplicado. 429 con “Insufficient balance”: se agotó el saldo del panel o el límite de gasto de la clave, así que recarga en lugar de reintentar; cualquier otro 429 es un límite de frecuencia, así que espera según Retry-After. Detalles: códigos de error y solución de problemas .

¿Por qué se cortan o se reinician los streams?

Las VPN y los proxies VLESS suelen almacenar SSE en búfer o romper la negociación de HTTP/2. OneProvider no tiene restricciones regionales y no almacena los streams en búfer: desactiva el proxy y reintenta.

¿Dónde pregunto si esto no basta?

Escribe a @Oneproviderhelpbot en Telegram o abre “Soporte” en el panel web, con el código de estado HTTP y el mensaje de error exacto. Cómo funciona el soporte .