메인 콘텐츠로 건너뛰기

시작하기 전에

API 키가 필요합니다. 대시보드의 API 키 화면에서 만드세요. 새 계정은 무료 500 크레딧으로 시작합니다. 요금은 API 요금제와 크레딧에 있습니다.

1. API 키 설정

키는 서버에만 보관하세요. 인증을 참고하세요.

2. 태스크 제출

Gemini에 질문해 봅니다. taskType은 엔진을 고르고, payload.prompt는 질문 내용입니다.
API가 태스크를 접수해 큐에 넣습니다. 예를 들면 다음과 같습니다.
제출 시 credits는 0입니다. 태스크 가격은 시작할 때 잔액에서 보류되었다가 완료되면 확정 차감되고, 실패하면 해제됩니다. 크레딧과 한도를 참고하세요.
GEMINI 같은 채팅 엔진은 payload.prompt를 읽습니다. GOOGLE_AIO, GOOGLE_AIMODE, 네이버 엔진, GOOGLE_SERP, GOOGLE_PLACES는 payload.query를 읽습니다. 각 엔진은 다른 필드로 대체해 읽으므로 둘 중 어느 쪽이든 동작합니다. 엔진이 읽는 payload 필드를 참고하세요.

3. 결과 수집

제출할 때 webhook.url을 추가하세요. 태스크가 끝나면 querying.ai가 결과를 그 주소로 POST하므로 폴링할 필요가 없습니다.
엔드포인트는 { task, credits, response }를 받습니다. 모든 전달은 API 키에서 파생된 키로 서명되므로, 본문을 신뢰하기 전에 서명을 검증하세요. 서명, 재시도, 페이로드는 Webhook을 참고하세요.

다음 단계

엔진 고르기

모든 taskType과 각 엔진이 반환하는 내용, 비용.

배치와 그리드

요청당 최대 500개, 또는 하나의 배치로 10,000개까지 태스크를 제출합니다.

Webhook

페이로드, 서명 검증, 재시도.

크레딧과 한도

가격, 동시 실행 수, 일일 한도.