이제 가입하고 API 키를 직접 만들 수 있어요

계정을 만들고 대시보드에서 API 키를 발급해, 몇 분 안에 첫 태스크를 보내요.

받는 결과

• 대시보드의 API 키 페이지에서 키를 직접 만들고, 이름을 붙이고, 폐기합니다.
• 계정마다 활성 키를 5개까지 둘 수 있어, 앱, 환경, 팀원마다 키를 따로 씁니다.
• 키 하나로 API 전체를 씁니다. 같은 Bearer 키가 모든 엔드포인트에서 동작합니다.

동작 방식

로그인한 뒤 API 키 페이지에서 키를 만드세요. 전체 키는 만들 때 한 번만 표시되고 저장되는 것은 해시뿐이므로, 바로 비밀 관리 도구에 보관하세요. 이후 모든 요청은 Authorization 헤더에 이 키를 담습니다.

키를 폐기하면 몇 초 안에 적용되고, 다른 키는 그대로 동작합니다. 운영, 스테이징, 실험용 키를 나눠 두면 트래픽이 어디서 오는지 바로 보이고, 키를 하나씩 교체할 수 있습니다.

시작하기

1. querying.ai에 로그인하고 사이드바에서 API 키를 엽니다.
2. + 새 키를 누르고 키 이름에 production 같은 이름을 넣은 뒤 키 만들기를 누릅니다.
3. 키 복사를 눌러 비밀 관리 도구에 보관합니다. 전체 키는 이때 한 번 표시됩니다.
4. 키를 제한하려면 관리를 눌러 일일 크레딧 한도, 허용 엔진, 만료를 정합니다.
5. 키를 QUERYING_API_KEY 환경 변수로 지정하고 첫 요청을 보냅니다.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GEMINI",
    "payload": { "prompt": "best CRM for a small team", "country": "US" }
  }'

호출하면 내 계정의 대기열에 들어간 태스크가 돌아오고, 그 태스크는 활동에 나옵니다.

오류

MISSING_API_KEYHTTP 401

Authorization 헤더가 빠졌거나, 키가 잘못됐거나 만료 또는 폐기됐습니다.

KEY_SCOPE_DENIEDHTTP 403

키의 허용 엔진 밖의 엔진입니다. 다른 키를 쓰거나 키 관리에서 엔진을 추가하세요.

KEY_DAILY_CREDIT_LIMITHTTP 429

키가 일일 크레딧 한도를 다 썼습니다. Retry-After는 다음 UTC 자정까지입니다.