Direct API

Die Morphic Direct API stellt Ihrem Backend dieselben Tools für Generierung, Bearbeitung und Bibliothek bereit, die der Morphic MCP-Server einem KI-Assistenten bietet, über einfaches HTTPS und JSON. Sie rufen ein Tool mit einem API-Schlüssel der Organisation auf, jeder kostenpflichtige Aufruf meldet, was er berechnet hat, und Sie verfolgen jede Generierung per Polling oder über einen signierten Webhook.

Auf einen BlickCopy Anchor Link

Zugang erhaltenCopy Anchor Link

Die Direct API wird pro Organisation auf Einladung freigeschaltet. Bis dahin antwortet jeder Aufruf mit 403 direct_api_disabled.

1. Bitten Sie Ihre Ansprechperson bei Morphic, die Direct API für Ihre Organisation freizuschalten. Morphic schaltet außerdem die kostenpflichtigen Tools frei, sobald Ihr Bestellformular vorliegt. Bis dahin erscheinen die Berechtigungen der Direct API nicht in Studio, und kostenpflichtige Tools antworten mit 403 tool_not_available.
2. Ein Admin Ihrer Organisation erstellt in Studio unter Einstellungen > API-Schlüssel einen Schlüssel und akzeptiert für die Organisation die Nutzungsbedingungen von Morphic einschließlich ihres Abschnitts zur Entwickler-API. Siehe Einen Schlüssel erstellen.
3. Rufen Sie die API mit Authorization: Bearer <secret> auf.

SchnellstartCopy Anchor Link

Ermitteln Sie das Projekt, in dem das Ergebnis landen soll, starten Sie ein Bild und warten Sie dann darauf.

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"

Jede Generierung landet in der Morphic-Bibliothek Ihrer Organisation, in dem von Ihnen angegebenen Projekt, so als wäre sie in Studio entstanden. In Studio wird sie als von der API erstellt angezeigt, und der Bibliotheksfilter Erstellt von > API listet alles auf, was Ihre API-Schlüssel erzeugt oder importiert haben.

EndpunkteCopy Anchor Link

WeiterlesenCopy Anchor Link

Wenn Sie Probleme haben oder Fragen haben, können Sie sich gerne an uns wenden. Wir helfen Ihnen gerne. Schreiben Sie uns an support@morphic.com.