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.

DurumAnlamıNe yapmalı
401API anahtarı eksik ya da yanlışX-API-Key başlığını kontrol et
402Yeterli kredi yokKredi paketi al
422Fotoğ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.

AlanTürNotlar
slugpathGET /v1/effects yanıtından, örneğin 80s-yearbook
image_urlstringHerkese açık JPG, PNG ya da WebP
qualitystringstandard (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.