API y desarrolladores

API y MCP

Integra FourierCompress desde código: API REST y servidor MCP.

Puedes usar FourierCompress desde tus propios programas con la API REST o desde tu asistente de código con el servidor MCP.

Aviso
la API requiere un token de acceso. Los tokens se generan en la sección Tokens API de tu cuenta y solo se muestran una vez.

Autenticación

Genera un token en la sección Tokens API de tu cuenta (formato fc_live_...) y envíalo en la cabecera Authorization de cada request:

bash
Authorization: Bearer fc_live_TU_TOKEN
Nota
los tokens se almacenan solo como hash (SHA-256). Si pierdes el valor, revócalo y genera uno nuevo.

Endpoints principales

Base URL: https://api.fouriercompress.com

POST/v1/jobs/— envía un trabajo (multipart, campo files).
GET/v1/jobs/<id>/— estado y resultados de un trabajo.
POST/v1/jobs/<id>/cancel/— cancela y reembolsa.
GET/v1/quota/— plan, créditos y uso de la API.
GET/v1/tools/— catálogo de herramientas disponibles.
GET/v1/schema/— documentación OpenAPI (schema + Swagger).

Ejemplo con curl

bash
curl -X POST https://api.fouriercompress.com/v1/jobs/ \
  -H "Authorization: Bearer fc_live_TU_TOKEN" \
  -F "[email protected]" \
  -F "tool=fft_compress" \
  -F "params={\"quality\":78}"

Idempotency-Key

Envía la cabecera Idempotency-Key para evitar cobros dobles si reintentas una request. La clave se guarda en Redis durante 24 horas; un reintento con la misma clave devuelve el resultado original sin volver a cobrar.

Límites

Cada plan tiene una cuota mensual de llamadas API. La respuesta incluye las cabeceras X-RateLimit-*, y cuando se alcanza el límite el servidor responde HTTP 429 con Retry-After.

Servidor MCP

Instala el paquete fouriercompress-mcp y configúralo con FOURIERCOMPRESS_API_TOKEN. Expone 9 herramientas:

  • list_tools — catálogo de herramientas y costos.
  • get_quota — créditos y límites de tu cuenta.
  • get_job — estado de un trabajo.
  • compress_image — compresión FFT.
  • convert_format — conversión de formatos.
  • resize_image — redimensionar y recortar.
  • remove_background — eliminar fondo.
  • ocr_extract — extraer texto.
  • pdf_to_images — convertir PDF a imágenes.

El costo en créditos está declarado en la descripción de cada herramienta.