Morfran API başvurusu
Temel adres https://api.morfran.com. Her istek anahtarını X-API-Key başlığında gönderir. Anahtarları panelinde oluştur. Şemanın tamamı /openapi.json adresinde (OpenAPI 3).
X-API-Key ile kimlik doğrulama
curl https://api.morfran.com/v1/effects \ -H "X-API-Key: $MORFRAN_KEY"
Kredi ve hatalar
Kredi yalnız tamamlanan görseller için düşülür. Hatalar bir durum kodu ve mesajla JSON olarak döner.
| Durum | Anlamı | Ne yapmalı |
|---|---|---|
401 | API anahtarı eksik ya da yanlış | X-API-Key başlığını kontrol et |
402 | Yeterli kredi yok | Kredi paketi al |
422 | Fotoğrafta yüz bulunamadı | Tek ve net bir yüz içeren fotoğraf gönder |
GET /v1/effects
Uygulayabileceğin efektleri listeler: slug, ad, kategori ve kapak görseli. Ücretsiz.
curl https://api.morfran.com/v1/effects \ -H "X-API-Key: $MORFRAN_KEY"
POST /v1/effects/{slug}
Bir fotoğrafa bir efekt uygular ve bir CDN bağlantısı döndürür. "quality": "standard" ile 11 kredi, "pro" ile 29 kredi.
| Alan | Tür | Notlar |
|---|---|---|
slug | path | GET /v1/effects yanıtından, örneğin 80s-yearbook |
image_url | string | Herkese açık JPG, PNG ya da WebP |
quality | string | standard (varsayılan) ya da 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
SourceImageUrl içindeki yüzü TargetImageUrl içine yerleştirir. 5 kredi. Grup sürümü /v1/face-swap/group, 10 krediye sekize kadar yüzü (MaxFaces) değiştirir. Uzun işler bir görev kimliği döndürür; sonucu GET /v1/face-swap/{taskId} ile oku.
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
Ses ya da video dosyasındaki konuşmayı zaman damgalı bölümlerle metne çevirir. media_url gönder (ya da media_type ile birlikte media_base64). İsteğe bağlı: ipucu olarak language (ISO 639-1), aynı çağrıda çeviri için translate_to, timestamps (varsayılan true).
Başlayan her dakika için 2 kredi, en az bir dakika; çeviri dakika başına 1 kredi ekler. Dosyalar en fazla 10 dakika ve 50 MB. Konuşma bulunamazsa: 422 ve ücret alınmaz.
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
Metni (en fazla 4.000 karakter, dil otomatik algılanır) doğal sese çevirir ve bir WAV bağlantısı döndürür. GET /v1/tts/voices listesinden bir voice seç (30 ses, ücretsiz), quality olarak standard ya da pro belirle ve istersen "neşeyle" gibi bir okuma style ekle.
Standard'da başlayan her 1.000 karakter için 5 kredi, Pro'da 7. Başarısız istekler ücretlendirilmez. Ses dosyası bir saat saklanır.
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
Bir görseldeki ya da PDF'teki metni okur (en fazla 20 sayfa ve 20 MB). image_url ya da image_base64 gönder; JPEG, PNG, WebP, HEIC ve PDF dosyanın kendisinden anlaşılır. format text (varsayılan) ya da tabloları koruyan markdown olur. language isteğe bağlı bir ipucudur.
Başlayan her 10 sayfa için 1 kredi; bir görsel bir sayfa sayılır. PDF'in sayfaları --- satırıyla ayrılır. Başarısız istekler ücretlendirilmez.
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
Fotoğrafın arka planını siler ve görselin boyutunda şeffaf bir PNG döndürür (uzun kenar en fazla 4.096 px). image_url ya da image_base64 gönder (JPEG, PNG, WebP ya da HEIC, en fazla 20 MB).
Görsel başına 1 kredi. Başarısız istekler ücretlendirilmez. Sonuç dosyası bir saat saklanır.
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
Güncel kredi bakiyen. Ücretsiz.
curl https://api.morfran.com/v1/credits/balance \ -H "X-API-Key: $MORFRAN_KEY"
Yapay zeka ajanları için MCP sunucusu
Morfran'ı Claude, Cursor ya da Model Context Protocol destekleyen herhangi bir ajandan kullan. Sunucu https://api.morfran.com/mcp adresinde (Streamable HTTP); REST API ile aynı API anahtarını ve aynı kredi fiyatlarını kullanır. Başarısız işler ücretlendirilmez.
Araçlar: 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"
Diğer istemciler: bu adresle ve X-API-Key başlığıyla (ya da Authorization: Bearer <key>) bir HTTP MCP sunucusu ekle.
Resmi MCP Registry'de com.morfran/morfran adıyla listelenir.
Emlak (yakında)
Sanal döşeme ve 8 saniyelik ilan videoları (video başına 118 kredi) henüz API'de yok. Yayına girdiklerinde OpenAPI şemasında görünecekler.