Crear una tarea de generación de vídeo
post/v1/video/generations
Envía una tarea de generación de vídeo. Se admiten tanto texto a vídeo como imagen a vídeo.
Devuelve un ID de tarea que puedes consultar periódicamente a través del endpoint GET.
Autenticación
Envía tu clave de API de OLETOKEN como token Bearer. Las claves se crean en la página Claves de API de la consola.
Authorization: Bearer $OLETOKEN_API_KEYCuerpo de la solicitud
Content-Type:application/json
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| model | string | — | ID del modelo o del estilo |
| prompt | string | — | Prompt de texto |
| image | string | — | Entrada de imagen (URL o Base64) |
| duration | number | — | Duración del vídeo en segundos |
| width | integer | — | Ancho del vídeo |
| height | integer | — | Alto del vídeo |
| fps | integer | — | Velocidad de fotogramas del vídeo |
| seed | integer | — | Semilla aleatoria |
| n | integer | — | Número de vídeos que se van a generar |
| response_format | string | — | Formato de respuesta |
| user | string | — | Identificador del usuario |
| metadata | object | — | Parámetros adicionales (como negative_prompt, style, quality_level) |
Respuestas
200Tarea de generación de vídeo creada
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| task_id | string | — | ID de la tarea |
| status | string | — | Estado de la tarea |
400Parámetros de solicitud no válidos
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| error | object | — | — |
| message | string | — | Mensaje de error |
| type | string | — | Tipo de error |
| param | string | null | — | El parámetro implicado |
| code | string | null | — | Código de error |
Solicitud de ejemplo
curl -X POST 'https://api.oletoken.ai/v1/video/generations' \
-H "Authorization: Bearer $OLETOKEN_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-v1",
"prompt": "宇航员在月球上漫步",
"duration": 5,
"width": 1280,
"height": 720
}'
