Referensi API Morfran

Base URL https://api.morfran.com. Setiap request mengirim key kamu di header X-API-Key. Buat key di dasbor kamu. Skema lengkapnya ada di /openapi.json (OpenAPI 3).

Autentikasi dengan X-API-Key

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

Kredit dan error

Kredit hanya dipotong untuk gambar yang selesai. Error dikembalikan sebagai JSON dengan kode status dan pesan.

StatusArtiYang perlu dilakukan
401API key tidak ada atau salahPeriksa header X-API-Key
402Kredit tidak cukupBeli paket kredit
422Tidak ada wajah di fotoKirim foto dengan satu wajah yang jelas

GET /v1/effects

Menampilkan daftar efek yang bisa kamu gunakan: slug, nama, kategori, dan gambar sampul. Gratis.

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

POST /v1/effects/{slug}

Menerapkan satu efek pada satu foto dan mengembalikan tautan CDN. 11 kredit dengan "quality": "standard", 29 dengan "pro".

FieldTipeCatatan
slugpathDari GET /v1/effects, misalnya 80s-yearbook
image_urlstringJPG, PNG, atau WebP publik
qualitystringstandard (default) atau 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

Menukar wajah dari SourceImageUrl ke TargetImageUrl. 5 kredit. Versi grup, /v1/face-swap/group, mengganti hingga delapan wajah (MaxFaces) seharga 10 kredit. Pekerjaan yang lama mengembalikan task id; baca hasilnya dari 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

Mengubah ucapan di file audio atau video menjadi teks dengan segmen bertanda waktu. Kirim media_url (atau media_base64 dengan media_type). Opsional: language sebagai petunjuk (ISO 639-1), translate_to untuk terjemahan dalam panggilan yang sama, timestamps (default true).

2 kredit per menit yang dimulai, minimal satu menit; terjemahan menambah 1 kredit per menit. File hingga 10 menit dan 50 MB. Tidak ada ucapan: 422 dan tidak dikenai biaya.

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

Mengubah teks (hingga 4.000 karakter, bahasa terdeteksi otomatis) menjadi suara alami dan mengembalikan tautan WAV. Pilih voice dari GET /v1/tts/voices (30 suara, gratis), quality standard atau pro, dan style pembacaan opsional seperti "dengan ceria".

5 kredit per 1.000 karakter yang dimulai di Standard, 7 di Pro. Permintaan yang gagal tidak dikenai biaya. File audio disimpan selama satu jam.

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

Membaca teks dalam gambar atau PDF (hingga 20 halaman dan 20 MB). Kirim image_url atau image_base64; JPEG, PNG, WebP, HEIC, dan PDF dikenali dari file itu sendiri. format berisi text (default) atau markdown, yang mempertahankan tabel. language adalah petunjuk opsional.

1 kredit per 10 halaman yang dimulai; satu gambar dihitung satu halaman. Halaman PDF dipisahkan dengan baris ---. Permintaan yang gagal tidak dikenai biaya.

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

Menghapus latar belakang foto dan mengembalikan PNG transparan seukuran gambarmu (sisi terpanjang hingga 4.096 px). Kirim image_url atau image_base64 (JPEG, PNG, WebP, atau HEIC, hingga 20 MB).

1 kredit per gambar. Permintaan yang gagal tidak dikenai biaya. File hasil disimpan selama satu jam.

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

Saldo kredit kamu saat ini. Gratis.

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

Server MCP untuk agen AI

Gunakan Morfran dari Claude, Cursor, atau agen apa pun yang mendukung Model Context Protocol. Servernya ada di https://api.morfran.com/mcp (Streamable HTTP) dan memakai API key yang sama serta harga kredit yang sama dengan REST API; pekerjaan yang gagal tidak dikenai biaya.

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"

Klien lain: tambahkan server MCP HTTP dengan URL tersebut dan header X-API-Key (atau Authorization: Bearer <key>).

Terdaftar di MCP Registry resmi sebagai com.morfran/morfran.

Properti (segera hadir)

Virtual staging dan video listing 8 detik (118 kredit per video) belum ada di API. Keduanya akan muncul di skema OpenAPI saat sudah aktif.