サインインしてAPIキーを自分で作成できるようになりました

アカウントを作成し、ダッシュボードでAPIキーを発行すれば、数分で最初のタスクを送信できます。

得られる結果

• ダッシュボードのAPIキーページで、キーの作成、命名、取り消しを自分で行えます。
• アカウントごとに有効なキーを5つまで持てるため、アプリ、環境、チームメンバーごとに別のキーを使えます。
• 1つのキーですべてに対応します。同じBearerキーがAPIのすべてのエンドポイントで使えます。

仕組み

サインインしてAPIキーページを開き、キーを作成します。キーの全体は作成時に一度だけ表示され、保存されるのはハッシュのみなので、すぐにシークレット管理ツールへ保管してください。以降のリクエストではAuthorizationヘッダーにこのキーを入れます。

キーの取り消しは数秒以内に反映され、他のキーはそのまま使えます。本番、ステージング、実験用にキーを分ければ、トラフィックの出どころがすぐにわかり、キーを1つずつ入れ替えられます。

使い方

1. querying.ai にサインインし、サイドバーの「APIキー」を開きます。
2. 「+ 新しいキー」を選び、「キー名」に production などの名前を入れて「キーを作成」を選びます。
3. 「キーをコピー」を選び、シークレット管理ツールに保管します。キー全体が表示されるのはこの1回です。
4. キーを制限するには「管理」を選び、「1日のクレジット上限」「許可するエンジン」「有効期限」を設定します。
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

キーが「1日のクレジット上限」に達しました。Retry-After は次の UTC 午前0時までです。