Referência da API Morfran

URL base https://api.morfran.com. Toda requisição envia sua chave no header X-API-Key. Crie chaves no seu painel. O schema completo está em /openapi.json (OpenAPI 3).

Autenticação com X-API-Key

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

Créditos e erros

Créditos são cobrados somente por imagens concluídas. Erros voltam como JSON com um código de status e uma mensagem.

StatusSignificadoO que fazer
401Chave de API ausente ou incorretaConfira o header X-API-Key
402Créditos insuficientesCompre um pacote de créditos
422Nenhum rosto encontrado na fotoEnvie uma foto com um rosto nítido

GET /v1/effects

Lista os efeitos que você pode aplicar: slug, nome, categoria e imagem de capa. Grátis.

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

POST /v1/effects/{slug}

Aplica um efeito a uma foto e retorna um link de CDN. 11 créditos com "quality": "standard", 29 com "pro".

CampoTipoObservações
slugpathVindo de GET /v1/effects, por exemplo 80s-yearbook
image_urlstringJPG, PNG ou WebP público
qualitystringstandard (padrão) ou 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

Troca o rosto de SourceImageUrl para TargetImageUrl. 5 créditos. A versão para grupos, /v1/face-swap/group, troca até oito rostos (MaxFaces) por 10 créditos. Trabalhos longos retornam um id de tarefa; leia o resultado em 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

Transforma a fala de um arquivo de áudio ou vídeo em texto com segmentos com marcação de tempo. Envie media_url (ou media_base64 com media_type). Opcional: language como dica (ISO 639-1), translate_to para uma tradução na mesma chamada, timestamps (padrão true).

2 créditos por minuto iniciado, no mínimo um minuto; uma tradução adiciona 1 crédito por minuto. Arquivos de até 10 minutos e 50 MB. Nenhuma fala encontrada: 422 e nada é cobrado.

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

Transforma texto (até 4.000 caracteres, idioma detectado automaticamente) em fala natural e retorna um link WAV. Escolha uma voice em GET /v1/tts/voices (30 vozes, grátis), a quality standard ou pro e, se quiser, um style de leitura como "alegremente".

5 créditos a cada 1.000 caracteres iniciados no Standard, 7 no Pro. Solicitações com falha não são cobradas. O arquivo de áudio fica guardado por uma 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

Lê o texto de uma imagem ou de um PDF (até 20 páginas e 20 MB). Envie image_url ou image_base64; JPEG, PNG, WebP, HEIC e PDF são detectados pelo próprio arquivo. format é text (padrão) ou markdown, que mantém as tabelas. language é uma dica opcional.

1 crédito a cada 10 páginas iniciadas; uma imagem conta como uma página. As páginas de um PDF são separadas por uma linha ---. Solicitações com falha não são cobradas.

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

Remove o fundo de uma foto e devolve um PNG transparente no tamanho da sua imagem (lado maior até 4.096 px). Envie image_url ou image_base64 (JPEG, PNG, WebP ou HEIC, até 20 MB).

1 crédito por imagem. Solicitações com falha não são cobradas. O arquivo do resultado fica guardado por uma 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

Seu saldo atual de créditos. Grátis.

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

Servidor MCP para agentes de IA

Use a Morfran a partir do Claude, do Cursor ou de qualquer agente que fale o Model Context Protocol. O servidor fica em https://api.morfran.com/mcp (Streamable HTTP) e usa a mesma chave de API e os mesmos preços em créditos da API REST; trabalhos que falham não são cobrados.

Ferramentas: 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"

Outros clientes: adicione um servidor MCP HTTP com essa URL e o header X-API-Key (ou Authorization: Bearer <key>).

Listado no MCP Registry oficial como com.morfran/morfran.

Imóveis (em breve)

Decoração virtual e vídeos de anúncio de 8 segundos (118 créditos por vídeo) ainda não estão na API. Eles vão aparecer no schema OpenAPI quando forem lançados.