Dokumentacja API Morfran

Bazowy URL https://api.morfran.com. Każde żądanie wysyła twój klucz w nagłówku X-API-Key. Klucze tworzysz w swoim panelu. Pełny schemat jest pod adresem /openapi.json (OpenAPI 3).

Uwierzytelnianie przez X-API-Key

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

Kredyty i błędy

Kredyty pobieramy tylko za gotowe obrazy. Błędy wracają jako JSON z kodem statusu i komunikatem.

StatusZnaczenieCo zrobić
401Brak klucza API lub błędny kluczSprawdź nagłówek X-API-Key
402Za mało kredytówKup pakiet kredytów
422Na zdjęciu nie znaleziono twarzyWyślij zdjęcie z jedną wyraźną twarzą

GET /v1/effects

Zwraca listę efektów, których możesz użyć: slug, nazwa, kategoria i obraz okładki. Bezpłatnie.

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

POST /v1/effects/{slug}

Nakłada jeden efekt na jedno zdjęcie i zwraca link CDN. 11 kredytów z "quality": "standard", 29 z "pro".

PoleTypUwagi
slugpathZ GET /v1/effects, na przykład 80s-yearbook
image_urlstringPubliczny plik JPG, PNG lub WebP
qualitystringstandard (domyślnie) lub 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

Przenosi twarz z SourceImageUrl na TargetImageUrl. 5 kredytów. Wersja grupowa, /v1/face-swap/group, zmienia do ośmiu twarzy (MaxFaces) za 10 kredytów. Długie zadania zwracają identyfikator zadania; wynik odczytasz z 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

Zamienia mowę z pliku audio lub wideo na tekst z segmentami ze znacznikami czasu. Wyślij media_url (albo media_base64 z media_type). Opcjonalnie: language jako podpowiedź (ISO 639-1), translate_to dla tłumaczenia w tym samym wywołaniu, timestamps (domyślnie true).

2 kredyty za każdą rozpoczętą minutę, co najmniej jedna minuta; tłumaczenie dodaje 1 kredyt za minutę. Pliki do 10 minut i 50 MB. Brak mowy: 422 i bez opłaty.

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

Zamienia tekst (do 4000 znaków, język wykrywany automatycznie) na naturalną mowę i zwraca link do pliku WAV. Wybierz voice z GET /v1/tts/voices (30 głosów, bezpłatnie), quality standard lub pro oraz opcjonalny style czytania, np. "radośnie".

5 kredytów za każde rozpoczęte 1000 znaków w Standard, 7 w Pro. Nieudane żądania nie są rozliczane. Plik audio przechowujemy przez jedną godzinę.

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

Odczytuje tekst z obrazu lub PDF-a (do 20 stron i 20 MB). Wyślij image_url albo image_base64; JPEG, PNG, WebP, HEIC i PDF są rozpoznawane po samym pliku. format to text (domyślnie) albo markdown, który zachowuje tabele. language to opcjonalna podpowiedź.

1 kredyt za każde rozpoczęte 10 stron; obraz liczy się jako jedna strona. Strony PDF-a są rozdzielone linią ---. Nieudane żądania nie są obciążane.

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

Usuwa tło ze zdjęcia i zwraca przezroczysty PNG w rozmiarze twojego obrazu (dłuższy bok do 4096 px). Wyślij image_url albo image_base64 (JPEG, PNG, WebP lub HEIC, do 20 MB).

1 kredyt za obraz. Nieudane żądania nie są obciążane. Plik wynikowy jest przechowywany przez godzinę.

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

Twoje aktualne saldo kredytów. Bezpłatnie.

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

Serwer MCP dla agentów AI

Korzystaj z Morfran w Claude, Cursorze lub dowolnym agencie obsługującym Model Context Protocol. Serwer działa pod adresem https://api.morfran.com/mcp (Streamable HTTP) i używa tego samego klucza API oraz tych samych cen w kredytach co REST API; za nieudane zadania nie pobieramy opłat.

Narzędzia: 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"

Inni klienci: dodaj serwer HTTP MCP z tym adresem URL i nagłówkiem X-API-Key (lub Authorization: Bearer <key>).

Widnieje w oficjalnym rejestrze MCP jako com.morfran/morfran.

Nieruchomości (wkrótce)

Wirtualnego home stagingu i 8-sekundowych filmów ofertowych (118 kredytów za film) nie ma jeszcze w API. Pojawią się w schemacie OpenAPI, gdy zostaną uruchomione.