当社独自のアクセス統計は常に有効です。Google Analyticsは、公開ページ（ログイン後のワークスペースは対象外）の利用状況を把握するためのもので、許可をいただいた場合のみ有効になります。詳しくは プライバシーポリシーをご覧ください。

EveryInfra
検索⌘K
日本語
ログイン無料で始める

GeeTest CAPTCHAsolverAPI

POST

APIの稼働状況

24時間の稼働状況
正常
24時間の平均応答時間
—
  • 良好／正常
  • 利用可能
  • 制限あり
  • ほぼ停止
正常

EverySolveのGeeTest CAPTCHA APIは、チャレンジ処理に使用する名前付きの解答フィールドを返します。typeをgeetestに設定し、以下の入力項目を指定してPOST /api/v1/captchaに送信してください。GeeTestはCAPTCHA ID/サイトキーを使用し、アダプティブ、スライド、クリックなどの形式のチャレンジを表示できます。 結果は1つの汎用トークンではなく、captcha_id、lot_number、pass_token、gen_time、captcha_outputの5つのフィールドからなる検証セットです。

1,000回の解決成功あたり$2.08（解決成功1回につき$0.002083）。解決に失敗した場合は課金されません。

AIプロンプト

EveryInfraの「GeeTest CAPTCHA」APIを呼び出すスクリプトの作成を手伝ってください。

APIの仕様：
- リクエスト：POST https://api.everyinfra.com/api/v1/captcha、ヘッダーはAuthorization: Bearer <API Key>。キーは環境変数EVERYINFRA_API_KEYから読み込み、コードには直接書かないでください。
- リクエストボディでは、typeをgeetestに設定し、パラメータを同じ階層に並べてください。
- 必須パラメータ：
  - website_url: このチャレンジが表示されるページを正確に指定します。サイトのトップページだけでなく、該当するパスも含めてください。
  - website_key: 対象の実装からそのままコピーした公開サイトキーまたはウィジェットキーです。シークレットキーではありません。
- 任意パラメータ：
  - risk_type: initGeetest4に渡すriskType（slideやiconなど）です。ページで明示的に設定されている場合にのみ送信してください。誤った値を指定すると、別のチャレンジが要求されます。
- リクエストボディの例：
{
  "type": "geetest",
  "website_url": "https://gt4.geetest.com/",
  "website_key": "54088bb07d2df3c46b79f80300b0abbe",
  "risk_type": "slide"
}
- 課金：1,000回の解決成功あたり$2.08（解決成功1回につき$0.002083）。解決に失敗した場合は課金されません。
- 422の場合は、エラーに含まれる提案と指定可能な値をもとにパラメータを修正してください。429または503の場合は、Retry-Afterで指定された時間だけ待ってから再試行してください。

コードを書く前に、処理する件数と結果の保存形式を私に確認し、そのうえで、計画と概算費用について私の了承を得てください。

リクエストパラメータ

名前場所型必須デフォルト説明
Authorizationheaderstringはい-Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。
typebodystringはいgeetestCAPTCHAの種類です（固定値）。
website_urlbodystringはい-このチャレンジが表示されるページを正確に指定します。サイトのトップページだけでなく、該当するパスも含めてください。
website_keybodystringはい-対象の実装からそのままコピーした公開サイトキーまたはウィジェットキーです。シークレットキーではありません。
risk_typebodystringいいえ-initGeetest4に渡すriskType（slideやiconなど）です。ページで明示的に設定されている場合にのみ送信してください。誤った値を指定すると、別のチャレンジが要求されます。

コードサンプル

bash
curl -X POST 'https://api.everyinfra.com/api/v1/captcha' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "type": "geetest",
  "website_url": "https://gt4.geetest.com/",
  "website_key": "54088bb07d2df3c46b79f80300b0abbe",
  "risk_type": "slide"
}'

OpenAPI定義（JSON）サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。

レスポンス例

実際のレスポンス

October 24, 2026 at 22:42（UTC）に、上記のコードサンプルのパラメータでこのAPIを呼び出して取得しました。tokenとsolutionはその呼び出しの実際のレスポンスです。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。

json
{
  "id": "req_…",
  "type": "geetest",
  "solution": {
    "captcha_id": "54088bb07d2df3c46b79f80300b0abbe",
    "lot_number": "16b9dcb0b31a4d3c9dff2db8157dd7d8",
    "pass_token": "447676b283c3d1730b7d8a0369b47a97a0ce49a888439583a5db418e0ce1db88",
    "gen_time": "1792881725",
    "captcha_output": "K1IaJ9ya0bTODk_LLqK2sN5GN6_dAbrWUju7GGKmMewkDLoKP9r2yW6buayxzB-IOoEBmI_L6g7i5MkpyhO6b5XGXaAFFcFMr-pJjstLBLjSV1Q6QK3j7PTTVcqDEJCQvZhVV8ITwzoJFQiEtRxN-mngBD9FJCy9-DQxhkQb70Sf76b7CpuPlvCVjpn4DNKeheTeVA21IPuAG7PSIWV9R82D4XRvdYcNDq7Dyw1Dnvgi13VdIAXeSsn4BIgRP0ClCOt48e77BDoWytF8gWIdc5Qe…"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

GeeTest CAPTCHAのパラメータの取得元

対象の実装からGeeTestの識別子をwebsite_keyとしてコピーし、ウィジェットが表示される正確なページをwebsite_urlに指定してください。

ページ上でこれらの値を見つけるコード

geetest-1.bash
curl "https://gcaptcha4.geetest.com/load?captcha_id=<YOUR_ID>&challenge=11111111-2222-3333-4444-555555555555&client_type=web&callback=geetest_$(date +%s)000"

GeeTest CAPTCHAの見分け方

GeeTestはCAPTCHA ID/サイトキーを使用し、アダプティブ、スライド、クリックなどの形式のチャレンジを表示できます。

GeeTest CAPTCHAの特徴

結果は1つの汎用トークンではなく、captcha_id、lot_number、pass_token、gen_time、captcha_outputの5つのフィールドからなる検証セットです。

GeeTest CAPTCHA APIの使い方

GeeTest CAPTCHA APIはcaptcha_id、lot_number、pass_token、gen_time、captcha_outputで名前付きの解答フィールドを返します。ソリューションの形式はfieldsです。 宣言されたフィールドはまとめて読み取ってください。対象のワークフローでは、すべてのフィールドが揃っている必要がある場合があります。

  1. 01GET /api/v1/captcha/typesを取得し、geetestのエントリを選択します。
  2. 02type: "geetest"と必須パラメータをPOST /api/v1/captchaに送信します。
  3. 03captcha_id、lot_number、pass_token、gen_time、captcha_outputから名前付きの解答フィールドを読み取ります。
  4. 04宣言されたフィールドはまとめて読み取ってください。対象のワークフローでは、すべてのフィールドが揃っている必要がある場合があります。

課金と提供状況 EverySolveはソリューションを正常に返した場合のみ課金します。失敗した試行では最終的な課金は発生せず、仮押さえされた金額は自動的に戻ります。availableと価格フィールドはページ上の固定情報とみなさず、リクエスト時にGET /api/v1/captcha/typesから取得してください。

GeeTest CAPTCHAの連携に関するよくある質問

タイプを選ぶ前に、GeeTest CAPTCHAかどうかを見分けるにはどうすればよいですか？

GeeTestはCAPTCHA ID/サイトキーを使用し、アダプティブ、スライド、クリックなどの形式のチャレンジを表示できます。 geetestは、これらのシグナルが対象のチャレンジと一致することを確認してから使用してください。

GeeTest CAPTCHAリクエストには、対象ページのどの値を含めればよいですか？

対象の実装からGeeTestの識別子をwebsite_keyとしてコピーし、ウィジェットが表示される正確なページをwebsite_urlに指定してください。 website_urlとwebsite_keyを指定してください。 任意パラメータはrisk_typeです。

GeeTest CAPTCHAは何を返しますか？また、混同してはいけないものは何ですか？

GeeTest CAPTCHA APIはcaptcha_id、lot_number、pass_token、gen_time、captcha_outputで名前付きの解答フィールドを返します。ソリューションの形式はfieldsです。 結果は1つの汎用トークンではなく、captcha_id、lot_number、pass_token、gen_time、captcha_outputの5つのフィールドからなる検証セットです。

GeeTest CAPTCHAの連携について説明している外部資料はどれですか？

GeeTestは、CAPTCHA v4のWebクライアントとAPI連携をドキュメントで公開しています。[GeeTest CAPTCHAのリファレンスを開く](https://www.geetest.com/)。EverySolve固有のフィールドとリアルタイムの提供状況は、引き続きタイプカタログで確認してください。

GeeTest CAPTCHAのリファレンス

関連するCAPTCHAタイプ

すべてのCAPTCHAタイプ

エラーと課金

401
キーが未指定か無効です。
402
残高が不足しています。先にチャージしてください。
422
パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
429
1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
503
処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
200（空）
データがありません。課金はされません。

エラー