Référence de l'API Morfran
URL de base https://api.morfran.com. Chaque requête envoie votre clé dans l'en-tête X-API-Key. Créez vos clés dans votre tableau de bord. Le schéma complet se trouve sur /openapi.json (OpenAPI 3).
Authentification avec X-API-Key
curl https://api.morfran.com/v1/effects \ -H "X-API-Key: $MORFRAN_KEY"
Crédits et erreurs
Les crédits ne sont débités que pour les images terminées. Les erreurs sont renvoyées en JSON avec un code de statut et un message.
| Statut | Signification | Que faire |
|---|---|---|
401 | Clé API manquante ou incorrecte | Vérifiez l'en-tête X-API-Key |
402 | Crédits insuffisants | Achetez un pack de crédits |
422 | Aucun visage trouvé sur la photo | Envoyez une photo avec un visage bien visible |
GET /v1/effects
Liste les effets que vous pouvez appliquer : slug, nom, catégorie et image de couverture. Gratuit.
curl https://api.morfran.com/v1/effects \ -H "X-API-Key: $MORFRAN_KEY"
POST /v1/effects/{slug}
Applique un effet à une photo et renvoie un lien CDN. 11 crédits avec "quality": "standard", 29 avec "pro".
| Champ | Type | Remarques |
|---|---|---|
slug | path | Issu de GET /v1/effects, par exemple 80s-yearbook |
image_url | string | JPG, PNG ou WebP public |
quality | string | standard (par défaut) 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
Remplace le visage de TargetImageUrl par celui de SourceImageUrl. 5 crédits. La version de groupe, /v1/face-swap/group, change jusqu'à huit visages (MaxFaces) pour 10 crédits. Les tâches longues renvoient un identifiant de tâche ; lisez le résultat sur 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
Transforme la parole d'un fichier audio ou vidéo en texte, avec des segments horodatés. Envoyez media_url (ou media_base64 avec media_type). Facultatif : language comme indication (ISO 639-1), translate_to pour une traduction dans le même appel, timestamps (true par défaut).
2 crédits par minute entamée, une minute minimum ; une traduction ajoute 1 crédit par minute. Fichiers jusqu'à 10 minutes et 50 Mo. Aucune parole détectée : 422 et rien n'est facturé.
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
Transforme un texte (jusqu'à 4 000 caractères, langue détectée automatiquement) en voix naturelle et renvoie un lien WAV. Choisissez une voice dans GET /v1/tts/voices (30 voix, gratuit), la quality standard ou pro, et un style de lecture facultatif, par exemple "joyeusement".
5 crédits par tranche de 1 000 caractères entamée en Standard, 7 en Pro. Les requêtes échouées ne sont pas facturées. Le fichier audio est conservé une heure.
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
Lit le texte d'une image ou d'un PDF (jusqu'à 20 pages et 20 Mo). Envoyez image_url ou image_base64 ; JPEG, PNG, WebP, HEIC et PDF sont détectés d'après le fichier lui-même. format vaut text (par défaut) ou markdown, qui conserve les tableaux. language est une indication facultative.
1 crédit par tranche de 10 pages entamée ; une image compte pour une page. Les pages d'un PDF sont séparées par une ligne ---. Les requêtes échouées ne sont pas facturées.
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
Supprime l'arrière-plan d'une photo et renvoie un PNG transparent à la taille de votre image (côté le plus long jusqu'à 4 096 px). Envoyez image_url ou image_base64 (JPEG, PNG, WebP ou HEIC, jusqu'à 20 Mo).
1 crédit par image. Les requêtes échouées ne sont pas facturées. Le fichier de résultat est conservé une heure.
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
Votre solde de crédits actuel. Gratuit.
curl https://api.morfran.com/v1/credits/balance \ -H "X-API-Key: $MORFRAN_KEY"
Serveur MCP pour agents IA
Utilisez Morfran depuis Claude, Cursor ou tout agent compatible avec le Model Context Protocol. Le serveur se trouve sur https://api.morfran.com/mcp (Streamable HTTP) et utilise la même clé API et les mêmes prix en crédits que l'API REST ; les tâches échouées ne sont pas facturées.
Outils : 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"
Autres clients : ajoutez un serveur MCP HTTP avec cette URL et l'en-tête X-API-Key (ou Authorization: Bearer <key>).
Référencé dans le registre MCP officiel sous com.morfran/morfran.
Immobilier (bientôt disponible)
La mise en scène virtuelle et les vidéos d'annonce de 8 secondes (118 crédits par vidéo) ne sont pas encore dans l'API. Elles apparaîtront dans le schéma OpenAPI dès leur mise en ligne.