API 참조

도구 실행 조회

GET/v1/tool-runs/{id}

flat 고정 호출당 가격, 입력으로 사전 계산하는 input 가격, 최종 사용량 기반 usage 가격을 통합 지원합니다. pricing.quote_required는 견적 필수 여부를, requires_usage는 비용 상한과 신뢰할 수 있는 최종 사용량 필요 여부를 결정합니다. 둘 다 schema_version으로 추정하지 않습니다. metered_pricing이 꺼지면 최종 사용량이 필요한 새 호출만 제한하며 최종 사용량이 불필요한 고정/입력 규칙은 계속 사용할 수 있습니다. 현재 키에 도구 권한이 있어야 하며 실행 식별 정보와 결과는 원래 키 범위로 제한됩니다. 도구 전체 스위치가 꺼지면 카탈로그가 비어 있으며 익명 카탈로그는 실행 권한이 아닙니다.

인증과 권한

현재 GloopAPI 키를 사용하세요. 사용 가능한 모델, 기능과 권한은 해당 카탈로그와 엔드포인트 문서에 따라 달라집니다.

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

경로 매개변수

idstring필수
현재 작업의 객체에 따라 카탈로그 도구 ID 또는 원래 도구 실행 ID입니다.

응답과 오류

HTTP 200

도구 실행 조회 성공

application/json

유형: object
필수 필드: idtool_idversionstatusoutputbillingresult_expiredcreated_atupdated_at

idstring필수
해당 상세 경로에 사용하는 이 객체의 공개 식별자입니다.
tool_idstring필수
현재 키의 실행 가능 카탈로그에 있는 도구 ID입니다.
versionstring필수
계약/기능 또는 도구 버전입니다. 실행에는 카탈로그가 반환한 도구 버전을 사용합니다.
statusstring필수
submitting/running/submission_unknown/succeeded/failed이며 submission_unknown은 제출 결과가 불명확함을 뜻합니다. 다른 Idempotency-Key로 재전송하지 마세요.
outputunknown필수
도구의 output_schema가 정의하는 JSON입니다. 만료 후에도 결과가 남는다고 가정하지 마세요.
error_codestring선택 사항
분기 로직에 사용할 수 있는 공개 오류 코드입니다.
billingobject필수
독립적인 요금 상태이며 생성 상태로 대체하지 마세요.
billing 하위 필드(7)
- review_requiredboolean선택 사항
  요금 증거에 수동 검토가 필요합니다.
- reasonstring선택 사항
  작업 불가 또는 요금 검토의 공개 사유입니다.
- usageunknown선택 사항
  선택한 도구의 스키마 또는 프로토콜이 정의하는 JSON 값입니다. 고정 필드를 가정하지 마세요.
- breakdownunknown선택 사항
  선택한 도구의 스키마 또는 프로토콜이 정의하는 JSON 값입니다. 고정 필드를 가정하지 마세요.
- statusstring필수
  현재 객체 상태입니다. 요금 및 저장 단계와 별도로 판단하세요.
- reserved_usdstring필수
  최대 USD 예약액 문자열입니다.
- charged_usdstring필수
  현재 확정된 USD 과금액 문자열입니다.
allOf 분기 1
유형: object
이 분기의 필수 항목: status, reserved_usd, charged_usd
- review_requiredboolean선택 사항
  요금 증거에 수동 검토가 필요합니다.
- reasonstring선택 사항
  작업 불가 또는 요금 검토의 공개 사유입니다.
- usageunknown선택 사항
  선택한 도구의 스키마 또는 프로토콜이 정의하는 JSON 값입니다. 고정 필드를 가정하지 마세요.
- breakdownunknown선택 사항
  선택한 도구의 스키마 또는 프로토콜이 정의하는 JSON 값입니다. 고정 필드를 가정하지 마세요.
- statusstring필수
  현재 객체 상태입니다. 요금 및 저장 단계와 별도로 판단하세요.
- reserved_usdstring필수
  최대 USD 예약액 문자열입니다.
- charged_usdstring필수
  현재 확정된 USD 과금액 문자열입니다.
result_expiredboolean필수
결과의 만료 여부이며 요금/멱등성 기록은 남습니다.
created_atinteger필수
Unix 초 단위 생성 시각입니다.
updated_atinteger필수
Unix 초 단위 마지막 갱신 시각입니다.

HTTP 400

요청 필드 또는 매개변수가 유효하지 않습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 401

키가 없거나 유효하지 않거나 만료 또는 폐기되었습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 403

IP, 계정, 모델 또는 도구 권한이 부족합니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 404

객체/기능을 사용할 수 없거나 기능 스위치가 비활성화되었습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 409

멱등성/견적 충돌, 준비되지 않은 객체 또는 여전히 참조 중인 상태입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 429

요청/대기열 속도 제한입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 500

내부 인증 또는 데이터 저장 오류입니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항

HTTP 503

서비스, 가격 또는 스토리지를 사용할 수 없습니다.

application/json

유형: object
필수 필드: error

errorobject필수
error 하위 필드(4)
- codestring선택 사항
- messagestring선택 사항
- typestring선택 사항
- request_idstring선택 사항