Direct API

A Direct API do Morphic dá ao seu backend as mesmas ferramentas de geração, edição e biblioteca que o servidor MCP do Morphic dá a um assistente de IA, por HTTPS e JSON simples. Você chama uma ferramenta com uma chave de API da organização, cada chamada paga informa quanto cobrou, e você acompanha cada geração por consulta (polling) ou por um webhook assinado.

Visão geralCopy Anchor Link

Como obter acessoCopy Anchor Link

A Direct API é ativada por organização, mediante convite. Até lá, toda chamada responde 403 direct_api_disabled.

1. Peça ao seu contato na Morphic para ativar a Direct API para a sua organização. A Morphic também ativa as ferramentas pagas assim que o seu formulário de pedido estiver formalizado; até lá, os escopos da Direct API não aparecem no Studio, e as ferramentas pagas respondem 403 tool_not_available.
2. Um administrador da sua organização cria uma chave no Studio, em Configurações > Chaves de API, e aceita os Termos de Uso da Morphic, incluindo a seção sobre a API para desenvolvedores, em nome da organização. Veja Criar uma chave.
3. Chame a API com Authorization: Bearer <secret>.

Início rápidoCopy Anchor Link

Encontre o projeto em que o resultado deve ficar, inicie uma imagem e espere por ela.

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 geração vai para a biblioteca do Morphic da sua organização, no projeto que você indicou, como se tivesse sido feita no Studio. No Studio, ela aparece como criada pela API, e o filtro Criado por > API da biblioteca lista tudo o que as suas chaves de API criaram ou importaram.

EndpointsCopy Anchor Link

Leia a seguirCopy Anchor Link

Se você tiver algum problema ou alguma dúvida, entre em contato. Teremos prazer em ajudar. Escreva para nós em support@morphic.com.