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.

StatutSignificationQue faire
401Clé API manquante ou incorrecteVérifiez l'en-tête X-API-Key
402Crédits insuffisantsAchetez un pack de crédits
422Aucun visage trouvé sur la photoEnvoyez 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".

ChampTypeRemarques
slugpathIssu de GET /v1/effects, par exemple 80s-yearbook
image_urlstringJPG, PNG ou WebP public
qualitystringstandard (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.