문서

API 참조

도구 계약 조회

GET/v1/tools/{id}

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

인증과 권한

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

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

경로 매개변수

  • idstring필수

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

쿼리 매개변수

  • versionstring선택 사항

    생략하면 현재 버전을 사용합니다. 실행 생성에는 카탈로그 버전을 지정해야 합니다.

응답과 오류

HTTP 200

도구 계약 조회 성공

application/json

유형
object
필수 필드
category_idcollection_idtagsidnamedescriptionversionpricinginput_schemaoutput_schemaread_only
  • 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필수

      플랫폼 정산 제약을 포함하여 최종 정산에 신뢰할 수 있는 사용량이 필요한지 여부입니다. 판매 가격 모드만으로 추정하지 마세요.

  • input_schemaunknown필수

    선택한 도구의 스키마 또는 프로토콜이 정의하는 JSON 값입니다. 고정 필드를 가정하지 마세요.

  • output_schemaunknown필수

    선택한 도구의 스키마 또는 프로토콜이 정의하는 JSON 값입니다. 고정 필드를 가정하지 마세요.

  • read_onlyboolean필수

    도구의 공개 계약이 선언하는 읽기 전용 속성이며 무료 또는 무인증 접근을 보장하지 않습니다.

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 키를 생성하거나 살펴보기: 기능.