Nexscope

API de vídeos comerciales con locución

Genera un vídeo de ventas con locución para promociones de comercio electrónico. Revisa la autenticación, los parámetros de solicitud, los campos de respuesta y el uso de MCP.

CosteEst. 1040–1248 credits / call
Probar en línea
POST · https://api.nexscope.ai/ai/salesTalkingVideoMCP · nexscope_sales_talking_video
Se requiere suscripción. Las API de IA creativa solo están disponibles para usuarios con una suscripción activa. Los créditos de prueba no habilitan el acceso con clave de API. Ver planes de suscripción.

Qué hace esta API

Cree un video de venta de productos a partir de referencias de imágenes de producto y de mensajes.

Casos de uso de API de vídeos comerciales con locución

Preparar un vídeo de producto

Para redactar un vídeo del producto, un editor de contenido envía imageList Los resultados de generación completados devueltos ayudan a revisar un concepto de vídeo antes de la producción de la campaña.

Preparar variantes de vídeo de campaña

Un editor de contenido utiliza Sales Talking Video con prompt y imageList Los resultados de generación completados devueltos ayudan a comparar clips creados para diferentes informes de campaña.

Revisión de imágenes generadas para una lista

Para este flujo de trabajo, un editor de contenido llama a Sales Talking Video con prompt y imageList para revisar las imágenes generadas para una lista. El resultado ayuda a elegir las imágenes adecuadas para la lista de productos.

Preguntas frecuentes sobre API de vídeos comerciales con locución

¿Qué es lo que dice el video de ventas? API ¿Volver?

Crear un video de venta de producto a partir de referencias de imagen de producto y de prompt. `prompt`, `imageList`, `videoType`, `videoTime`, `aspectRatio`. La respuesta inicial puede contener un ID de tarea y el estado; el resultado de la tarea completa contiene la salida generada. Los valores de ejemplo ilustran la forma de respuesta, en lugar de los resultados reales de la cuenta.

¿Cuántos créditos tiene el Video de Hablar de Ventas API ¿costo?

El coste documentado actualmente es Est. 1040–1248 credits / call. Es el mismo que figura en la parte superior de esta página. Si se muestra un intervalo o una estimación, el cargo final depende de la solicitud. Antes de llamar a la API, revisa los créditos disponibles y la página de precios. Consulta el registro de uso de la API para comprobar el cargo aplicado.

¿Cómo llamo al video de las ventas API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /ai/salesTalkingVideo con tu API como un símbolo de portador y la JSON datos de entrada API En una MCP cliente como Claude o Cursor, conectar Nexscope y llamar nexscope_sales_talking_video. Utilice el MCP argumentos mostrados en el MCP guía, o cambiar la prueba en línea a MCP para revisar su solicitud antes de añadirla a tu aplicación.

Ver planes y créditosConecta esta API con MCP

Prueba esta API
Endpoint
https://api.nexscope.ai/ai/salesTalkingVideo
Método MCP
nexscope_sales_talking_video

Paso 1 de 3 · Autenticarse

Autenticación

Todos los endpoints de ejecución requieren una clave de API de usuario. Envíala como token bearer en la cabecera Authorization .

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Las claves de API ausentes o no válidas devuelven un error de autenticación. Gestiona las claves desde .

Paso 2 de 3 · Enviar una solicitud

POSThttps://api.nexscope.ai/ai/salesTalkingVideo

Ejecutar una API

Cree un video de venta de productos a partir de referencias de imágenes de producto y de mensajes.

Solicitud de ejemplo

Sustituye YOUR_API_KEY y ejecuta este comando en tu terminal.

curl -X POST 'https://api.nexscope.ai/ai/salesTalkingVideo' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "aspectRatio": "9:16",
  "imageList": [
    "https://example.com/product.jpg"
  ],
  "isPro": false,
  "prompt": "Introduce this shockproof phone case in an upbeat tone.",
  "resolution": "720p",
  "videoTime": 10,
  "videoType": "seedance-2-0-fast"
}'

Ejemplo de código

{
  "aspectRatio": "9:16",
  "imageList": [
    "https://example.com/product.jpg"
  ],
  "isPro": false,
  "prompt": "Introduce this shockproof phone case in an upbeat tone.",
  "resolution": "720p",
  "videoTime": 10,
  "videoType": "seedance-2-0-fast"
}

Paso 3 de 3 · Inspeccionar el resultado

Comprueba la respuesta

Consulta code para ver el estado de la solicitud y data para ver el resultado. Abre la referencia de parámetros y respuestas para consultar las definiciones completas de los campos.

Códigos de estado HTTP

CódigoDescripción
200Respuesta 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.
429Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
OpcionalX-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.
Todas las categorías/ Edición y variaciones de imágenes
POSThttps://api.nexscope.ai/ai/salesTalkingVideo

Ejecutar esta API

Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.

Endpoint

MétodoPOST
Rutahttps://api.nexscope.ai/ai/salesTalkingVideo
AutenticaciónBearer API key
Content-Typeapplication/json

Parámetros de la solicitud

NombreTipoObligatorioDescripción
promptstringobligatorio
Guión de ventas o aviso creativo.
Ejemplo: Introduce this shockproof phone case in an upbeat tone.
imageListarrayobligatorio
URLs de imagen de producto público. Proporcione hasta 30 imágenes para Seedance 2.5 o hasta 9 imágenes para los otros modelos soportados.
Ejemplo: [ "https://example.com/product.jpg" ]
videoTypestringobligatorio
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
videoTimeintegeropcional
Duración del objetivo en segundos. Seedance 2.0, Fast, Mini, y HappyHorse V2 soporte 5, 10, o 15; Seedance 2.5 también soporta 30.
Ejemplo: 10
aspectRatiostringopcional
Relación de aspecto objetivo: 16:9, 9:16, 1:1, 4:3, 3:4, o 21:9.
Ejemplo: 9:16
isProbooleanopcional
Habilitar el modo Pro para cualquier modelo Seedance. HappyHorse V2 no admite el modo Pro. Cuando está activado sin resolución, el valor predeterminado es 720p.
Ejemplo: false
resolutionstringopcional
Resolución de objetivo. Seedance 2.0 y 2.5 soporte 480p, 720p, o 1080p; Seedance Fast y Mini soporte 480p o 720p; HappyHorse V2 soportes 720p o 1080p.
Ejemplo: 720p

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

NombreTipoObligatorioDescripción
codeintegerobligatorio
0 means accepted or successful; nonzero is a platform error.
coststringobligatorio
Elapsed milliseconds, never credits; -1 outside web requests.
dataanyobligatorio
Valor de Data usado por esta operación de API.
msgstring | nullobligatorio
Valor de Msg usado por esta operación de API.
timestringobligatorio
Server local time: yyyy-MM-dd HH:mm:ss.
traceIdstring | nullobligatorio
Valor de Trace id usado por esta operación de API.
tsstringobligatorio
Epoch milliseconds.

Opción 1 de cualquier alternativa — requiere taskId, status, result

NombreTipoObligatorioDescripción
dataobjectobligatorio
Valor de Data usado por esta operación de API.
data.resultanyobligatorio
Valor de Result usado por esta operación de API.
data.statusstringobligatorio
Valor de Status usado por esta operación de API.
Permitidos: PENDING, RUNNING, SUCCEEDED, FAILED, TIMEOUT
data.taskIdstringobligatorio
Valor de Task id usado por esta operación de API.

Opción 1 de cualquier alternativa

NombreTipoObligatorioDescripción
data.resultobjectobligatorio
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

NombreTipoObligatorioDescripción
data.resultnullobligatorio
Valor de Result usado por esta operación de API.

Opción 2 de cualquier alternativa

NombreTipoObligatorioDescripción
datanullobligatorio
Valor de Data usado por esta operación de API.

Respuestas

CódigoDescripción
200Respuesta 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.
429Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
OpcionalX-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.

Paso 1 de 2 · Conectar tu cliente MCP

MCP

Conecta agentes remotos a través del endpoint HTTP Streamable estándar MCP 2025-11-25. Usa el código de autorización OAuth 2.1 con PKCE, o una clave de API por compatibilidad.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json
Autenticación

Los clientes OAuth solicitan el ámbito mcp:tools. La respuesta 401 del endpoint anuncia metadatos de recurso protegido para descubrir la autorización.

Paso 2 de 2 · Llamar a la herramienta

Llamar a una herramienta

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_sales_talking_video",
    "arguments": {
      "aspectRatio": "9:16",
      "imageList": [
        "https://example.com/product.jpg"
      ],
      "isPro": false,
      "prompt": "Introduce this shockproof phone case in an upbeat tone.",
      "resolution": "720p",
      "videoTime": 10,
      "videoType": "seedance-2-0-fast"
    }
  }
}

¿Qué puedes hacer con esta API?

Datos explicados y casos de uso prácticos

AI Guide

Question

What can Sales Talking Video create, and how might I use it?

AI answer

Sales Talking Video accepts a sales prompt and product images to start generating a product-selling video. The documented response confirms that the task was accepted; it does not show the finished video or document the completed result’s media fields. Retrieve and inspect the completed result before using the video.

Data categoryDocumented fieldWhat it means
Generation statedata.statusThe example returns PENDING, so the video is not ready yet.
Completed outputdata.resultnull in the submission example. The structure of a finished result is not documented here.
Result retrievaldata.taskIdIdentifies the task to check for completion.
  • Turn a phone-case image and an upbeat sales script into a short product pitch, then use the completed video after retrieval.
    • Prompt example: “I am preparing product creative for an online listing. Could you turn a phone-case image and an upbeat sales script into a short product pitch, then use the completed video after retrieval? Show the relevant returned evidence and tell me what input you need from me.”
  • Create a vertical product video by requesting 9:16 for a mobile-oriented placement.
    • Prompt example: “I am preparing product creative for an online listing. Could you create a vertical product video by requesting 9:16 for a mobile-oriented placement? Show the relevant returned evidence and tell me what input you need from me.”
  • Supply several product views to guide a video that shows more than one visual detail.
    • Prompt example: “I am preparing product creative for an online listing. Could you supply several product views to guide a video that shows more than one visual detail? Show the relevant returned evidence and tell me what input you need from me.”
  • Request a 5-, 10-, or 15-second version to fit a planned campaign slot; Seedance 2.5 also accepts 30 seconds.
    • Prompt example: “I am preparing product creative for an online listing. Could you request a 5-, 10-, or 15-second version to fit a planned campaign slot; Seedance 2.5 also accepts 30 seconds? Show the relevant returned evidence and tell me what input you need from me.”

API relacionadas