Vídeo
Generación de vídeos con Hailuo 2.3 MCP
Generar un vídeo Hailuo 2.3 de una imagen primaria necesaria; la relación de aspecto es adaptable. El modelo se fija por esto APIAsí que videoType no debe ser suministrado en la solicitud.
Prompts y casos de uso de Generación de vídeos con Hailuo 2.3
Después de conectar esta herramienta MCP a tu asistente de IA, puedes plantear las preguntas siguientes. Sustituye los marcadores entre corchetes por tus datos y usa los valores admitidos en Argumentos.
¿Es tu primera vez con Nexscope MCP? Sigue la guía de conexión, y después usa los prompts siguientes. Las pestañas Integración y Parámetros y respuesta contienen los pasos de conexión, un ejemplo de llamada y la referencia técnica.
1. Animate a una imagen de producto
Prompt: Utilice Hailuo 2.3 Video Generación para animar [product image] para [supported duration in seconds] a [supported resolution]. Seguir [motion and scene brief] y mantener la apariencia de producto consistente.
2. Fitar el vídeo a su ubicación
Prompt: Utilice Hailuo 2.3 Video Generación para animar [product image] para [supported duration in seconds] a [supported resolution]. Seguir [motion and scene brief] y mantener la apariencia de producto consistente. Uso [supported duration], [supported resolution] y [supported aspect ratio, if available] para la colocación prevista. Respeta las indicaciones creativas proporcionadas.
3. Refinar el resumen de la moción
Prompt: Utilice Hailuo 2.3 Video Generación para animar [product image] para [supported duration in seconds] a [supported resolution]. Seguir [motion and scene brief] y mantener la apariencia de producto consistente. Mejora mi movimiento breve antes de la generación preservando los hechos del producto y la acción prevista. Para un borrador de comparación, mantenga mi redacción original sin cambios.
4. Elija el modo Generación
Prompt: Utilice Hailuo 2.3 Video Generación para animar [product image] para [supported duration in seconds] a [supported resolution]. Seguir [motion and scene brief] y mantener la apariencia de producto consistente. Utilice la opción de generación profesional sólo donde este modelo lo soporta; de otro modo mantenga el modo estándar.
Qué debes proporcionar
Proporciona los recursos de referencia que exige el modo de entrada elegido. No combines el modo de vídeo de referencia con los modos de imagen de referencia.
Respeta las duraciones, resoluciones, relaciones de aspecto y límites de recursos documentados para este modelo. La restricción del fotograma final solo se aplica a los modelos que la admiten.
La respuesta inicial puede indicar que la tarea sigue pendiente. Consulta el resultado de esa misma tarea hasta alcanzar un estado final documentado; no prometas un vídeo reproducible antes de que termine correctamente.
Paso 1 · Conectar
Conecta tu asistente de IA
Conecta un cliente MCP compatible a Nexscope y selecciona esta herramienta en tu asistente. Completa la autenticación en la configuración de conexión del cliente.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAutenticación
Usa el código de autorización OAuth 2.1 con PKCE y el ámbito mcp:tools. Las claves de API siguen siendo una opción de compatibilidad admitida.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx¿Usas una clave de API? Obtén tu clave en Acceso a la API e inclúyela en el encabezado Authorization que se muestra arriba.
Llamar a esta herramienta MCP
nexscope_hailuo_2_3_video_generationhttps://api.nexscope.ai/mcptools/callInicializa una sesión HTTP Streamable MCP 2025-11-25 en https://api.nexscope.ai/mcp y después usa tools/call.
{
"jsonrpc": "2.0",
"id": "hailuo-2-3-video-generation-1",
"method": "tools/call",
"params": {
"name": "nexscope_hailuo_2_3_video_generation",
"arguments": {
"imageUrl": "https://example.com/source-image.jpg",
"prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
"resolution": "1080p",
"videoTime": 6
}
}
}MCP 2025-11-25 · Streamable HTTPLa respuesta SSE del POST inicial comunica el progreso. El flujo SSE por GET transmite notificaciones; si se restablece la conexión, consulta la tarea asíncrona existente en vez de enviarla de nuevo.
Flujo de tareas asíncronas
- 1. Crear una sola vez
Conserva el taskId devuelto.
- 2. Consultar con espera progresiva
Usa nexscope_media_task_result después de 5 segundos y luego de 10, 20 y 30 segundos.
- 3. Usar el resultado final
Detén las consultas al obtener éxito, fallo o tiempo de espera agotado.
{
"jsonrpc": "2.0",
"id": "hailuo-2-3-video-generation-result-1",
"method": "tools/call",
"params": {
"name": "nexscope_media_task_result",
"arguments": {
"skillSlug": "hailuo-2-3-video-generation",
"taskId": "TASK_ID_FROM_THE_GENERATION_RESULT"
}
}
}Argumentos
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
videoTime | integer | obligatorio | Duración del vídeo en segundos. Valores respaldados: 6, 10. Ejemplo: 6 |
prompt | string | obligatorio | Generación de vídeo rápida describiendo movimiento, consistencia de sujeto, movimiento de cámara, y la escena del comercio electrónico. Máximo 2000 caracteres. Ejemplo: Keep the product consistent while the camera slowly orbits and highlights material details. |
promptOptimizer | boolean | opcional | Ya. Nexscope debe optimizar el impulso de vídeo antes de la generación. Defaults to false. Ejemplo: false |
isPro | boolean | opcional | Ya sea para usar el modo de generación profesional del modelo cuando se admite. Defaults to false. Ejemplo: false |
resolution | string | obligatorio | Resolución de salida. Valores compatibles: 768p, 1080p. Ejemplo: 1080p |
imageUrl | string | obligatorio | Público URL de la imagen de referencia inicial o primaria requerida. Ejemplo: https://example.com/source-image.jpg |
Campos de respuesta
Usa structuredContent como los datos de respuesta de la API para el procesamiento programático.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | obligatorio | 0 indica que la solicitud se ha aceptado o se ha completado correctamente; cualquier valor distinto de cero indica un error de la plataforma. |
cost | string | obligatorio | Milliseconds pasados, nunca créditos; -1 solicitudes fuera 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 | Tiempo local del servidor: yyyy-MM- No. HH:mm:ss. |
traceId | string | null | obligatorio | Valor de Trace id usado por esta operación de API. |
ts | string | obligatorio | Época 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 | Producción completa de generación retenida del resultado de la tarea. Las esferas varían según la capacidad; el uso generado de los recursos Nexscope- hospedado URLs y cualquier cargo representa Nexscope créditos. Esta es la salida del negocio, no un recibo de creación de tareas. |
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 completa de generación retenida del resultado de la tarea. Las esferas varían según la capacidad; el uso generado de los recursos Nexscope- hospedado URLs y cualquier cargo representa Nexscope créditos. Esta es la salida 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 | Producción completa de generación retenida del resultado de la tarea. Las esferas varían según la capacidad; el uso generado de los recursos Nexscope- hospedado URLs y cualquier cargo representa Nexscope créditos. Esta es la salida del negocio, no un recibo de creación de tareas. |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | null | obligatorio | Valor de Data usado por esta operación de API. |
Ilustración del formato
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
Pregunta ilustrativa
Use Hailuo 2.3 Generación de vídeo con el material de referencia suministrado para este breve: Mantenga el producto consistente mientras la cámara orbita lentamente y resalta detalles materiales.
Explicación ilustrativa de la respuesta
La solicitud del ejemplo se aceptó como tarea example-task y está en estado PENDING. Aún no hay un resultado final. Conserva el ID de la tarea y consulta su resultado; no vuelvas a enviarla solo porque sigue en curso.
Sobre esta muestra: Ejemplo de formato con valores ficticios; no procede de una llamada real a la herramienta. Sustituye los datos de ejemplo por recursos que tengas derecho a usar o identificadores públicos.
No hay datos de ejemplo publicados para esta página. Una ilustración del formato o una guía de flujo de trabajo no sustituye un resultado publicado.
Ver el formato de solicitud y respuesta MCP
Ejemplos
Ejemplo ilustrativo con datos ficticios, no una llamada en vivo a la herramienta.
La estructura JSON-RPC siguiente muestra cómo se presentan en MCP los argumentos y los datos indicados. No procede de una captura de tráfico ni demuestra que la llamada se haya completado. Los ejemplos de flujo de trabajo no muestran un resultado.
Solicitud MCP
{
"jsonrpc": "2.0",
"id": "hailuo-2-3-video-generation-example",
"method": "tools/call",
"params": {
"name": "nexscope_hailuo_2_3_video_generation",
"arguments": {
"imageUrl": "https://example.com/source-image.jpg",
"prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
"resolution": "1080p",
"videoTime": 6
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "hailuo-2-3-video-generation-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"cost\":\"-1\",\"data\":{\"taskId\":\"example-task\",\"status\":\"PENDING\",\"result\":null},\"msg\":null,\"time\":\"2026-01-01 00:00:00\",\"traceId\":null,\"ts\":\"0\"}"
}
],
"structuredContent": {
"code": 0,
"cost": "-1",
"data": {
"taskId": "example-task",
"status": "PENDING",
"result": null
},
"msg": null,
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "0"
},
"isError": false
}
}