Documentos para desarrolladores

API neofashion.ai

Genere fotografías de productos, videos e imágenes de campañas mediante programación. La misma API que utiliza la plataforma, disponible para su integración desde el primer día.

URL base

Todos los endpoints están versionados bajo /api/v1 y se sirven mediante HTTPS. La aplicación web utiliza los mismos endpoints; no hay rutas privadas exclusivas de la UI.

Base URL

https://app.neofashion.ai/api/v1

Autenticación

Cada solicitud se autentica con un token bearer. Se admiten dos tipos de token, y ambos se resuelven en el mismo contexto de espacio de trabajo.

Clave API

Para integraciones de servidor a servidor. Crea claves en los ajustes del espacio de trabajo; cada clave tiene alcance para tu espacio de trabajo. Disponible en los planes Enterprise.

Authorization: Bearer ne_live_xxxxxxxxxxxx

JWT de sesión

Emitido por la aplicación web al iniciar sesión. Lo utiliza la propia interfaz de la plataforma y es adecuado para llamadas de corta duración con alcance de usuario.

Authorization: Bearer eyJhbGci...

Todas las solicitudes incluyen un campo source (ui o api) y un api_key_id opcional para fines de auditoría y facturación.

Endpoints

Los endpoints principales de generación y consulta. Los trabajos de larga duración, como la generación de vídeo y por lotes, se ejecutan de forma asíncrona: consulta la generación o sigue las actualizaciones de estado en la aplicación.

Método	Endpoint	Descripción
POST	`/api/v1/generate/image`	Generar una única foto de producto
POST	`/api/v1/generate/video`	Generar un breve vídeo de moda
POST	`/api/v1/generate/bulk`	Trabajo de generación por lotes asíncrono
POST	`/api/v1/sketch-to-photo`	Boceto → foto de calidad de campaña
GET	`/api/v1/generations`	Listar generaciones (paginado)
GET	`/api/v1/generations/:id`	Detalle y estado de la generación
GET	`/api/v1/credits/balance`	Saldo de créditos actual
GET	`/api/v1/personas`	Personas del espacio de trabajo
GET	`/api/v1/models`	API de ADN de marca / personas

Formato de respuesta

Cada endpoint devuelve la misma envoltura: data, meta (créditos utilizados, créditos restantes, id de solicitud) y error. Se establece exactamente uno: data o error.

Correcto

{
  "data": {
    "id": "gen_01hwz...",
    "status": "completed",
    "output_url": "https://...",
    "credits_used": 50
  },
  "meta": {
    "credits_used": 50,
    "credits_remaining": 7950,
    "request_id": "req_01hwz..."
  },
  "error": null
}

Error

{
  "data": null,
  "meta": { "request_id": "req_01hwz..." },
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Credit balance too low for this operation.",
    "details": { "required": 50, "available": 20 }
  }
}

Límites de velocidad

Los límites se aplican por espacio de trabajo. Cuando se supera un límite, la API devuelve 429 RATE_LIMITED con una cabecera retry-after.

Plan	Límite de velocidad
Enterprise	`Personalizado: acordado por contrato, con SLA`

Códigos de error

Los errores se devuelven en el campo error, con un code estable, un mensaje legible y detalles estructurados.

Código	HTTP	Significado
`INSUFFICIENT_CREDITS`	402	El saldo del espacio de trabajo es demasiado bajo para la operación solicitada. Recarga o mejora tu plan para continuar.
`UNAUTHORIZED`	401	El token falta, ha caducado o no es válido.
`FORBIDDEN`	403	El token es válido, pero el plan o rol no permite esta operación.
`NOT_FOUND`	404	El recurso no existe o pertenece a otro espacio de trabajo.
`RATE_LIMITED`	429	Demasiadas solicitudes; vuelve a intentarlo tras el intervalo indicado.
`PROVIDER_ERROR`	502	Ha fallado un proveedor de IA externo. Los créditos se reembolsan y la solicitud puede volver a intentarse.

Acceso a la API

¿Listo para integrar?

El acceso a la API está disponible en los planes Enterprise, con onboarding guiado y un SLA. Reserva una demo y revisaremos tu integración.

Reservar una demo Ver precios