API v3 de conjuntos de imágenes y fotografía de moda con IA

Genera conjuntos coordinados de imágenes de marketing y fotografía de productos de moda. Revisa la autenticación, los parámetros de solicitud y los campos de respuesta.

CosteCredit usage unavailable

Probar en línea

POST · https://api.nexscope.ai/ai/apparelImageSetPhotographyV3MCP · nexscope_ai_apparel_image_set_photography_v3

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 conjuntos de imágenes de comercio electrónico de ropa de imágenes de ropa con referencia opcionales de modelos y escenas.

Casos de uso de API v3 de conjuntos de imágenes y fotografía de moda con IA

Preparar los activos de la imagen de la lista

Para preparar la lista de los activos de la imagen, un editor de contenido presenta imageList y proveedor de AI Apparel Image Set & Photography v3. Los resultados de generación completados devueltos ayudan a preparar los visuales del producto para una revisión de la lista.

Comparar un tratamiento visual del producto

Un editor de contenido utiliza AI conjunto de imágenes y fotografía v3 con imageList Los resultados de generación completados devueltos ayudan a comparar el tratamiento editado con el activo fuente.

Revisar los activos editados para una campaña

Para este flujo de trabajo, un editor de contenido llama a AI Apparel Image Set & Photography v3 con imageList y el proveedor para revisar los activos editados para una campaña. El resultado ayuda a seleccionar un activo aprobado para la campaña.

Preguntas frecuentes sobre API v3 de conjuntos de imágenes y fotografía de moda con IA

¿Qué hace el conjunto de imágenes y fotografía de AI Apparel v3? API ¿Volver?

Crear conjuntos de imágenes de ropa de comercio electrónico de imágenes de ropa con referencia opcionales de modelo y escena. `imageList`, `provider`, `sellerPoint`, `isExtractPrePoint`, `resolution`. 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 conjunto de imágenes y fotografía de AI Apparel v3 API ¿costo?

El coste documentado actualmente es Credit usage unavailable. 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 conjunto de imágenes y fotografías de AI Apparel v3 API desde mi aplicación o un MCP ¿Cliente?

Enviar a POST solicitud a /ai/apparelImageSetPhotographyV3 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_ai_apparel_image_set_photography_v3. 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éditos Conecta esta API con MCP (en inglés)

Prueba esta API

Endpoint

https://api.nexscope.ai/ai/apparelImageSetPhotographyV3

Método MCP

nexscope_ai_apparel_image_set_photography_v3

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/apparelImageSetPhotographyV3

Ejecutar una API

Cree conjuntos de imágenes de comercio electrónico de ropa de imágenes de ropa con referencia opcionales de modelos y escenas.

Solicitud de ejemplo

Sustituye YOUR_API_KEY y ejecuta este comando en tu terminal.

curl -X POST 'https://api.nexscope.ai/ai/apparelImageSetPhotographyV3' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "aPlusAspectRatio": "1:1",
  "aPlusHasPhone": false,
  "aPlusNum": 0,
  "aPlusProNum": 0,
  "aPlusStyles": [
    {
      "id": 1
    },
    {
      "prompt": "clean editorial layout"
    }
  ],
  "aspectRatio": "1:1",
  "brandKey": "{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}",
  "imageList": [
    "https://example.com/product.jpg"
  ],
  "insTypeNum": 0,
  "isExactScene": true,
  "isExtractPrePoint": false,
  "modelAndSceneInfo": "{\"model\":\"female adult\",\"scene\":\"studio\"}",
  "modelImageUrl": "https://example.com/model-reference.jpg",
  "modelTypeNum": 0,
  "noText": false,
  "pointStyles": [
    {
      "id": 2
    },
    {
      "prompt": "minimal feature callouts"
    }
  ],
  "provider": "BANANA_2",
  "quality": "medium",
  "replaceLibraryId": 1002,
  "resolution": "2K",
  "sceneImageUrl": "https://example.com/scene.jpg",
  "sellerPoint": "Lightweight breathable summer dress",
  "sellerTypeNum": 0,
  "sensitiveLibraryId": 1001,
  "sizeTypeNum": 0,
  "whiteTypeNum": 0
}'

Ejemplo de código

{
  "aPlusAspectRatio": "1:1",
  "aPlusHasPhone": false,
  "aPlusNum": 0,
  "aPlusProNum": 0,
  "aPlusStyles": [
    {
      "id": 1
    },
    {
      "prompt": "clean editorial layout"
    }
  ],
  "aspectRatio": "1:1",
  "brandKey": "{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}",
  "imageList": [
    "https://example.com/product.jpg"
  ],
  "insTypeNum": 0,
  "isExactScene": true,
  "isExtractPrePoint": false,
  "modelAndSceneInfo": "{\"model\":\"female adult\",\"scene\":\"studio\"}",
  "modelImageUrl": "https://example.com/model-reference.jpg",
  "modelTypeNum": 0,
  "noText": false,
  "pointStyles": [
    {
      "id": 2
    },
    {
      "prompt": "minimal feature callouts"
    }
  ],
  "provider": "BANANA_2",
  "quality": "medium",
  "replaceLibraryId": 1002,
  "resolution": "2K",
  "sceneImageUrl": "https://example.com/scene.jpg",
  "sellerPoint": "Lightweight breathable summer dress",
  "sellerTypeNum": 0,
  "sensitiveLibraryId": 1001,
  "sizeTypeNum": 0,
  "whiteTypeNum": 0
}

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ó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.

Ver parámetros y respuesta Probar en línea

Todas las categorías/ IA multimodal

POSThttps://api.nexscope.ai/ai/apparelImageSetPhotographyV3

Ejecutar esta API

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

Abrir área de pruebas

Endpoint

Método	`POST`
Ruta	`https://api.nexscope.ai/ai/apparelImageSetPhotographyV3`
Autenticación	`Bearer API key`
Content-Type	`application/json`

Parámetros de la solicitud

Nombre	Tipo	Obligatorio	Descripción
`imageList`	`array`	obligatorio	URLs de imagen de ropa pública. No proporcionar más de 5 imágenes JPG, JPEG, PNG o WEBP; cada imagen debe ser como máximo 10 MB y entre 384 y 4096 píxeles. Ejemplo: [ "https://example.com/product.jpg" ]
`provider`	`string`	opcional	Modelo de imagen. Por defecto BANANA_2. Valores soportados: BANANA_2, BANANA_2_LITE, BANANA_PRO, WAN2_7, SEEDREAM5_PRO, GPT_2_IMAGE. Ejemplo: BANANA_2
`sellerPoint`	`string`	condicional	Puntos de venta de productos, hasta 2500 caracteres. Se requiere cuando isExtractPrePoint es falso. Ejemplo: Lightweight breathable summer dress
`isExtractPrePoint`	`boolean`	opcional	Si extraer automáticamente puntos de venta. Por defecto a false. Cuando false, sellerPoint es necesario. Ejemplo: false
`resolution`	`string`	opcional	Resolución de objetivos apoyada por el proveedor seleccionado. Ejemplo: 2K
`aspectRatio`	`string`	opcional	Relación de aspecto objetivo. Ejemplo: 1:1
`noText`	`boolean`	opcional	Si las imágenes generadas deben evitar el texto. Ejemplo: false
`brandKey`	`string`	opcional	Información opcional de marca serializada como un JSON string. Teclas soportadas: brandColor, fontStyle, salesRegion, idioma, plataforma, customSettings. Ejemplo: {"brandColor":"#0775FA","fontStyle":"sans serif","salesRegion":"North America","language":"English","platform":"Amazon"}
`quality`	`string`	opcional	GPT Calidad de imagen solamente. Valores soportados: bajo, medio o alto. Ejemplo: medium
`sensitiveLibraryId`	`integer`	opcional	Opcional de la biblioteca de palabras sensibles ID utilizado para la pantalla de copia generada. Ejemplo: 1001
`replaceLibraryId`	`integer`	opcional	ID opcional de biblioteca de palabras de reemplazo utilizado para reescribir la copia generada. Ejemplo: 1002
`modelImageUrl`	`string`	opcional	Imagen de referencia del modelo opcional URL. Ejemplo: https://example.com/model-reference.jpg
`sceneImageUrl`	`string`	opcional	Imagen de referencia opcional de la escena URL. Ejemplo: https://example.com/scene.jpg
`isExactScene`	`boolean`	opcional	Si se debe comparar la escena proporcionada de cerca. Por defecto a true. Ejemplo: true
`modelAndSceneInfo`	`string`	opcional	Información sobre modelos e escenas seriada como un JSON texto estructurado de cadena o conciso. Ejemplo: {"model":"female adult","scene":"studio"}
`aPlusNum`	`integer`	opcional	Número de imágenes estándar A+, de 0 a 12. Por defecto a 0. Ejemplo: 0
`aPlusProNum`	`integer`	opcional	Número de imágenes premium A+, de 0 a 12. Por defecto a 0. Ejemplo: 0
`aPlusHasPhone`	`boolean`	opcional	Si la salida A+ incluye diseños de pantalla de teléfono. Ejemplo: false
`aPlusAspectRatio`	`string`	opcional	A+ relación de aspecto de salida. Valores soportados: 16:9, 9:16, 1:1, 1:3.7. Ejemplo: 1:1
`modelTypeNum`	`integer`	opcional	Número de imágenes de modelos, de 0 a 12. Por defecto a 0. Ejemplo: 0
`insTypeNum`	`integer`	opcional	Número de imágenes de estilo social, de 0 a 12. Por defecto a 0. Ejemplo: 0
`sellerTypeNum`	`integer`	opcional	Número de imágenes de puntos de venta, de 0 a 12. Defaults a 0. Ejemplo: 0
`sizeTypeNum`	`integer`	opcional	Número de imágenes de tamaño-información, de 0 a 12. Defaults to 0. Ejemplo: 0
`whiteTypeNum`	`integer`	opcional	Número de imágenes en blanco, de 0 a 12. Por defecto a 0. Ejemplo: 0
`aPlusStyles`	`array`	opcional	Opciones de entradas de estilo A+. Cada elemento puede contener un id de estilo guardado o un mensaje personalizado. Ejemplo: [ { "id": 1 }, { "prompt": "clean editorial layout" } ]
`pointStyles`	`array`	opcional	Entradas opcionales de estilo de punto de venta. Cada elemento puede contener un identificador de estilo guardado o un prompt personalizado. Ejemplo: [ { "id": 2 }, { "prompt": "minimal feature callouts" } ]

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.

Paso 1 de 2 · Conectar tu cliente MCP

MCP

Usa el endpoint MCP cuando un agente necesite descubrir y llamar a herramientas de API con JSON-RPC.

GET /mcp/legacy

POST /mcp/legacy
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Content-Type: application/json

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_ai_apparel_image_set_photography_v3",
    "arguments": {
      "aPlusAspectRatio": "1:1",
      "aPlusHasPhone": false,
      "aPlusNum": 0,
      "aPlusProNum": 0,
      "aPlusStyles": [
        {
          "id": 1
        },
        {
          "prompt": "clean editorial layout"
        }
      ],
      "aspectRatio": "1:1",
      "brandKey": "{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}",
      "imageList": [
        "https://example.com/product.jpg"
      ],
      "insTypeNum": 0,
      "isExactScene": true,
      "isExtractPrePoint": false,
      "modelAndSceneInfo": "{\"model\":\"female adult\",\"scene\":\"studio\"}",
      "modelImageUrl": "https://example.com/model-reference.jpg",
      "modelTypeNum": 0,
      "noText": false,
      "pointStyles": [
        {
          "id": 2
        },
        {
          "prompt": "minimal feature callouts"
        }
      ],
      "provider": "BANANA_2",
      "quality": "medium",
      "replaceLibraryId": 1002,
      "resolution": "2K",
      "sceneImageUrl": "https://example.com/scene.jpg",
      "sellerPoint": "Lightweight breathable summer dress",
      "sellerTypeNum": 0,
      "sensitiveLibraryId": 1001,
      "sizeTypeNum": 0,
      "whiteTypeNum": 0
    }
  }
}

Prueba en línea

Ejecuta la API actual con tu clave de API y la carga JSON. Las pruebas en línea usan el entorno de API configurado de este sitio; el Endpoint y los ejemplos que puedes copiar usan la dirección de integración pública.

Crear una imagen

Imágenes de referencia*Obligatorio

JPG, PNG, WEBP · Hasta 5 imágenes · 10 MB cada uno · 384–4096 px por lado

0/5

Referencia del modeloOpcional

Imagen de referencia del modelo opcional URL.

JPG, PNG, WEBP · 1 imagen · 20 MB

0/1

Referencia de escenaOpcional

Imagen de referencia opcional de la escena URL.

JPG, PNG, WEBP · 1 imagen · 20 MB

0/1

Ajustes de imagen

Modelo

Modelo de imagen. Por defecto BANANA_2. Valores soportados: BANANA_2, BANANA_2_LITE, BANANA_PRO, WAN2_7, SEEDREAM5_PRO, GPT_2_IMAGE.

Argumentos de venta del producto*

Puntos de venta de productos, hasta 2500 caracteres. Se requiere cuando isExtractPrePoint es falso.

Extraer los argumentos de venta automáticamente

Si extraer automáticamente puntos de venta. Por defecto a false. Cuando false, sellerPoint es necesario.

Resolución

2K (fija)

Relación de aspecto

Evitar texto

Si las imágenes generadas deben evitar el texto.

Configuración de marca

Información opcional de marca serializada como un JSON string. Teclas soportadas: brandColor, fontStyle, salesRegion, idioma, plataforma, customSettings.

Calidad

GPT Calidad de imagen solamente. Valores soportados: bajo, medio o alto.

Biblioteca de palabras sensibles

Opcional de la biblioteca de palabras sensibles ID utilizado para la pantalla de copia generada.

Biblioteca de palabras de sustitución

ID opcional de biblioteca de palabras de reemplazo utilizado para reescribir la copia generada.

Ajustar la escena con precisión

Si se debe comparar la escena proporcionada de cerca. Por defecto a true.

Detalles del modelo y de la escena

Información sobre modelos e escenas seriada como un JSON texto estructurado de cadena o conciso.

Imágenes A+ estándar

Número de imágenes estándar A+, de 0 a 12. Por defecto a 0.

Imágenes A+ Premium

Número de imágenes premium A+, de 0 a 12. Por defecto a 0.

Incluir diseños para móvil

Si la salida A+ incluye diseños de pantalla de teléfono.

Relación de aspecto de A+

A+ relación de aspecto de salida. Valores soportados: 16:9, 9:16, 1:1, 1:3.7.

Imágenes del modelo

Número de imágenes de modelos, de 0 a 12. Por defecto a 0.

Imágenes para redes sociales

Número de imágenes de estilo social, de 0 a 12. Por defecto a 0.

Imágenes de argumentos de venta

Número de imágenes de puntos de venta, de 0 a 12. Defaults a 0.

Imágenes de guía de tallas

Número de imágenes de tamaño-información, de 0 a 12. Defaults to 0.

Imágenes con fondo blanco

Número de imágenes en blanco, de 0 a 12. Por defecto a 0.

Estilos de A+

Opciones de entradas de estilo A+. Cada elemento puede contener un id de estilo guardado o un mensaje personalizado.

Estilos de argumentos de venta

Entradas opcionales de estilo de punto de venta. Cada elemento puede contener un identificador de estilo guardado o un prompt personalizado.

Las claves de API requieren una suscripción activa. Los créditos de prueba no incluyen acceso a la API. Ver planes.

Estimación de uso no disponible

Los créditos finales se muestran junto al resultado.

Vista previa

Aquí aparecerá tu imagen

Generaciones recientes

Guardadas en este navegador durante 24 horas

Tus generaciones aparecerán aquí.

Probar con una clave API o MCP

Pruébalo

Envía una solicitud real con el mismo contrato que se muestra en la referencia.

Endpoint

/ai/apparelImageSetPhotographyV3

Task result endpoint

/ai/apparelImageSetPhotographyV3/tasks/{taskId}

Método de MCP

nexscope_ai_apparel_image_set_photography_v3

Clave de API*

Contenido JSON*

cURL

curl -X POST \
  https://api.nexscope.ai/ai/apparelImageSetPhotographyV3 \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "aPlusAspectRatio": "1:1", "aPlusHasPhone": false, "aPlusNum": 0, "aPlusProNum": 0, "aPlusStyles": [ { "id": 1 }, { "prompt": "clean editorial layout" } ], "aspectRatio": "1:1", "brandKey": "{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}", "imageList": [], "insTypeNum": 0, "isExactScene": true, "isExtractPrePoint": false, "modelAndSceneInfo": "{\"model\":\"female adult\",\"scene\":\"studio\"}", "modelImageUrl": "", "modelTypeNum": 0, "noText": false, "pointStyles": [ { "id": 2 }, { "prompt": "minimal feature callouts" } ], "provider": "BANANA_2", "quality": "medium", "replaceLibraryId": 1002, "resolution": "2K", "sceneImageUrl": "", "sellerPoint": "Lightweight breathable summer dress", "sellerTypeNum": 0, "sensitiveLibraryId": 1001, "sizeTypeNum": 0, "whiteTypeNum": 0 }'

Respuesta

Todavía no hay respuesta. Ejecuta la solicitud para ver la respuesta aquí.

Resultado de la tarea

Los resultados se consultan automáticamente después de ejecutar la solicitud. También puedes introducir un ID de tarea y consultarlo manualmente; los recursos completados usan URL de Nexscope y muestran los créditos realmente cobrados.

Task ID

Respuesta del resultado

No task result yet. Query the task to see the generated output here.

API relacionadas

AI Background Generator

Create product or lifestyle scene images from text prompts and optional reference images.

AI Clothes Changer for Tops & Bottoms

Dress a model image with upper and/or lower garment assets, supporting optional masks and original garment references.

AI Hand Repair

Improve hand appearance in generated model or lifestyle images.

AI Model Pose Generation

Generate model pose variations from an input image and either a pose prompt or posture reference image.