Morfran-API-Referenz

Basis-URL https://api.morfran.com. Jede Anfrage sendet deinen Key im Header X-API-Key. Keys erstellst du in deinem Dashboard. Das vollständige Schema findest du unter /openapi.json (OpenAPI 3).

Authentifizierung mit X-API-Key

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

Credits und Fehler

Credits werden nur für fertige Bilder abgebucht. Fehler kommen als JSON mit Statuscode und Meldung zurück.

StatusBedeutungWas tun
401API-Key fehlt oder ist falschPrüfe den Header X-API-Key
402Nicht genug CreditsKauf ein Credit-Paket
422Kein Gesicht im Foto gefundenSende ein Foto mit einem klar erkennbaren Gesicht

GET /v1/effects

Listet die Effekte auf, die du anwenden kannst: Slug, Name, Kategorie und Titelbild. Kostenlos.

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

POST /v1/effects/{slug}

Wendet einen Effekt auf ein Foto an und gibt einen CDN-Link zurück. 11 Credits mit "quality": "standard", 29 mit "pro".

FeldTypHinweise
slugpathAus GET /v1/effects, zum Beispiel 80s-yearbook
image_urlstringÖffentliches JPG, PNG oder WebP
qualitystringstandard (Voreinstellung) oder 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

Setzt das Gesicht aus SourceImageUrl in TargetImageUrl ein. 5 Credits. Die Gruppenversion, /v1/face-swap/group, tauscht bis zu acht Gesichter (MaxFaces) für 10 Credits. Lange Aufträge geben eine Task-ID zurück; das Ergebnis liest du über 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

Wandelt Sprache in einer Audio- oder Videodatei in Text mit Zeitstempel-Segmenten um. Sende media_url (oder media_base64 mit media_type). Optional: language als Hinweis (ISO 639-1), translate_to für eine Übersetzung im selben Aufruf, timestamps (Standard true).

2 Credits pro angefangene Minute, mindestens eine Minute; eine Übersetzung kostet zusätzlich 1 Credit pro Minute. Dateien bis 10 Minuten und 50 MB. Keine Sprache gefunden: 422 und keine Kosten.

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

Wandelt Text (bis zu 4.000 Zeichen, Sprache wird automatisch erkannt) in natürliche Sprache um und gibt einen WAV-Link zurück. Wähle eine voice aus GET /v1/tts/voices (30 Stimmen, kostenlos), quality standard oder pro und optional einen Vorlese-style wie "fröhlich".

5 Credits pro angefangene 1.000 Zeichen in Standard, 7 in Pro. Fehlgeschlagene Anfragen werden nicht berechnet. Die Audiodatei wird eine Stunde lang gespeichert.

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

Liest den Text in einem Bild oder PDF (bis 20 Seiten und 20 MB). Sende image_url oder image_base64; JPEG, PNG, WebP, HEIC und PDF werden an der Datei selbst erkannt. format ist text (Standard) oder markdown, das Tabellen erhält. language ist ein optionaler Hinweis.

1 Credit pro angefangene 10 Seiten; ein Bild zählt als eine Seite. Die Seiten eines PDFs sind durch eine Zeile --- getrennt. Fehlgeschlagene Anfragen kosten nichts.

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

Entfernt den Hintergrund eines Fotos und gibt ein transparentes PNG in der Größe deines Bildes zurück (längste Seite bis 4.096 px). Sende image_url oder image_base64 (JPEG, PNG, WebP oder HEIC, bis 20 MB).

1 Credit pro Bild. Fehlgeschlagene Anfragen kosten nichts. Die Ergebnisdatei wird eine Stunde lang gespeichert.

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

Dein aktuelles Credit-Guthaben. Kostenlos.

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

MCP-Server für KI-Agenten

Nutze Morfran aus Claude, Cursor oder jedem Agenten, der das Model Context Protocol spricht. Der Server liegt unter https://api.morfran.com/mcp (Streamable HTTP) und verwendet denselben API-Key und dieselben Credit-Preise wie die REST-API; fehlgeschlagene Aufträge werden nicht berechnet.

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

Andere Clients: Füge einen HTTP-MCP-Server mit dieser URL und dem Header X-API-Key (oder Authorization: Bearer <key>) hinzu.

Im offiziellen MCP Registry gelistet als com.morfran/morfran.

Immobilien (demnächst)

Virtuelles Home Staging und 8-sekündige Exposé-Videos (118 Credits pro Video) sind noch nicht in der API. Sie erscheinen im OpenAPI-Schema, sobald sie live gehen.