Referencia de la API de Morfran

URL base https://api.morfran.com. Cada solicitud envía tu clave en el encabezado X-API-Key. Crea claves en tu panel. El esquema completo está en /openapi.json (OpenAPI 3).

Autenticación con X-API-Key

curl https://api.morfran.com/v1/effects \
  -H "X-API-Key: $MORFRAN_KEY"

Créditos y errores

Solo se descuentan créditos por imágenes terminadas. Los errores se devuelven como JSON con un código de estado y un mensaje.

EstadoSignificadoQué hacer
401Clave API ausente o incorrectaRevisa el encabezado X-API-Key
402Créditos insuficientesCompra un paquete de créditos
422No se encontró ninguna cara en la fotoEnvía una foto con una cara bien visible

GET /v1/effects

Lista los efectos que puedes aplicar: slug, nombre, categoría e imagen de portada. Gratis.

curl https://api.morfran.com/v1/effects \
  -H "X-API-Key: $MORFRAN_KEY"

POST /v1/effects/{slug}

Aplica un efecto a una foto y devuelve un enlace de CDN. 11 créditos con "quality": "standard", 29 con "pro".

CampoTipoNotas
slugpathDe GET /v1/effects, por ejemplo 80s-yearbook
image_urlstringJPG, PNG o WebP público
qualitystringstandard (predeterminado) o pro
curl -X POST https://api.morfran.com/v1/effects/80s-yearbook \
  -H "X-API-Key: $MORFRAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url":"https://…/me.jpg","quality":"standard"}'

{ "status": "done",
  "result_url": "https://cdn.morfran.com/…",
  "credits_used": 11,
  "credits_left": 39 }

POST /v1/face-swap

Pone la cara de SourceImageUrl en TargetImageUrl. 5 créditos. La versión de grupo, /v1/face-swap/group, cambia hasta ocho caras (MaxFaces) por 10 créditos. Los trabajos largos devuelven un id de tarea; lee el resultado con GET /v1/face-swap/{taskId}.

curl -X POST https://api.morfran.com/v1/face-swap \
  -H "X-API-Key: $MORFRAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"SourceImageUrl":"https://…/face.jpg","TargetImageUrl":"https://…/photo.jpg"}'

POST /v1/transcribe

Convierte la voz de un archivo de audio o video en texto con segmentos con marca de tiempo. Envía media_url (o media_base64 con media_type). Opcional: language como pista (ISO 639-1), translate_to para una traducción en la misma llamada, timestamps (true por defecto).

2 créditos por minuto iniciado, mínimo un minuto; una traducción suma 1 crédito por minuto. Archivos de hasta 10 minutos y 50 MB. Sin voz detectada: 422 y no se cobra.

curl -X POST https://api.morfran.com/v1/transcribe \
  -H "X-API-Key: $MORFRAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"media_url":"https://…/interview.mp3","translate_to":"en"}'

{ "success": true,
  "language": "de",
  "duration_seconds": 184,
  "billed_minutes": 4,
  "credits_used": 12,
  "text": "…",
  "segments": [{ "start": 0.0, "end": 4.2, "text": "…" }],
  "translation": { "language": "en", "text": "…", "segments": [ … ] } }

POST /v1/tts

Convierte texto (hasta 4.000 caracteres, idioma detectado automáticamente) en voz natural y devuelve un enlace WAV. Elige una voice de GET /v1/tts/voices (30 voces, gratis), la quality standard o pro y, si quieres, un style de lectura como "alegremente".

5 créditos por cada 1.000 caracteres iniciados en Standard, 7 en Pro. Las solicitudes fallidas no se cobran. El archivo de audio se guarda una hora.

curl -X POST https://api.morfran.com/v1/tts \
  -H "X-API-Key: $MORFRAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Welcome to Morfran.","voice":"Kore","quality":"standard"}'

{ "success": true,
  "audio_url": "https://cdn.morfran.com/…/speech.wav",
  "duration_seconds": 2.1,
  "characters": 19,
  "billed_units": 1,
  "credits_used": 5 }

POST /v1/ocr

Lee el texto de una imagen o un PDF (hasta 20 páginas y 20 MB). Envía image_url o image_base64; JPEG, PNG, WebP, HEIC y PDF se detectan a partir del propio archivo. format es text (por defecto) o markdown, que conserva las tablas. language es una pista opcional.

1 crédito por cada 10 páginas iniciadas; una imagen cuenta como una página. Las páginas de un PDF se separan con una línea ---. Las solicitudes fallidas no se cobran.

curl -X POST https://api.morfran.com/v1/ocr \
  -H "X-API-Key: $MORFRAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url":"https://…/invoice.pdf","format":"markdown"}'

{ "success": true,
  "format": "markdown",
  "pages": 3,
  "text": "…",
  "credits_used": 1 }

POST /v1/background-removal

Quita el fondo de una foto y devuelve un PNG transparente del tamaño de tu imagen (lado más largo hasta 4.096 px). Envía image_url o image_base64 (JPEG, PNG, WebP o HEIC, hasta 20 MB).

1 crédito por imagen. Las solicitudes fallidas no se cobran. El archivo resultante se guarda una hora.

curl -X POST https://api.morfran.com/v1/background-removal \
  -H "X-API-Key: $MORFRAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url":"https://…/product.jpg"}'

{ "success": true,
  "image_url": "https://cdn.morfran.com/…/cutout.png",
  "width": 2048,
  "height": 1536,
  "credits_used": 1 }

GET /v1/credits/balance

Tu saldo de créditos actual. Gratis.

curl https://api.morfran.com/v1/credits/balance \
  -H "X-API-Key: $MORFRAN_KEY"

Servidor MCP para agentes de IA

Usa Morfran desde Claude, Cursor o cualquier agente compatible con el Model Context Protocol. El servidor está en https://api.morfran.com/mcp (Streamable HTTP) y usa la misma clave API y los mismos precios en créditos que la API REST; los trabajos fallidos no se cobran.

Herramientas: list_effects, apply_effect (slug, image_url, quality), get_effect_task, face_swap (source_image_url, target_image_url), get_face_swap_result, detect_faces, get_credit_balance.

claude mcp add --transport http morfran https://api.morfran.com/mcp \
  --header "X-API-Key: $MORFRAN_KEY"

Otros clientes: añade un servidor MCP HTTP con esa URL y el encabezado X-API-Key (o Authorization: Bearer <key>).

Publicado en el MCP Registry oficial como com.morfran/morfran.

Inmobiliaria (próximamente)

El home staging virtual y los videos de anuncio de 8 segundos (118 créditos por video) aún no están en la API. Aparecerán en el esquema OpenAPI cuando estén disponibles.