Obtén las entradas de un flujo de trabajo

Lee las entradas que toma un flujo de trabajo antes de iniciar una ejecución.

Las entradas de un flujo de trabajo se crean en Studio y cambian cuando sus autores las cambian. Lee el contrato en lugar de codificarlo de forma rígida.

GET {base_url}/workflows/{workflow_id}/inputs

Requiere workflows:read.

Respuesta

{
  "workflow": {
    "id": "0192f3c3-9d21-7c44-b8e1-5a7f2c9d4e10",
    "name": "Visuales de la historia",
    "version_id": "0192f3c4-1a02-7bb3-9f40-2c6e8d1a5b77",
    "schema_hash": "9fdf032d5b1c4e88",
    "credits_estimate": 1840,
    "duration_seconds_estimate": 420
  },
  "inputs": [
    {
      "key": "story_document",
      "accepts": "url",
      "type": "document",
      "required": true,
      "allow_multiple": false,
      "url_content_types": ["application/pdf", "text/plain", "text/markdown"],
      "max_bytes": 104857600,
      "title": "Documento de la historia",
      "description": "La historia terminada para adaptar"
    },
    {
      "key": "tone",
      "accepts": "valor",
      "type": "string",
      "required": true,
      "allow_multiple": false,
      "allowed_values": ["thriller", "romance", "mythology"],
      "allow_custom": false,
      "default_value": "thriller",
      "title": "Tono"
    }
  ]
}

El objeto del flujo de trabajo

CampoSignificado
version_idla versión que una ejecución ejecutaría ahora. Devuélvela en la ejecución para fijar exactamente este contrato
schema_hashcambia cuando cambia cualquiera de las entradas. El único campo que comparar contra tu caché
credits_estimatelos créditos que una ejecución de este flujo de trabajo ha estado costando en promedio
duration_seconds_estimatecuánto tiempo ha estado tardando en promedio, de extremo a extremo

Cada entrada

CampoSignificado
claveel nombre que se debe usar en el entradas objeto
aceptavalor envía el valor mismo · url envía un enlace HTTPS público · opción envía uno de options[].id
tipocadena, número, booleano, imagen, video, audio o documento
obligatoriodebe estar presente, a menos que default_value esté establecido
allow_multiplecuando es true, el valor puede ser un array; cuando es false, se rechaza un array
allowed_valuespara acepta: valor: las únicas cadenas aceptadas, a menos que allow_custom es verdadero
allow_customcuando es false, los valores fuera de allowed_values o las opciones se rechazan
mínimo, máximolímites inclusivos, para tipo: número
default_valuelo que usa la ejecución cuando se omite la entrada
url_content_typespara acepta: url: los tipos de contenido que el enlace puede servir
max_bytespara acepta: url: el archivo más grande aceptado para esta entrada
las opcionespara acepta: opción: { "id", "label" } entradas. Envía el id de vuelta exactamente como se proporciona; no es una URL
título, descriptionescrito para personas, seguro para mostrar en tu propia interfaz

Almacena en caché el contrato con schema_hash, y vuelve a leerlo cuando se rechaza una ejecución con invalid_request. Los autores de un flujo de trabajo pueden añadir una entrada obligatoria entre dos de tus ejecuciones.

En esta página