Obter as entradas de um workflow
Leia as entradas que um fluxo de trabalho usa antes de iniciar uma execução.
As entradas de um workflow são definidas no Studio e mudam quando seus autores as alteram. Leia o contrato em vez de codificá-lo diretamente.
GET {base_url}/workflows/{workflow_id}/inputsRequer workflows:read.
Resposta
{
"workflow": {
"id": "0192f3c3-9d21-7c44-b8e1-5a7f2c9d4e10",
"name": "Story visuals",
"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": "Story document",
"description": "The finished story to adapt"
},
{
"key": "tone",
"accepts": "value",
"type": "string",
"required": true,
"allow_multiple": false,
"allowed_values": ["thriller", "romance", "mythology"],
"allow_custom": false,
"default_value": "thriller",
"title": "Tone"
}
]
}O objeto workflow
| Campo | Significado |
|---|---|
version_id | a versão que uma execução executaria agora. Envie-a de volta na execução para fixar este contrato exato |
schema_hash | muda quando qualquer entrada muda. O único campo para comparar com seu cache |
credits_estimate | créditos que uma execução deste workflow tem custado em média |
duration_seconds_estimate | quanto tempo tem levado em média, do início ao fim |
Cada entrada
| Campo | Significado |
|---|---|
key | o nome a usar no objeto inputs da execução |
accepts | value envie o próprio valor · url envie um link HTTPS público · option envie um de options[].id |
type | string, number, boolean, image, video, audio ou document |
required | deve estar presente, a menos que default_value esteja definido |
allow_multiple | quando verdadeiro, o valor pode ser um array; quando falso, um array é recusado |
allowed_values | para accepts: value: as únicas strings aceitas, a menos que allow_custom seja verdadeiro |
allow_custom | quando falso, valores fora de allowed_values ou options são recusados |
minimum, maximum | limites inclusivos, para type: number |
default_value | o que a execução usa quando a entrada é omitida |
url_content_types | para accepts: url: os tipos de conteúdo que o link pode servir |
max_bytes | para accepts: url: o maior arquivo aceito para esta entrada |
options | para accepts: option: { "id", "label" } entradas. Envie o id de volta exatamente como fornecido; não é uma URL |
title, description | escrito para pessoas, seguro para mostrar na sua própria interface |
Armazene em cache o contrato em relação a schema_hash, e leia-o novamente quando uma execução for recusada com invalid_request. Os autores de um workflow podem adicionar uma entrada obrigatória entre duas de suas execuções.