API 참조

도구 견적 받기

POST/v1/tools/{id}/quote

flat 고정 호출당 가격, 입력으로 사전 계산하는 input 가격, 최종 사용량 기반 usage 가격을 통합 지원합니다. pricing.quote_required는 견적 필수 여부를, requires_usage는 비용 상한과 신뢰할 수 있는 최종 사용량 필요 여부를 결정합니다. 둘 다 schema_version으로 추정하지 않습니다. metered_pricing이 꺼지면 최종 사용량이 필요한 새 호출만 제한하며 최종 사용량이 불필요한 고정/입력 규칙은 계속 사용할 수 있습니다. 현재 키에 도구 권한이 있어야 하며 실행 식별 정보와 결과는 원래 키 범위로 제한됩니다. 도구 전체 스위치가 꺼지면 카탈로그가 비어 있으며 익명 카탈로그는 실행 권한이 아닙니다. 경로의 id가 도구 식별 정보를 제공합니다. 공개 견적 본문에는 비어 있지 않은 필수 version과 input_schema에 맞는 input만 허용하며 tool_id, quote_id, max_cost_usd 등의 추가 필드는 거부합니다. 견적은 300초 동안 유효하며 동일한 키, 정확한 버전, 정규화된 입력과 가격/소스 설정에 연결됩니다. tool_id/version/maximum_usd를 반환하고 서비스에는 제출하지 않습니다.

인증과 권한

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

Authorization: Bearer $GLOOP_API_KEY

인증 방식: BearerAuth

요청

경로 매개변수

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

요청 본문 · application/json

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

요청 본문 필수

versionstring필수
비어 있지 않은 도구 계약 버전이 필수입니다. 상세의 정확한 버전을 사용하세요. 현재 버전을 기본으로 사용하지 않습니다.

최소 길이
1
패턴
".*\\S.*"
inputunknown필수
이 도구 버전의 input_schema를 통과해야 합니다. 정규 JSON만 허용하며 관리자 route_id 등의 추가 필드는 금지됩니다.

응답과 오류

HTTP 200

도구 견적 조회 성공

application/json

유형: object
필수 필드: quote_idmaximum_usdprice_versionexpires_atcomponentstool_idversion

quote_idstring필수
공개 견적 ID이며 생성 시 가격 및 요청 연결 조건을 충족해야 합니다.
maximum_usdstring필수
이 정규화된 입력의 최대 USD 예약액입니다.
price_versioninteger필수
판매 가격 개정 버전입니다.
expires_atinteger필수
Unix 초 단위 만료 시각입니다. 도구 견적은 300초 동안 유효하며 실제 expires_at을 따릅니다.
componentsunknown필수
선택한 도구의 스키마 또는 프로토콜이 정의하는 JSON 값입니다. 고정 필드를 가정하지 마세요.
tool_idstring필수
이 견적에 연결된 도구 ID입니다.
versionstring필수
이 견적에 연결된 정확한 도구 계약 버전입니다.

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