Direct API
自社のバックエンドから HTTPS 経由で、Morphic の画像、動画、音声を生成、編集、管理します。
Morphic Direct API は、Morphic MCP サーバー が AI アシスタントに提供するのと同じ生成、編集、ライブラリのツールを、シンプルな HTTPS と JSON でお客様のバックエンドに提供します。組織の API キーでツールを呼び出すと、有料の呼び出しはすべて請求額を返します。各生成はポーリングまたは署名付き Webhook で追跡します。
概要
| ベース URL | https://mcp.morphic.com/v1/direct |
|---|---|
| 認証 | Authorization: Bearer mor_live_… |
| 形式 | JSON のリクエストボディとレスポンスボディ、UTF-8、1 リクエストあたり最大 1 MB |
| ID | お客様のデータには UUID v7 文字列、モデルには mdl_…、ボイスには list_voices が返す UUID |
| 日時 | UTC の ISO 8601（例: 2026-10-25T09:14:03.120Z） |
| 料金 | Morphic クレジット（整数）。プランと Studio で消費するクレジットと同じものです |
利用を開始する
Direct API は招待制で、組織ごとに有効化されます。有効化されるまでは、すべての呼び出しが 403 direct_api_disabled を返します。
- Morphic の担当者に、組織で Direct API を有効にするよう依頼します。発注書の手続きが完了すると、Morphic が有料ツールも有効にします。それまでは Direct API のスコープは Studio に表示されず、有料ツールは
403 tool_not_availableを返します。 - 組織の管理者が Studio の「設定」>「APIキー」でキーを作成し、組織として Morphic 利用規約（開発者向け API のセクションを含む）に同意します。キーを作成する をご覧ください。
Authorization: Bearer <secret>を付けて API を呼び出します。
クイックスタート
出力を保存するプロジェクトを見つけ、画像の生成を開始し、完了を待ちます。
export MORPHIC_API_KEY=mor_live_9f2c… # created once in Studio > Settings > API keys
# 1. Which project should the output land in?
curl -s https://mcp.morphic.com/v1/direct/tools/list_projects \
-H "Authorization: Bearer $MORPHIC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input": {}}'
# 2. Start an image
curl -s https://mcp.morphic.com/v1/direct/tools/generate_image \
-H "Authorization: Bearer $MORPHIC_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-4411-hero-image" \
-d '{
"input": {
"prompt": "A red vintage bicycle against a pastel wall, soft morning light",
"aspect_ratio": "16:9",
"project_id": "01928f4e-5b7c-7d2a-9e11-3c4b5a6d7e8f"
},
"webhook_id": "01929a10-0c3d-7f44-8a21-0b1c2d3e4f50",
"metadata": { "order_id": "4411" }
}'
# 3. Wait for it (holds up to 45 s, returns the moment it finishes)
curl -s "https://mcp.morphic.com/v1/direct/generations/0192a7b3-…?wait=45" \
-H "Authorization: Bearer $MORPHIC_API_KEY"すべての生成結果は、Studio で作成した場合と同じように、組織の Morphic ライブラリ内の指定したプロジェクトに保存されます。Studio では API による作成として表示され、ライブラリの「作成者」>「API」フィルターで、組織の API キーが作成またはインポートしたものをすべて一覧できます。
エンドポイント
| メソッド | パス | スコープ | 内容 |
|---|---|---|---|
GET | /v1/direct/me | なし | キー、その上限と消費額、組織の残高 |
GET | /v1/direct/tools | なし | JSON Schema 付きのツールカタログ |
GET | /v1/direct/tools/{tool_name} | なし | 1 つのツール |
GET | /v1/direct/openapi.json | なし | OpenAPI 3.1 ドキュメント |
POST | /v1/direct/tools/{tool_name} | ツールごと | ツールを呼び出す |
GET | /v1/direct/generations/{id} | assets:read | 1 件の生成。ロングポーリングも可能 |
POST | /v1/direct/generations/batch-get | assets:read | 最大 10 件の生成。ロングポーリングも可能 |
GET | /v1/direct/usage | assets:read | 台帳エントリと合計 |
POST | /v1/direct/webhooks | generations:write | エンドポイントを登録する |
GET | /v1/direct/webhooks | assets:read | エンドポイントを一覧表示する |
DELETE | /v1/direct/webhooks/{webhook_id} | generations:write | エンドポイントを削除する |
GET | /v1/direct/webhooks/{webhook_id}/events | assets:read | 配信ログ |
次に読む
認証
キー、スコープ、クレジット上限
ツールの呼び出し
リクエスト、レスポンス、課金、冪等性
生成
ステータス、ポーリング、一括読み取り
Webhook
生成の完了時に届く署名付き通知
クレジットと使用量
各呼び出しの請求額、/me と /usage
お手持ちのメディアを渡す
どのメディアフィールドでも URL でファイルを指定
エラー
すべてのエラーコードと再試行の判断
制限
レート制限とサイズ制限
ツールカタログ
すべてのツールと必要なスコープ
モデル
モデル ID、機能、オプション
バージョニング
v1 の中で変わりうること
何かお困りのことやご質問がありましたら、お気軽にご連絡ください。喜んでお手伝いします。こちらまでご連絡ください support@morphic.com.