API 참조

실행 가능한 도구 검색

POST/v1/tools/discover

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

인증과 권한

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

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

요청 본문 · application/json

유형: object
필수 필드: query
추가 속성: false

요청 본문 필수

querystring필수
비어 있지 않아야 하며 최대 1000 UTF-8바이트입니다. ID/이름/설명과 일치시킵니다.
limitinteger선택 사항
생략하거나 <=0이면 5를 사용합니다.

기본값
5
최댓값
20

응답과 오류

HTTP 200

실행 가능한 도구 검색 성공

application/json

유형: object
필수 필드: resultscount

resultsarray필수
results 하위 필드(1)
- []object선택 사항
  [] 하위 필드(8)
  - category_idstring필수
    도구 분류 식별자입니다.
  - collection_idstring필수
    도구 컬렉션 식별자입니다.
  - tagsarray필수
    공개 검색 태그입니다.
    
    tags 하위 필드(1)
    []string선택 사항
  - idstring필수
    해당 상세 경로에 사용하는 이 객체의 공개 식별자입니다.
  - namestring필수
    사람이 읽을 수 있는 이름입니다.
  - descriptionstring필수
    공개 용도 설명입니다.
  - versionstring필수
    계약/기능 또는 도구 버전입니다. 실행에는 카탈로그가 반환한 도구 버전을 사용합니다.
  - pricingobject필수
    공개 가격입니다. 현재 견적과 요금 규칙이 적용됩니다.
    
    pricing 하위 필드(9)
    schema_versioninteger선택 사항
    도구 가격 규칙 버전입니다.
    
    ruleunknown선택 사항
    선택한 도구의 스키마 또는 프로토콜이 정의하는 JSON 값입니다. 고정 필드를 가정하지 마세요.
    
    quote_requiredboolean필수
    새 실행 전에 견적을 확인해야 하는지 여부입니다.
    
    currencystring필수
    견적/요금 통화입니다.
    
    unitstring필수
    call은 호출당 또는 입력으로 사전 계산한 가격이고 usage는 최종 사용량 기반입니다. 정확한 의미는 mode를 참고하세요.
    
    amountstring선택 사항
    mode=flat에서는 0을 포함한 완전한 고정 USD 금액입니다. input/usage는 오해를 부르는 고정 금액을 노출하지 않습니다.
    
    price_versioninteger필수
    판매 가격 개정 버전입니다.
    
    modestring필수
    판매 가격 의미: flat은 고정 호출당 가격, input은 입력으로 사전 계산, usage는 최종 사용량 기반입니다. schema_version 데이터 형식과는 독립적입니다.
    
    열거형
    ["flat","input","usage"]
    requires_usageboolean필수
    플랫폼 정산 제약을 포함하여 최종 정산에 신뢰할 수 있는 사용량이 필요한지 여부입니다. 판매 가격 모드만으로 추정하지 마세요.
    
    allOf 분기 1
    유형: object
    이 분기의 필수 항목: currency, unit, price_version, mode, quote_required, requires_usage
    schema_versioninteger선택 사항
    도구 가격 규칙 버전입니다.
    
    ruleunknown선택 사항
    선택한 도구의 스키마 또는 프로토콜이 정의하는 JSON 값입니다. 고정 필드를 가정하지 마세요.
    
    quote_requiredboolean필수
    새 실행 전에 견적을 확인해야 하는지 여부입니다.
    
    currencystring필수
    견적/요금 통화입니다.
    
    unitstring필수
    call은 호출당 또는 입력으로 사전 계산한 가격이고 usage는 최종 사용량 기반입니다. 정확한 의미는 mode를 참고하세요.
    
    amountstring선택 사항
    mode=flat에서는 0을 포함한 완전한 고정 USD 금액입니다. input/usage는 오해를 부르는 고정 금액을 노출하지 않습니다.
    
    price_versioninteger필수
    판매 가격 개정 버전입니다.
    
    modestring필수
    판매 가격 의미: flat은 고정 호출당 가격, input은 입력으로 사전 계산, usage는 최종 사용량 기반입니다. schema_version 데이터 형식과는 독립적입니다.
    
    열거형
    ["flat","input","usage"]
    requires_usageboolean필수
    플랫폼 정산 제약을 포함하여 최종 정산에 신뢰할 수 있는 사용량이 필요한지 여부입니다. 판매 가격 모드만으로 추정하지 마세요.
countinteger필수

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선택 사항