Morfran API reference

Base URL https://api.morfran.com. Every request sends your key in the X-API-Key header. Create keys in your dashboard. The full schema is at /openapi.json (OpenAPI 3).

Authentication with X-API-Key

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

Credits and errors

Credits are taken only for finished images. Errors come back as JSON with a status code and a message.

StatusMeaningWhat to do
401Missing or wrong API keyCheck the X-API-Key header
402Not enough creditsBuy a credit pack
422No face found in the photoSend a photo with one clear face

POST /v1/effects/{slug}

Applies one effect to one photo and returns a CDN link. 11 credits with "quality": "standard", 29 with "pro".

FieldTypeNotes
slugpathFrom GET /v1/effects, for example 80s-yearbook
image_urlstringPublic JPG, PNG or WebP
qualitystringstandard (default) or 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

Swaps the face from SourceImageUrl into TargetImageUrl. 5 credits. The group version, /v1/face-swap/group, changes up to eight faces (MaxFaces) for 10 credits. Long jobs return a task id; read the result from 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"}'

Real estate (coming soon)

Virtual staging and 8-second listing videos (118 credits per video) are not in the API yet. They will appear in the OpenAPI schema when they go live.