메인 콘텐츠로 건너뛰기
모든 요청의 Authorization 헤더에 API 키를 보내세요.
키는 vt_로 시작합니다. 키는 만든 즉시 쓸 수 있습니다.

키 발급

  1. querying.ai에서 가입하세요. 새 계정은 무료 500 크레딧으로 시작합니다.
  2. 대시보드에서 API 키를 열고 키를 만드세요.
  3. 키가 표시될 때 복사해 환경 변수나 시크릿 관리자에 저장하세요.
한 계정에는 활성 키를 최대 5개까지 둘 수 있습니다. 계획된 교체를 위해 키 한 개를 추가할 자리를 남겨 두고, 클라이언트 전환 중에는 두 키를 모두 활성 상태로 유지합니다.
  1. 대시보드에서 필요한 엔진 범위, 일일 크레딧 한도, 만료일을 설정해 키를 추가로 만듭니다.
  2. 모든 호출 클라이언트와 webhook 서명 검증에 새 키를 반영하고 요청 성공을 확인합니다. 기존 키로 제출한 태스크의 webhook 검증을 위해 기존 서명 키도 보관합니다.
  3. 기존 키를 폐기합니다.
대시보드의 교체(rotate)는 같은 설정으로 새 키를 발급하고 기존 키를 즉시 폐기합니다. 이후 기존 키를 쓰는 요청은 401을 반환하므로 클라이언트가 새 키로 전환해야 요청을 재개할 수 있습니다.
키는 서버 측 코드에서만 사용하세요. 키를 가진 사람은 누구나 크레딧을 쓸 수 있습니다. 브라우저 앱, 모바일 앱, 공개 저장소에 포함하지 마세요.

키 설정

각 키에는 대시보드에서 지정하는 선택 설정이 있습니다. 계정 전체 한도는 크레딧과 한도를 참고하세요.

키가 필요한 엔드포인트

오류

키가 없거나, 형식이 잘못되었거나, 폐기 또는 만료되었으면 401을 반환합니다. 태스크, 배치, 리서치 엔드포인트에서는 코드가 MISSING_API_KEY입니다.
키가 폐기되거나 만료되기 전에 만든 태스크는 배치의 항목을 포함해 그대로 실행되고 청구됩니다. 전체 오류 목록: 오류.