Imagen
Generación de imágenes con Nano Banana MCP
Generar imágenes de comercio electrónico con el modelo de imagen base Nano Banana. El modelo está fijado por esto API, por lo que el proveedor no debe ser suministrado en la solicitud.
Prompts y casos de uso de Generación de imágenes con Nano Banana
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. Generar una imagen de producto
Prompt: Use Nano Banana Image Generation para crear una imagen [product] dentro [scene], siguiente [composition and visual style]. Utilice sólo los hechos de producto que proveo.
2. Crear de referencias de producto
Prompt: Utilizar Nano Banana Generación de imagen con [product reference images] crear [new composition]. Conserva el diseño visible del producto y evita añadir características que no aparezcan en la referencia.
3. Preparar imágenes para un lugar
Prompt: Use Nano Banana Image Generation para crear una imagen [product] dentro [scene], siguiente [composition and visual style]. Utilice sólo los hechos de producto que proveo. Uso [supported aspect ratio] y [supported resolution] para la colocación prevista. Mantenga la composición solicitada legible en ese tamaño.
4. Crear un pequeño conjunto de alternativas
Prompt: Use Nano Banana Image Generation para crear una imagen [product] dentro [scene], siguiente [composition and visual style]. Utilice sólo los hechos de producto que proveo. Generar [number of images within the documented limit] para su revisión, utilizando el mismo resumen del producto. Tratar cada imagen como una variación generada.
Qué debes proporcionar
Proporcionar un breve escrito; las imágenes de referencia son opcionales para este modelo. Siga el recuento de imagen, tipo de archivo y límites de tamaño en Parámetros & Respuesta.
Un recibo de tarea no es una imagen terminada. Revise la tarea existente para su resultado terminal en lugar de enviar otra solicitud de generación.
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_banana_image_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": "banana-image-generation-1",
"method": "tools/call",
"params": {
"name": "nexscope_banana_image_generation",
"arguments": {
"aspectRatio": "1:1",
"imageUrls": [],
"outputNum": 1,
"prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
"resolution": "1K"
}
}
}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": "banana-image-generation-result-1",
"method": "tools/call",
"params": {
"name": "nexscope_media_task_result",
"arguments": {
"skillSlug": "banana-image-generation",
"taskId": "TASK_ID_FROM_THE_GENERATION_RESULT"
}
}
}Argumentos
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
imageUrls | array | opcional | Imagen de referencia pública opcional URLsOmitir este campo para la generación de texto a imagen, o proporcionar referencias para la generación de imagen a imagen. Cuando se suministra, proporcione 1 a 10 JPG, PNGo WEBP imágenes; cada imagen no debe exceder 20 MB. Ejemplo: [] |
prompt | string | obligatorio | Generation prompt describing the target image, scene, composition, style, and constraints. Máximo 5000 caracteres. Ejemplo: Keep the product consistent and generate a clean white-background ecommerce hero image. |
outputNum | integer | opcional | Número de imágenes para generar. Rango válido: 1 a 10; predeterminados a 1. Ejemplo: 1 |
resolution | string | opcional | Resolución de salida. Valores compatibles: 1K solamente. Ejemplo: 1K |
aspectRatio | string | opcional | Relación de aspecto de salida. Valores respaldados: 1:1, 16:9, 9:16, 3:4, 4:3, 3:2, 2:3, 4:5, 5:4, 21:9. Ejemplo: 1:1 |
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 Nano Banana Image Generation con el material de referencia suministrado para este breve: Mantenga el producto consistente y genere una imagen de héroe de comercio electrónico de color blanco y fondo limpio.
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": "banana-image-generation-example",
"method": "tools/call",
"params": {
"name": "nexscope_banana_image_generation",
"arguments": {
"aspectRatio": "1:1",
"imageUrls": [],
"outputNum": 1,
"prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
"resolution": "1K"
}
}
}Formato de respuesta MCP
{
"jsonrpc": "2.0",
"id": "banana-image-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
}
}