워크플로우의 입력 가져오기
실행을 시작하기 전에 워크플로가 받는 입력을 읽습니다.
워크플로의 입력은 Studio에서 작성되며, 작성자가 변경하면 함께 바뀝니다. 이를 하드코딩하지 말고 계약을 읽으세요.
GET {base_url}/workflows/{workflow_id}/inputsworkflows:read 권한이 필요합니다.
응답
{
"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"
}
]
}워크플로 객체
| 필드 | 의미 |
|---|---|
version_id | 실행이 지금 수행하게 될 버전입니다. 이 정확한 계약을 고정하려면 실행에 다시 전달하세요 |
schema_hash | 어떤 입력이든 변경되면 바뀝니다. 캐시와 비교할 유일한 필드입니다 |
credits_estimate | 이 워크플로 실행에 평균적으로 소요되어 온 크레딧 |
duration_seconds_estimate | 전체적으로 평균적으로 얼마나 걸렸는지 |
각 입력
| 필드 | 의미 |
|---|---|
key | 실행의 inputs 객체에서 사용할 이름 |
accepts | value 값 자체를 보내기 · url 공개 HTTPS 링크를 보내기 · option options[].id 중 하나를 보내기 |
type | string, number, boolean, image, video, audio 또는 document |
required | default_value가 설정되지 않은 경우 반드시 있어야 함 |
allow_multiple | true이면 값이 배열일 수 있으며, false이면 배열은 거부됩니다 |
allowed_values | accepts: value의 경우: allow_custom이 true가 아니면 허용되는 유일한 문자열 |
allow_custom | false이면 allowed_values 또는 options에 없는 값은 거부됩니다 |
minimum, maximum | type: number의 경우 포함 경계 |
default_value | 입력이 생략되었을 때 실행이 사용하는 값 |
url_content_types | accepts: url의 경우: 링크가 제공할 수 있는 콘텐츠 형식 |
max_bytes | accepts: url의 경우: 이 입력에 허용되는 최대 파일 크기 |
options | accepts: option의 경우: { "id", "label" } 항목. id를 받은 그대로 다시 보내세요. URL이 아닙니다 |
title, description | 사람을 위해 작성되었으며, 자체 UI에 표시해도 안전합니다 |
schema_hash를 기준으로 계약을 캐시해 두고, 실행이 invalid_request로 거부되면 다시 읽으세요. 워크플로 작성자는 두 번의 실행 사이에 필수 입력을 추가할 수 있습니다.