Direct API

Morphic Direct API memberi backend Anda alat pembuatan, pengeditan, dan pustaka yang sama dengan yang diberikan server MCP Morphic kepada asisten AI, melalui HTTPS dan JSON biasa. Anda memanggil sebuah alat dengan kunci API organisasi, setiap panggilan berbayar melaporkan berapa yang ditagihkan, dan Anda memantau setiap generasi dengan polling atau dengan webhook bertanda tangan.

SekilasCopy Anchor Link

Mendapatkan aksesCopy Anchor Link

Direct API diaktifkan per organisasi, berdasarkan undangan. Sebelum diaktifkan, setiap panggilan dijawab dengan 403 direct_api_disabled.

1. Minta kontak akun Morphic Anda untuk mengaktifkan Direct API bagi organisasi Anda. Morphic juga mengaktifkan alat berbayar setelah formulir pesanan Anda selesai; sebelum itu, cakupan Direct API tidak muncul di Studio, dan alat berbayar menjawab 403 tool_not_available.
2. Seorang admin organisasi Anda membuat kunci di Studio, di 'Pengaturan' > 'Kunci API', dan menyetujui Ketentuan Penggunaan Morphic, termasuk bagian API untuk developer di dalamnya, atas nama organisasi. Lihat Buat kunci.
3. Panggil API dengan Authorization: Bearer <secret>.

Mulai cepatCopy Anchor Link

Temukan proyek tempat hasil akan disimpan, mulai sebuah gambar, lalu tunggu hingga selesai.

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"

Setiap generasi masuk ke pustaka Morphic organisasi Anda, di proyek yang Anda sebutkan, seolah-olah dibuat di Studio. Di Studio, generasi itu ditandai dibuat oleh API, dan filter pustaka 'Dibuat oleh' > 'API' menampilkan semua yang dibuat atau diimpor oleh kunci API Anda.

EndpointCopy Anchor Link

Baca selanjutnyaCopy Anchor Link

Jika Anda mengalami kendala atau memiliki pertanyaan, jangan ragu untuk menghubungi kami. Kami dengan senang hati akan membantu. Tulis kepada kami di support@morphic.com.