시작하기 전에
API 키가 필요합니다. 대시보드의 API 키 화면에서 만드세요. 새 계정은 무료 500 크레딧으로 시작합니다. 요금은 API 요금제와 크레딧에 있습니다.1. API 키 설정
2. 태스크 제출
Gemini에 질문해 봅니다.taskType은 엔진을 고르고, payload.prompt는 질문 내용입니다.
credits는 0입니다. 태스크 가격은 시작할 때 잔액에서 보류되었다가 완료되면 확정 차감되고, 실패하면 해제됩니다. 크레딧과 한도를 참고하세요.
GEMINI 같은 채팅 엔진은 payload.prompt를 읽습니다. GOOGLE_AIO, GOOGLE_AIMODE, 네이버 엔진, GOOGLE_SERP, GOOGLE_PLACES는 payload.query를 읽습니다. 각 엔진은 다른 필드로 대체해 읽으므로 둘 중 어느 쪽이든 동작합니다. 엔진이 읽는 payload 필드를 참고하세요.3. 결과 수집
- Webhook (권장)
- 폴링
제출할 때 엔드포인트는
webhook.url을 추가하세요. 태스크가 끝나면 querying.ai가 결과를 그 주소로 POST하므로 폴링할 필요가 없습니다.{ task, credits, response }를 받습니다. 모든 전달은 API 키에서 파생된 키로 서명되므로, 본문을 신뢰하기 전에 서명을 검증하세요. 서명, 재시도, 페이로드는 Webhook을 참고하세요.다음 단계
엔진 고르기
모든
taskType과 각 엔진이 반환하는 내용, 비용.배치와 그리드
요청당 최대 500개, 또는 하나의 배치로 10,000개까지 태스크를 제출합니다.
Webhook
페이로드, 서명 검증, 재시도.
크레딧과 한도
가격, 동시 실행 수, 일일 한도.