크레딧과 한도: 가격, 보류, 동시 실행, 요청 속도 제한

curl https://api.querying.ai/v1/capabilities

​

태스크별 크레딧

​

Citation Analysis 계량

​

보류, 차감, 해제

​

잔액 확인

curl https://api.querying.ai/v1/credits \
  -H "Authorization: Bearer $QUERYING_API_KEY"

{
  "success": true,
  "remaining": 1879939,
  "perCycle": 1000000,
  "cycleResetsAt": "2026-11-14T07:37:57.000Z",
  "reserved": 61,
  "plan": "max",
  "topUpBalance": { "credits": 1000000, "nextExpiresAt": "2027-01-19T10:01:57.000Z", "nextCredits": 1000000 }
}

• remaining은 지금 쓸 수 있는 크레딧입니다. 이미 제출한 태스크의 가격은 reserved에 보류되어 있으니 다시 빼지 마세요.
• perCycle은 요금제가 주기마다 지급하는 크레딧이고, cycleResetsAt은 현재 주기가 끝나는 시각입니다. 활성 요금제가 없으면 둘 다 null입니다.
• topUpBalance는 remaining에 든 충전 크레딧과, 그중 가장 먼저 만료되는 날짜와 그날 만료되는 양을 알려 줍니다. 충전 크레딧이 없으면 null입니다. 충전 크레딧은 구매 후 3개월 동안 유지되고, 갱신 때 이월되며, 요금제 크레딧을 다 쓴 뒤에 사용됩니다.

​

사용량 확인

curl "https://api.querying.ai/v1/usage?from=2026-10-01&to=2026-10-20&groupBy=engine" \
  -H "Authorization: Bearer $QUERYING_API_KEY"

{
  "success": true,
  "data": {
    "from": "2026-10-01",
    "to": "2026-10-20",
    "groupBy": ["engine"],
    "credits": 66.25,
    "tasks": 65,
    "rows": [
      { "taskType": "CHATGPT", "credits": 49, "tasks": 49 },
      { "taskType": "GEMINI", "credits": 6.25, "tasks": 5 },
      { "taskType": "PERPLEXITY", "credits": 11, "tasks": 11 }
    ]
  }
}

• from과 to는 UTC 날짜이고 두 날짜가 모두 포함됩니다. 기본값은 이번 UTC 달의 첫날과 오늘이며, 범위는 최대 366일입니다.
• groupBy는 day, engine, key를 쉼표로 이어 받고 기본값은 day,engine입니다. 행에는 고른 기준의 필드가 담기고, 청구가 없는 조합은 행이 없습니다. 맨 위의 credits와 tasks는 모든 행의 합입니다.
• groupBy=key는 크레딧을 쓴 주체를 보여 줍니다. API 키로 보낸 태스크는 "source": "api"이고 키의 id, keyPrefix, name, subAccountId가 든 apiKey가 붙습니다. API 키가 없는 사용은 source가 monitor(모니터 실행), playground, dashboard 중 하나이고 apiKey는 null입니다.
• 사용량은 태스크에 청구된 크레딧을 합산하며, 실패한 태스크는 0입니다. 모니터의 경쟁사 분석은 태스크 없이 청구되므로 잔액은 줄지만 사용량에는 나타나지 않습니다.
• 하위 계정의 태스크도 내 사용량에 들어가며, apiKey.subAccountId가 키를 가진 하위 계정을 알려 줍니다. 하위 계정 하나는 GET /v1/sub-accounts/{id}/usage로 읽습니다. 하위 계정 키는 403 SUB_ACCOUNT_FORBIDDEN을 받습니다.

​

대기열 확인

curl https://api.querying.ai/v1/async/status \
  -H "Authorization: Bearer $QUERYING_API_KEY"

{
  "success": true,
  "queuedTasks": 19,
  "processingTasks": 6,
  "priorityBreakdown": [{ "priority": 8, "count": 3 }, { "priority": 1, "count": 16 }],
  "concurrency": { "used": 25, "max": 200 }
}

• concurrency.used는 queuedTasks와 processingTasks의 합이며, 요금제의 동시 실행 한도가 합쳐서 세는 두 값입니다. max가 그 한도이므로 max - used가 새 태스크를 넣을 수 있는 여유입니다.
• priorityBreakdown은 대기 중인 태스크를 제출할 때 보낸 priority별로, 높은 값부터 나열합니다.
• 집계에는 한도를 함께 쓰는 하위 계정의 태스크도 들어갑니다. 하위 계정 키는 403 SUB_ACCOUNT_FORBIDDEN을 받고, 자기 태스크 수는 GET /stats로 읽습니다.

​

요금제

​

요금제 동시 실행 한도

​

키별·하위 계정별 한도

​

요청 속도와 백프레셔

​

대량 제출 속도 조절