문서

API 참조

도구 실행 목록 조회

GET/v1/tool-runs

flat 고정 호출당 가격, 입력으로 사전 계산하는 input 가격, 최종 사용량 기반 usage 가격을 통합 지원합니다. pricing.quote_required는 견적 필수 여부를, requires_usage는 비용 상한과 신뢰할 수 있는 최종 사용량 필요 여부를 결정합니다. 둘 다 schema_version으로 추정하지 않습니다. metered_pricing이 꺼지면 최종 사용량이 필요한 새 호출만 제한하며 최종 사용량이 불필요한 고정/입력 규칙은 계속 사용할 수 있습니다. 현재 키에 도구 권한이 있어야 하며 실행 식별 정보와 결과는 원래 키 범위로 제한됩니다. 도구 전체 스위치가 꺼지면 카탈로그가 비어 있으며 익명 카탈로그는 실행 권한이 아닙니다. 동일한 원래 키 소유의 실행만 나열하며 created_at 내림차순, 이어서 id 내림차순으로 엄격히 정렬합니다. 같은 초 안에서는 id로 안정적으로 순서를 정합니다. next_cursor는 불투명한 쌍 커서로 변경 없이 전달해야 하며 잘못된 커서는 400 invalid_cursor를 반환합니다. 페이지 나누기는 시점 스냅샷이 아닙니다. 현재 커서 앞에 정렬되는 새 기록은 첫 페이지를 새로 고쳐 확인하세요.

인증과 권한

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

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

쿼리 매개변수

  • cursorstring선택 사항

    원래 응답의 next_cursor이며 직접 만들지 마세요. 잘못된 커서는 400 invalid_cursor를 반환합니다.

  • limitinteger선택 사항

    카탈로그 범위는 1–100이며 유효하지 않으면 20으로 돌아갑니다. 실행 목록 범위도 1–100이며 유효하지 않으면 20으로 돌아갑니다.

응답과 오류

HTTP 200

도구 실행 목록 조회 성공

application/json

유형
object
필수 필드
items
  • itemsarray필수

    현재 페이지의 도구 또는 실행 배열입니다.

    items 하위 필드(1)
    • []object선택 사항
      [] 하위 필드(10)
      • 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 초 단위 마지막 갱신 시각입니다.

  • next_cursorstring선택 사항

    엄격히 불투명한 created_at/id 쌍 커서입니다. 변경 없이 전달하세요. 잘못된 커서는 400 invalid_cursor를 반환하며 없거나 빈 값이면 마지막 페이지입니다.

HTTP 400

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

application/json

유형
object
필수 필드
error

HTTP 401

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

application/json

유형
object
필수 필드
error

HTTP 403

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

application/json

유형
object
필수 필드
error

HTTP 404

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

application/json

유형
object
필수 필드
error

HTTP 409

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

application/json

유형
object
필수 필드
error

HTTP 429

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

application/json

유형
object
필수 필드
error

HTTP 500

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

application/json

유형
object
필수 필드
error

HTTP 503

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

application/json

유형
object
필수 필드
error
개발할 준비가 되셨나요? 열기: 콘솔 API 키를 생성하거나 살펴보기: 기능.