Morfran APIリファレンス

ベースURLは https://api.morfran.com です。すべてのリクエストで、X-API-Key ヘッダーにAPIキーを送信します。キーはダッシュボードで作成できます。完全なスキーマは /openapi.json(OpenAPI 3)にあります。

X-API-Keyによる認証

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

クレジットとエラー

クレジットは完成した画像に対してのみ消費されます。エラーはステータスコードとメッセージを含むJSONで返されます。

ステータス意味対処方法
401APIキーがない、または正しくないX-API-Keyヘッダーを確認してください
402クレジットが不足していますクレジットパックを購入してください
422写真に顔が見つかりません顔がはっきり1つ写った写真を送ってください

GET /v1/effects

適用できるエフェクトの一覧(slug、名前、カテゴリ、カバー画像)を返します。無料です。

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

POST /v1/effects/{slug}

1枚の写真に1つのエフェクトを適用し、CDNリンクを返します。"quality": "standard" で11クレジット、"pro" で29クレジットです。

フィールド型備考
slugpathGET /v1/effects から取得。例:80s-yearbook
image_urlstring公開されているJPG、PNG、WebP
qualitystringstandard(デフォルト)または 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 の顔を TargetImageUrl に入れ替えます。5クレジットです。グループ版の /v1/face-swap/group は最大8人の顔(MaxFaces)を10クレジットで入れ替えます。時間のかかるジョブはタスクIDを返すので、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

音声・動画ファイルの話し言葉を、タイムスタンプ付きのセグメントでテキストに変換します。media_url(またはmedia_typeを付けたmedia_base64)を送信してください。任意:ヒントとしてのlanguage(ISO 639-1)、同じ呼び出しで翻訳するtranslate_to、timestamps(デフォルトはtrue)。

開始した1分ごとに2クレジット、最低1分です。翻訳は1分あたり1クレジット追加されます。ファイルは10分・50 MBまで。音声が検出されない場合は422となり、課金されません。

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

テキスト(最大4,000文字、言語は自動検出)を自然な音声に変換し、WAVリンクを返します。GET /v1/tts/voices から voice を選び(30種類、無料)、quality に standard または pro を指定し、必要に応じて "明るく" のような読み上げ style を加えます。

Standardは開始した1,000文字ごとに5クレジット、Proは7クレジットです。失敗したリクエストは課金されません。音声ファイルは1時間保存されます。

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

画像またはPDF(最大20ページ・20 MB)のテキストを読み取ります。image_urlまたはimage_base64を送信してください。JPEG、PNG、WebP、HEIC、PDFはファイルの中身から自動判別されます。formatはtext(既定)または表を保持するmarkdownです。languageは任意のヒントです。

開始した10ページごとに1クレジット。画像は1ページとして数えます。PDFの各ページは --- の行で区切られます。失敗したリクエストは課金されません。

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

写真の背景を削除し、元の画像サイズの透過PNGを返します(長辺は最大4,096 px)。image_urlまたはimage_base64を送信してください(JPEG、PNG、WebP、HEIC、最大20 MB)。

画像1枚につき1クレジット。失敗したリクエストは課金されません。結果ファイルは1時間保存されます。

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

現在のクレジット残高です。無料です。

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

AIエージェント向けMCPサーバー

Claude、Cursor、またはModel Context Protocolに対応したエージェントからMorfranを使えます。サーバーは https://api.morfran.com/mcp(Streamable HTTP)で、REST APIと同じAPIキー、同じクレジット料金で利用できます。失敗したジョブには課金されません。

ツール: 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"

その他のクライアント:このURLと X-API-Key ヘッダー(または Authorization: Bearer <key>)でHTTP MCPサーバーを追加してください。

公式MCPレジストリに com.morfran/morfran として登録されています。

不動産(近日公開)

バーチャルステージングと8秒の物件紹介動画(1本118クレジット)は、まだAPIでは提供していません。公開時にOpenAPIスキーマに追加されます。