워크플로우의 입력 가져오기
실행을 시작하기 전에 워크플로가 받는 입력을 읽습니다.
워크플로의 입력은 Studio에서 작성되며, 작성자가 변경하면 함께 바뀝니다. 이를 하드코딩하지 말고 계약을 읽으세요.
GET {base_url}/workflows/{workflow_id}/inputs필요 workflows:read.
응답
{
"workflow": {
"id": "0192f3c3-9d21-7c44-b8e1-5a7f2c9d4e10",
"name": "스토리 비주얼",
"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": "스토리 문서",
"description": "각색할 완성된 스토리"
},
{
"key": "tone",
"accepts": "value",
"type": "string",
"required": true,
"allow_multiple": false,
"allowed_values": ["thriller", "romance", "mythology"],
"allow_custom": false,
"default_value": "thriller",
"title": "톤"
}
]
}워크플로 객체
| 필드 | 의미 |
|---|---|
version_id | 실행이 지금 수행하게 될 버전입니다. 이 정확한 계약을 고정하려면 실행에 다시 전달하세요 |
schema_hash | 어떤 입력이든 변경되면 바뀝니다. 캐시와 비교할 유일한 필드입니다 |
credits_estimate | 이 워크플로 실행에 평균적으로 소요되어 온 크레딧 |
duration_seconds_estimate | 전체적으로 평균적으로 얼마나 걸렸는지 |
각 입력
| 필드 | 의미 |
|---|---|
키를 키로 하는 객체 | 실행에서 사용할 이름 inputs 객체 |
허용합니다 | 값 값 자체를 보내기 · URL 공개 HTTPS 링크를 보내기 · 옵션 다음 중 하나를 보내기 options[].id |
유형 | 문자열, 숫자, 불리언, 이미지, 비디오, 오디오 또는 문서 |
필수 | 다음 경우가 아니면 반드시 있어야 함 기본값 설정된 경우 |
allow_multiple | true이면 값이 배열일 수 있으며, false이면 배열은 거부됩니다 |
허용값 | 에 대해 허용 형식: value다음 경우가 아니면 허용되는 문자열은 다음뿐입니다 사용자 지정 허용 true인 경우 |
사용자 지정 허용 | false이면 범위를 벗어난 값은 허용값 또는 옵션 거부됩니다 |
최소값, 최대값 | 포함 경계, 유형: number |
기본값 | 입력이 생략되었을 때 실행이 사용하는 값 |
url_content_types | 에 대해 허용 형식: url: 링크가 제공할 수 있는 콘텐츠 형식 |
max_bytes | 에 대해 허용 형식: url: 이 입력에 허용되는 최대 파일 크기 |
옵션 | 에 대해 허용 형식: option: { "id", "label" } 항목. 다음을 보내세요 id 받아서 정확히 그대로 다시 보내세요. URL이 아닙니다 |
제목, 설명 | 사람을 위해 작성되었으며, 자체 UI에 표시해도 안전합니다 |
계약을 캐시해 두고 schema_hash, 그리고 실행이 다음으로 거부될 때 다시 읽으세요 invalid_request. 워크플로 작성자는 두 번의 실행 사이에 필수 입력을 추가할 수 있습니다.