API de Parceiros
Execute um fluxo de trabalho do Morphic a partir dos seus próprios sistemas via HTTPS.
A Partner API inicia um workflow do Morphic a partir do seu próprio software. Você lê o contrato de entrada de um workflow, inicia uma execução com suas entradas e depois acompanha a execução — consultando-a periodicamente ou recebendo um webhook — até que ela devolva seus assets finalizados.
Acesso antecipado. A v1 está no ar. Os nomes dos campos e os limites ainda podem mudar — construa com base nela e nos diga o que não se encaixa.
O que é um workflow
Um workflow é uma receita que sua equipe cria no Morphic Studio: uma sequência de etapas de geração que recebe entradas nomeadas e produz assets finalizados. Esta API inicia um a partir dos seus sistemas e coleta sua saída. Ela não cria workflows — isso continua no Studio, onde trabalham as pessoas responsáveis pelas decisões criativas.
A estrutura de uma integração
sequenceDiagram
participant You as Your system
participant M as Morphic API
You->>M: GET workflow inputs
M-->>You: the inputs to collect
You->>M: POST workflow run
M-->>You: 202 + run id
loop until terminal
You->>M: GET workflow run
M-->>You: status, then assets
endO que você precisa antes de começar
| Valor | De onde vem |
|---|---|
| Chave de API | um administrador da sua organização Morphic a cria no Studio; a chave é exibida uma única vez |
| URL base | https://api.morphic.com/v1/partner — também exibida na página de chaves de API no Studio; veja Ambientes para staging |
org_id | sua organização Morphic — exibida, com um botão Copiar, na página de chaves de API no Studio |
project_id | a tela em que as execuções são criadas: abra-a no Studio e copie o id da URL, …/editor/<project_id>/canvas (o id em uma /projects/… URL é outro) |
workflow_id | o workflow que você foi solicitado a executar |
Não há upload de arquivos
Você nunca nos envia bytes. Cada entrada de arquivo é uma link HTTPS público que buscamos e verificamos — veja Passando arquivos por URL. Isso mantém um único contrato para imagens, vídeo, áudio e documentos, e significa que sua CDN continua sendo a origem do seu próprio conteúdo.
Leia a seguir
Autenticação
Chaves, escopos e ambientes
Convenções
IDs, carimbos de data e hora, erros, novas tentativas
Obter as entradas de um workflow
O contrato de entrada a ser coletado
Passando arquivos por URL
As regras de link que aplicamos
Iniciar uma execução de workflow
Iniciando o trabalho
Ler uma execução de workflow
Status e assets
Webhooks
Ser informado em vez de perguntar
Erros e limites
Cada código de erro e cada limite