도구 실행 생성

flat 고정 호출당 가격, 입력으로 사전 계산하는 input 가격, 최종 사용량 기반 usage 가격을 통합 지원합니다. pricing.quote_required는 견적 필수 여부를, requires_usage는 비용 상한과 신뢰할 수 있는 최종 사용량 필요 여부를 결정합니다. 둘 다 schema_version으로 추정하지 않습니다. metered_pricing이 꺼지면 최종 사용량이 필요한 새 호출만 제한하며 최종 사용량이 불필요한 고정/입력 규칙은 계속 사용할 수 있습니다. 현재 키에 도구 권한이 있어야 하며 실행 식별 정보와 결과는 원래 키 범위로 제한됩니다. 도구 전체 스위치가 꺼지면 카탈로그가 비어 있으며 익명 카탈로그는 실행 권한이 아닙니다. 새 호출에는 비어 있지 않은 version/input과 Idempotency-Key가 필요합니다. 생성 응답을 잃어 run_id가 없다면 원래 API 키, 원래 Idempotency-Key와 원래 전체 요청 본문으로 이 작업을 재전송하여 기존 실행을 복구하세요. 새 견적을 받거나 비용 상한을 바꾸지 마세요. 접수된 실행의 재전송은 현재 스위치나 견적 만료에 의존하지 않습니다. run_id를 알면 원래 실행만 조회하세요. 결과가 불명확한 제출에 다른 키로 새 실행을 만들지 마세요.

견적 후 실행

도구 상세에서 정확한 버전, input_schema와 pricing을 조회하세요. mode=flat은 고정 호출당 가격, mode=input은 입력으로 사전 계산하는 가격, mode=usage는 최종 사용량 기반 가격입니다. 규칙의 schema_version은 저장 형식만 설명합니다.

quote_required=true인 새 호출은 먼저 견적을 받아야 합니다. 응답에 반환된 tool_id/version을 확인하고 quote_id와 원래 요청을 보관하세요. requires_usage=true이면 maximum_usd 이상인 max_cost_usd도 제공해야 합니다. 다른 실행에서는 비용 상한이 선택 사항이지만 제공하면 검사합니다. 최종 사용량이 불필요한 고정 가격 실행은 바로 실행할 수 있습니다. 입력 기반 가격 규칙은 견적이 필요하지만 최종 사용량 없이 정산할 수도 있습니다.

견적은 원래 소스를 고정합니다. 나중에 기본 소스가 바뀌어도 원래 소스와 설정이 유효하다면 원래 견적은 원래 소스를 계속 사용합니다. 아직 제출하지 않은 새 호출에서 quote_expired, quote_stale 또는 invalid_quote가 발생하면 입력을 확인하고 새 견적을 받을 수 있습니다. 실행에 성공했지만 요금이 reserved이면 최종 사용량을 계속 조회하세요. 출력 성공만으로 정산을 입증할 수는 없습니다.

잃어버린 응답 복구

전송 전에 원래 API 키 식별 정보, Idempotency-Key와 전체 요청 본문을 보관하세요. 생성 응답을 잃어 run_id가 없다면 같은 API 키, 같은 요청 키와 원래 전체 요청으로 POST /v1/tool-runs를 재전송하세요. 원래 quote_id와 max_cost_usd를 유지하고 새 견적을 받거나 키를 바꾸지 마세요. 기존 실행은 서비스을 다시 호출하지 않고 원래 기록을 우선 반환합니다. 이후 견적이 만료되거나 새 호출 스위치가 꺼져도 복구할 수 있습니다. run_id가 있으면 원래 실행만 GET으로 조회하세요.

멱등성 충돌 시 원래 요청을 대조하세요. 다른 유료 작업을 만들려고 키를 자동으로 바꾸지 마세요. 오류 처리, 요금과 비동기 복구를 참고하세요.

Authorization: Bearer $GLOOP_API_KEY