실행 지원 상태와 다음 단계
카탈로그, 입력 준비, 계획 생성, 작업 제출을 구분하고 현재 응답에 맞는 다음 행동을 확인합니다.
도구 안내에 보인다는 이유만으로 지금 실행할 수 있는 것은 아닙니다. 프로젝트를 선택한 뒤 list_execution_options를 호출해 현재 계정의 지원 상태를 확인하세요. 릴리스 게시는 조직 단위이므로 같은 조직의 프로젝트는 같은 결과를 봅니다.
어디까지 가능한가요?
options— 현재 호출 방식에서 실행 계획에 사용할 수 있는 릴리스입니다.releaseId와manifestHash를 함께 보존하세요. 목록에 있다는 사실만으로 제출이 승인되지는 않습니다.preparationOnly— 입력 준비 경로를 제공하는 도구입니다. 목록 이름만 보고 모든 단계가 막혔다고 판단하지 말고 항목의workflowSupport를 읽으세요.workflowSupport.inputPreparation— 입력 준비 지원 여부입니다.workflowSupport.planCreation— 해당 프로젝트에 준비 계획을 만들 수 있는 릴리스가 있는지 나타냅니다.workflowSupport.jobSubmission— 현재 호출 방식의 제출 지원입니다.plan-review-required도 제출 허가가 아니라 정확한 계획의 검토가 필요하다는 뜻입니다.
reason은 기계 판독용 식별자, reasonText는 그 사유의 설명입니다. 없는 사유를 추정해서 채우지 마세요. 최신 계획 검토에서는 입력·권한·릴리스·승인 등 제출 조건을 다시 확인합니다.
바로 실행되나요, 대기하나요?
executionCapacity는 지금 이 조직의 GPU 작업을 받을 실행 서버 현황입니다. 제출 가능 여부와는 별개이며, 서버가 없거나 가득 차도 제출은 받고 작업은 대기열에서 기다립니다.
state—available(지금 받을 자리가 있음),busy(모두 사용 중, 자리가 나면 실행),none(최근 2분 안에 연결된 서버 없음),unknown(서버는 있으나 남은 용량을 알리지 않음).cleanDevices— 아무 작업도 붙지 않은 GPU 수,maxFreeMb— 한 장치에서 나눠 쓸 수 있는 가장 큰 여유(MiB). 이보다 큰 작업은 자리가 날 때까지 기다립니다.platformServers·organizationServers— 나두바이오가 운영하는 서버와 조직이 연결한 서버의 수입니다.
사용자에게는 응답의 실행 서버 안내 문장을 그대로 전하세요. 대기 예상 시간은 응답에 없으므로 추정해서 말하지 마세요.
실행기가 아직 없는 경우
runtime_consumer_unavailable이면 현재 플랫폼에 해당 도구의 실행기가 없습니다. API 키 스코프 추가나 사람의 승인으로 실행기를 만들 수는 없습니다.
응답에서 입력 준비 또는 계획 생성이 지원되는 범위까지만 진행하세요. 제출 가능 여부는 계획을 만든 뒤 get_plan의 submissionAvailable로 확인합니다. 누가 제약을 풀 수 있는지는 각 도구의 fixableBy·fixableByText가 알려 줍니다: platform은 나두바이오가 실행기를 배포해야 하고, organization-operator는 조직의 운영 관리 권한자가 릴리스를 게시하면 풀립니다.
준비 계획에 사용할 릴리스가 없는 경우
release_unavailable이면 현재 프로젝트에서 계획을 만들 수 있는 유효한 게시 릴리스가 없습니다. 이 사유만으로 라이선스, 계정 권한, 게시 누락 중 무엇이 원인인지 단정할 수 없습니다.
입력 준비가 지원되면 그 단계까지 진행하고, 실행 옵션을 다시 조회해 릴리스가 제공되는지 확인하세요. 릴리스 ID는 이 응답이 준 값을 그대로 씁니다.
웹에서 새 계획을 만들어야 하는 경우
session_submission_required이면 현재 API 키 방식으로 만든 계획은 승인해도 제출할 수 없습니다. 응답의 실행 계획 보기 링크를 열고, 같은 프로젝트의 웹 입력 준비에서 새 계획을 만들고 검토하세요.
기존 API 키 계획이 웹 계획으로 바뀌는 것은 아닙니다. 원래 계획과 입력 기록은 보존하세요. 웹에서 새 계획을 만들어도 실제 입력·권한·실행 조건에 따라 제출이 제한될 수 있습니다.
정확한 계획을 먼저 검토해야 하는 경우
plan_review_required이면 응답에 제공된 릴리스로 입력을 고정한 계획을 만들고 검토하세요. 제출 가능 여부는 해당 계획의 현재 검토 결과를 따릅니다. 준비 성공, 사람 승인, 작업 접수, 실제 실행 완료는 서로 다른 상태입니다.
빈 목록이나 권한 오류
빈 목록 자체는 권한 부족의 증거가 아닙니다. scope_required 같은 실제 오류가 반환됐을 때만 해당 권한 요구를 설명하세요. 도구 대부분이 실행 불가하다거나 다른 계정으로 바꾸면 해결된다고 일반화하지 마세요.
사용자에게는 확인한 지원 단계와 사유, 실제 가능한 다음 행동을 함께 전달하세요. 서열 오류나 정규화는 입력 검증 결과 읽기에서 확인할 수 있습니다.