https://api.nexscope.ai/video/kling26VideoGenerationEjecutar esta API
Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.
Endpoint
| Método | POST |
| Ruta | https://api.nexscope.ai/video/kling26VideoGeneration |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
videoTime | integer | obligatorio | Duración del vídeo en segundos. Valores soportados: 5, 10. Ejemplo: 10 |
prompt | string | obligatorio | Instrucción para generar el vídeo. Describe el movimiento, la coherencia del sujeto, el movimiento de cámara y la escena de comercio electrónico. Máximo de 2000 caracteres. Ejemplo: Keep the product consistent while the camera slowly orbits and highlights material details. |
promptOptimizer | boolean | opcional | Si Nexscope debe optimizar el indicador de vídeo antes de la generación. Por defecto a false. Ejemplo: false |
isPro | boolean | opcional | Si usar el modo de generación profesional del modelo cuando se admite. Defaults to false. Ejemplo: false |
resolution | string | opcional | Resolución de salida. Valores soportados: 720p, 1080p. Ejemplo: 1080p |
imageUrl | string | condicional | Público URL de una imagen de referencia primaria o de primer marco. Ejemplo: https://example.com/source-image.jpg |
imageList | array | condicional | URLs de imagen de referencia pública. Proporcionar 1 a 2 imágenes. Ejemplo: [
"https://example.com/product.jpg",
"https://example.com/ref-2.jpg"
] |
aspectRatio | string | condicional | Relación de aspecto de vídeo objetivo apoyado por este modelo. Valores compatibles: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9. Ejemplo: 16:9 |
lastFrameImageUrl | string | opcional | Público facultativo URL de la imagen de marco final. Requiere 1080p. Ejemplo: https://example.com/last-frame.jpg |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
{
"code": 0,
"cost": "-1",
"data": {
"result": null,
"status": "PENDING",
"taskId": "example-task"
},
"msg": null,
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "0"
}Campos de respuesta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | obligatorio | 0 means accepted or successful; nonzero is a platform error. |
cost | string | obligatorio | Elapsed milliseconds, never credits; -1 outside web requests. |
data | any | obligatorio | Valor de Data usado por esta operación de API. |
msg | string | null | obligatorio | Valor de Msg usado por esta operación de API. |
time | string | obligatorio | Server local time: yyyy-MM-dd HH:mm:ss. |
traceId | string | null | obligatorio | Valor de Trace id usado por esta operación de API. |
ts | string | obligatorio | Epoch milliseconds. |
Opción 1 de cualquier alternativa — requiere taskId, status, result
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | object | obligatorio | Valor de Data usado por esta operación de API. |
data.result | any | obligatorio | Valor de Result usado por esta operación de API. |
data.status | string | obligatorio | Valor de Status usado por esta operación de API. Permitidos: PENDING, RUNNING, SUCCEEDED, FAILED, TIMEOUT |
data.taskId | string | obligatorio | Valor de Task id usado por esta operación de API. |
Opción 1 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result | object | obligatorio | Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt. |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data.result | null | obligatorio | Valor de Result usado por esta operación de API. |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | null | obligatorio | Valor de Data usado por esta operación de API. |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado. |
| 429 | Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente. |
| 503 | La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente. |
| Opcional | X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200. |