Direct API

La Direct API de Morphic ofrece a su backend las mismas herramientas de generación, edición y biblioteca que el servidor MCP de Morphic ofrece a un asistente de IA, mediante HTTPS y JSON sin más. Usted llama a una herramienta con una clave de API de la organización, cada llamada de pago informa de lo que se cobró y usted sigue cada generación mediante sondeo o mediante un webhook firmado.

De un vistazoCopy Anchor Link

Obtener accesoCopy Anchor Link

La Direct API se activa por organización, por invitación. Hasta entonces, cada llamada responde 403 direct_api_disabled.

1. Pida a su contacto de cuenta en Morphic que active la Direct API para su organización. Morphic también activa las herramientas de pago una vez que su formulario de pedido está formalizado; hasta entonces, los permisos de la Direct API no aparecen en Studio y las herramientas de pago responden 403 tool_not_available.
2. Un administrador de su organización crea una clave en Studio, en 'Configuración' > 'Claves de API', y acepta en nombre de la organización los Términos de uso de Morphic, incluida su sección sobre la API para desarrolladores. Consulte Crear una clave.
3. Llame a la API con Authorization: Bearer <secret>.

Inicio rápidoCopy Anchor Link

Busque el proyecto en el que debe guardarse el resultado, inicie una imagen y espere a que termine.

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"

Cada generación se guarda en la biblioteca de Morphic de su organización, en el proyecto que indicó, como si se hubiera creado en Studio. En Studio aparece como creada por API, y el filtro 'Creado por' > 'API' de la biblioteca muestra todo lo que sus claves de API han creado o importado.

EndpointsCopy Anchor Link

Siguiente lecturaCopy Anchor Link

Si tiene algún problema o alguna pregunta, no dude en ponerse en contacto con nosotros. Estaremos encantados de ayudarle. Escríbanos a support@morphic.com.