API de socios
Ejecuta un flujo de trabajo de Morphic desde tus propios sistemas a través de HTTPS.
La API de Partner inicia un flujo de trabajo de Morphic desde tu propio software. Lees el contrato de entrada de un flujo de trabajo, inicias una ejecución con tus entradas y luego sigues la ejecución — consultándola periódicamente o recibiendo un webhook — hasta que te devuelve sus recursos finales.
Acceso anticipado. La v1 ya está disponible. Los nombres de los campos y los límites aún pueden cambiar — constrúyelo sobre ella y cuéntanos qué no encaja.
Qué es un flujo de trabajo
Un flujo de trabajo es una receta que tu equipo redacta en Morphic Studio: una secuencia de pasos de generación que toma entradas con nombre y produce recursos finales. Esta API inicia uno desde tus sistemas y recopila su salida. No redacta flujos de trabajo — eso queda en Studio, donde trabaja la gente que toma las decisiones creativas.
La forma de una integración
sequenceDiagram
participant You as Tu sistema
participant M as API de Morphic
You->>M: GET entradas del flujo de trabajo
M-->>You: las entradas que recopilar
You->>M: POST ejecución del flujo de trabajo
M-->>You: 202 + id de ejecución
bucle hasta terminal
You->>M: GET ejecución del flujo de trabajo
M-->>You: estado, luego recursos
finLo que necesitas antes de empezar
| Valor | De dónde proviene |
|---|---|
| Clave de API | un administrador de tu organización de Morphic la crea en Studio; la clave se muestra una sola vez |
| URL base | https://api.morphic.com/v1/partner — también se muestra en la página de claves de API en Studio; consulta Entornos para staging |
org_id | tu organización de Morphic — se muestra, con un botón Copiar, en la página de claves de API en Studio |
project_id | el lienzo en el que caen las ejecuciones: ábrelo en Studio y copia el id desde su URL, …/editor/<project_id>/canvas (el id en una /projects/… URL es uno distinto) |
workflow_id | el flujo de trabajo que te pidieron ejecutar |
No hay carga de archivos
Nunca nos subes bytes. Cada entrada de archivo es una enlace HTTPS público que recuperamos y verificamos — consulta Pasar archivos por URL. Eso mantiene un único contrato para imágenes, video, audio y documentos, y significa que tu CDN sigue siendo el origen de tu propio contenido.
Siguiente lectura
Autenticación
Claves, ámbitos y entornos
Convenciones
Ids, marcas de tiempo, errores, reintentos
Obtén las entradas de un flujo de trabajo
El contrato de entrada con el que recopilar
Pasar archivos por URL
Las reglas de enlace que hacemos cumplir
Inicia una ejecución de flujo de trabajo
Comenzando el trabajo
Leer una ejecución de flujo de trabajo
Estados y recursos
Webhooks
Que te lo digan en lugar de preguntar
Errores y límites
Cada código de error y cada límite