https://api.nexscope.ai/video/kling3OmniVideoGenerationEjecutar 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/kling3OmniVideoGeneration |
| 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, 15. 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 7 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: 1:1, 9:16, 16:9. Ejemplo: 1:1 |
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 significa aceptado o exitoso; no cero es un error de plataforma. |
cost | string | obligatorio | Se pasó milisegundos, nunca créditos; -1 peticiones externas de la web. |
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 | Hora local del servidor: aaaa-mm-dd HH:mm:ss. |
traceId | string | null | obligatorio | Valor de Trace id usado por esta operación de API. |
ts | string | obligatorio | Epoch milisegundos. |
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 | Producción de generación completa retenida del resultado de la tarea. Los campos varían según la capacidad; uso de recursos generados Nexscope-organiza URLs y cualquier cuenta representa carga Nexscope créditos. Este es el resultado del negocio, no un recibo de creación de tareas. |
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 la ausencia de una clave API (code 11209), 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. |