Direct API

La Direct API de Morphic donne à votre backend les mêmes outils de génération, de modification et de bibliothèque que le serveur MCP de Morphic donne à un assistant IA, en simple HTTPS et JSON. Vous appelez un outil avec une clé d’API d’organisation, chaque appel payant indique ce qu’il a facturé, et vous suivez chaque génération par sondage ou grâce à un webhook signé.

En brefCopy Anchor Link

Obtenir l’accèsCopy Anchor Link

La Direct API est activée organisation par organisation, sur invitation. Tant qu’elle ne l’est pas, chaque appel répond 403 direct_api_disabled.

1. Demandez à votre contact Morphic d’activer la Direct API pour votre organisation. Morphic active aussi les outils payants une fois votre bon de commande en place ; d’ici là, les autorisations de la Direct API n’apparaissent pas dans Studio, et les outils payants répondent 403 tool_not_available.
2. Un administrateur de votre organisation crée une clé dans Studio, sous « Paramètres » > « Clés d'API », et accepte, au nom de l’organisation, les Conditions d’utilisation de Morphic, y compris leur section consacrée à l’API pour les développeurs. Voir Créer une clé.
3. Appelez l’API avec Authorization: Bearer <secret>.

Démarrage rapideCopy Anchor Link

Trouvez le projet dans lequel le résultat doit arriver, lancez une image, puis attendez-la.

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"

Chaque génération arrive dans la bibliothèque Morphic de votre organisation, dans le projet que vous avez indiqué, comme si elle avait été créée dans Studio. Dans Studio, elle apparaît comme créée par l’API, et le filtre « Créé par » > « API » de la bibliothèque liste tout ce que vos clés d’API ont créé ou importé.

Points de terminaisonCopy Anchor Link

À lire ensuiteCopy Anchor Link

Si vous rencontrez le moindre problème ou si vous avez des questions, n’hésitez pas à nous contacter. Nous serons ravis de vous aider. Écrivez-nous à support@morphic.com.