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.
| Status | Arti | Yang perlu dilakukan |
|---|---|---|
401 | API key tidak ada atau salah | Periksa header X-API-Key |
402 | Kredit tidak cukup | Beli paket kredit |
422 | Tidak ada wajah di foto | Kirim 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".
| Field | Tipe | Catatan |
|---|---|---|
slug | path | Dari GET /v1/effects, misalnya 80s-yearbook |
image_url | string | JPG, PNG, atau WebP publik |
quality | string | standard (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.