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.
| Status | Meaning | What to do |
|---|---|---|
401 | Missing or wrong API key | Check the X-API-Key header |
402 | Not enough credits | Buy a credit pack |
422 | No face found in the photo | Send 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".
| Field | Type | Notes |
|---|---|---|
slug | path | From GET /v1/effects, for example 80s-yearbook |
image_url | string | Public JPG, PNG or WebP |
quality | string | standard (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.