https://api.nexscope.ai/ai/videoRecloneEjecutar 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/ai/videoReclone |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
refVideoUrl | string | obligatorio | Público URL del vídeo de referencia. Ejemplo: https://example.com/reference-video.mp4 |
refImageList | array | obligatorio | URLs de imagen pública para referencias de producto o visuales. Ejemplo: [
"https://example.com/product.jpg"
] |
videoType | string | obligatorio | Modelo de vídeo. Valores soportados: seedance-2-0, seedance-2-0-fast, seedance-2-0-mini, seedance-2-5, or happyhorse-v2. Ejemplo: seedance-2-0-fast |
videoTime | integer | opcional | Duración opcional del vídeo objetivo en segundos. Seedance 2.0, Fast, Mini, y HappyHorse V2 soportan cualquier entero de 5 a 15; Seedance 2.5 soporta 5, 10, 15, 20, 25 o 30. Ejemplo: 10 |
resolution | string | obligatorio | Resolución de vídeo de destino apoyada por el modelo seleccionado, como 720p o 1080p. Ejemplo: 720p |
aspectRatio | string | opcional | Relación de aspecto de vídeo objetivo con el apoyo del modelo seleccionado. Ejemplo: 9:16 |
saleCountry | string | obligatorio | Código de país de mercado objetivo utilizado para localizar el vídeo recreado. Ejemplo: US |
targetLanguage | string | obligatorio | Objetivo hablado y en pantalla del lenguaje para el vídeo recreado. Ejemplo: English |
productInfo | string | opcional | Información concisa del producto utilizada para guiar la recreación. Máximo 2500 caracteres. Ejemplo: Slim shockproof phone case with a clear finish. |
prompt | string | opcional | Indicación opcional de dirección creativa. Ejemplo: highlight the slim protective design |
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. |