Morphix API

Integra la conversión, el redimensionado, el recorte y la eliminación de metadatos en tus aplicaciones con nuestra API REST.

Autenticación

Todas las peticiones de la API requieren una clave API enviada en la cabecera Authorization.

curl -X POST https://morphix.tools/api/v1/convert \
  -H "Authorization: Bearer mk_live_your_api_key_here" \
  -F "file=@photo.jpg" \
  -F "format=webp" \
  -F "quality=80"

Crea una clave API desde tu página de cuenta

Base URL

https://morphix.tools/api/v1

Endpoints

GET `/api/v1/me`

Devuelve el plan, la cuota diaria, los límites de tamaño y de velocidad del usuario autenticado. Sin parámetros.

{
  "success": true,
  "data": {
    "user":  { "email": "you@example.com", "plan": "pro", "is_pro": true, "subscription_ends_at": null },
    "quota": { "is_unlimited": true, "daily_used": 0, "daily_remaining": null, "daily_max": null,
               "max_file_size_mb": 50, "max_concurrent": 999 },
    "rate_limit": { "requests_per_second": 10 }
  }
}

POST `/api/v1/convert`

Convierte una imagen a otro formato.

Parámetro	Tipo	Requerido	Descripción
file	file	Sí	Archivo de imagen (JPG, PNG, WebP, AVIF)
format	string	Sí	webp, avif, jpg, png
quality	int	No	1-100 (Por defecto: 80)

POST `/api/v1/crop`

Recorta una región rectangular de una imagen.

Parámetro	Tipo	Requerido	Descripción
file	file	Sí	Archivo de imagen (JPG, PNG, WebP, AVIF)
x	int	Sí	Desplazamiento izquierdo en píxeles
y	int	Sí	Desplazamiento superior en píxeles
width	int	Sí	Anchura del recorte en píxeles
height	int	Sí	Altura del recorte en píxeles

POST `/api/v1/resize`

Redimensiona una imagen a dimensiones específicas.

Parámetro	Tipo	Requerido	Descripción
file	file	Sí	Archivo de imagen (JPG, PNG, WebP, AVIF)
width	int	No*	1-12000 px
height	int	No*	1-12000 px
keep_aspect_ratio	bool	No	Por defecto: true

* Se requiere al menos un ancho o un alto.

POST `/api/v1/remove-metadata`

Elimina metadatos EXIF, ICC y otros de una imagen.

Parámetro	Tipo	Requerido	Descripción
file	file	Sí	Archivo de imagen (JPG, PNG, WebP, AVIF)

Formato de respuesta

Las respuestas correctas devuelven un objeto JSON con la URL de descarga:

{
  "success": true,
  "data": {
    "uuid": "a1b2c3d4e5f6...",
    "format": "webp",
    "filename": "photo.webp",
    "size": 45230,
    "download_url": "https://morphix.tools/download/a1b2c3.../webp/photo.webp"
  }
}

Las respuestas de error incluyen un código legible:

{
  "success": false,
  "error": {
    "code": "DAILY_LIMIT_REACHED",
    "message": "Daily limit reached. 0 conversion(s) remaining today."
  }
}

Códigos de error

Código	HTTP	Descripción
INVALID_PARAMETERS	422	Parámetros faltantes o inválidos.
UNSUPPORTED_FORMAT	422	El formato del archivo de entrada no es compatible.
FILE_TOO_LARGE	422	El archivo supera el tamaño máximo.
DAILY_LIMIT_REACHED	429	Cuota diaria de conversiones agotada (plan gratuito).
RATE_LIMIT_EXCEEDED	429	Demasiadas peticiones por segundo (plan Pro).
CONVERSION_FAILED	500	El procesamiento de la imagen ha fallado.

Límites de velocidad

Plan	Límite diario	Límite de velocidad	Tamaño máximo del archivo
Free	10 conversiones/día	-	10 MB
Pro	Ilimitado	10 req/s	10 MB

Las cuotas diarias se comparten entre uso web y uso API.

Empezar

Crea tu clave API y empieza a integrar Morphix en tu flujo de trabajo.

Crear una clave API