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.
| Status | Bedeutung | Was tun |
|---|---|---|
401 | API-Key fehlt oder ist falsch | Prüfe den Header X-API-Key |
402 | Nicht genug Credits | Kauf ein Credit-Paket |
422 | Kein Gesicht im Foto gefunden | Sende 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".
| Feld | Typ | Hinweise |
|---|---|---|
slug | path | Aus GET /v1/effects, zum Beispiel 80s-yearbook |
image_url | string | Öffentliches JPG, PNG oder WebP |
quality | string | standard (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.