ConverterHQDevelopers
API v1

Diseñar Jobs y workflows

Modela DAG, paralelismo y dependencias antes de producción.

Un Job es un grafo acíclico dirigido, no un script secuencial. Cada Task declara operación, entrada, opciones y dependencias.

Pensar como DAG

Modela Tasks independientes como ramas hermanas para permitir ejecución paralela. depends_on debe expresar únicamente prerequisitos reales.

Paralelizar trabajo independiente

Si un archivo genera PDF, miniatura y texto, crea tres ramas. La concurrencia final queda limitada por el plan y el scheduler justo.

Elegir límites de Task

Crea una Task donde necesites retry, observabilidad, fan-out/fan-in o un efecto externo independiente. Los parámetros de motor pertenecen a settings.

Validar con Job Builder

El estudio detecta ciclos y dependencias localmente y genera el body exacto de POST /v1/jobs. POST /v1/jobs/validate sigue siendo autoritativo para capabilities, settings, cuota y cuenta.