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で返されます。
| ステータス | 意味 | 対処方法 |
|---|---|---|
401 | APIキーがない、または正しくない | 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クレジットです。
| フィールド | 型 | 備考 |
|---|---|---|
slug | path | GET /v1/effects から取得。例:80s-yearbook |
image_url | string | 公開されているJPG、PNG、WebP |
quality | string | standard(デフォルト)または 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スキーマに追加されます。