Ejecutar workflow

POST/v2/workflows/:workflowId/run

Scope: images:generate · consume tokens

Lanza un workflow creado en el panel. Consulta antes sus entradas con el esquema.

Cuerpo

Parámetro	Tipo	Por defecto	Descripción
inputs	object		Valores de las entradas, por key del esquema.
wait	boolean	false	Si es true, la petición espera a que termine la ejecución.

Cómo se interpretan los inputs

key	Efecto
prompt_<nodeId>	Sustituye el texto de ese nodo de prompt.
image_<nodeId>	Sustituye la imagen de ese nodo (URL o data URL).
Cualquier otra	Valor de la variable {{key}}.

Ejemplo

curl https://api.beta.pictulab.com/v2/workflows/$WORKFLOW_ID/run \
  -H "Authorization: Bearer $PICTULAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": {
      "image_n1": "https://cdn.pictulab.com/…/producto.png",
      "nombre_producto": "Sérum vitamina C"
    }
  }'

Respuesta

{
  "workflow_id": "3b9f0c1e-…",
  "workflow_name": "Fichas de producto",
  "run_id": "c41a7d22-…",
  "status": "running",
  "jobs": []
}

Por defecto la respuesta llega en cuanto la ejecución empieza (status: "running"). Sigue su progreso con GET …/runs/:id usando run_id.

Errores

Código	Tipo	Causa
404	NOT_FOUND	El workflow no existe.
400	WORKFLOW_INACTIVE	El workflow está desactivado.
400	MISSING_INPUTS	Faltan entradas obligatorias; el mensaje las enumera.
429	WORKFLOW_PARALLEL_LIMIT	Más de 5 ejecuciones simultáneas de este workflow.
402	INSUFFICIENT_TOKENS	Saldo insuficiente.