Direct API

Morphic Direct API, Morphic MCP sunucusunun bir yapay zekâ asistanına sunduğu üretim, düzenleme ve kütüphane araçlarının aynısını arka ucunuza düz HTTPS ve JSON üzerinden sunar. Bir aracı kuruluş API anahtarıyla çağırırsınız, her ücretli çağrı ne kadar ücret aldığını bildirir ve her üretimi yoklama yaparak ya da imzalı bir webhook ile takip edersiniz.

Bir bakıştaCopy Anchor Link

Erişim almaCopy Anchor Link

Direct API, davetle ve kuruluş bazında açılır. Açılana kadar her çağrı 403 direct_api_disabled yanıtını verir.

1. Morphic hesap sorumlunuzdan kuruluşunuz için Direct API'yi etkinleştirmesini isteyin. Sipariş formunuz tamamlandığında Morphic ücretli araçları da açar; o zamana kadar Direct API kapsamları Studio'da görünmez ve ücretli araçlar 403 tool_not_available yanıtını verir.
2. Kuruluşunuzun bir yöneticisi Studio'da, Settings > API keys altında bir anahtar oluşturur ve kuruluş adına Morphic Kullanım Koşulları'nı, Geliştirici API bölümü dahil olmak üzere kabul eder. Bkz. Bir anahtar oluşturun.
3. API'yi Authorization: Bearer <secret> ile çağırın.

Hızlı başlangıçCopy Anchor Link

Çıktının düşeceği projeyi bulun, bir görsel başlatın ve ardından tamamlanmasını bekleyin.

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"

Her üretim, kuruluşunuzun Morphic kütüphanesine, belirttiğiniz projeye, Studio'da yapılmış gibi düşer. Studio'da API tarafından oluşturulmuş olarak görünür ve kütüphanedeki Created by > API filtresi, API anahtarlarınızın oluşturduğu veya içe aktardığı her şeyi listeler.

Uç noktalarCopy Anchor Link

Sonraki okumalarCopy Anchor Link

Herhangi bir sorun yaşarsanız ya da sorularınız olursa, bizimle iletişime geçmekten çekinmeyin. Yardım etmeye memnuniyet duyarız. Bize şu adresten yazın: support@morphic.com.