テキストCAPTCHAsolverAPI
APIの稼働状況
- 24時間の稼働状況
- 正常
- 24時間の平均応答時間
- —
- 良好/正常
- 利用可能
- 制限あり
- ほぼ停止
過去24時間
過去30日間
EverySolveのテキストCAPTCHA APIは、チャレンジ処理に使用するtextを返します。typeをtext_captchaに設定し、以下の入力項目を指定してPOST /api/v1/captchaに送信してください。テキストCAPTCHAは文章による質問と回答の形式で、ホスト型ウィジェットのベンダーではなく、フォーラムやCMSが提供していることが一般的です。 回答テキストを返します。画像内の文字にはimage、音声によるチャレンジにはaudioを使用してください。
1,000回の解決成功あたり$0.83(解決成功1回につき$0.000833)。解決に失敗した場合は課金されません。
AIプロンプト
EveryInfraの「テキストCAPTCHA」APIを呼び出すスクリプトの作成を手伝ってください。
APIの仕様:
- リクエスト:POST https://api.everyinfra.com/api/v1/captcha、ヘッダーはAuthorization: Bearer <API Key>。キーは環境変数EVERYINFRA_API_KEYから読み込み、コードには直接書かないでください。
- リクエストボディでは、typeをtext_captchaに設定し、パラメータを同じ階層に並べてください。
- 必須パラメータ:
- question: チャレンジに表示される、指示文または視覚タスクの指示をそのまま指定します。
- 任意パラメータ:
- language: 認識や文字起こしの処理に使う言語のヒントです。言語の検出や翻訳を保証するものではありません。(指定可能な値:en / ru)
- リクエストボディの例:
{
"type": "text_captcha",
"question": "If today is Monday, what day is tomorrow?"
}
- 課金:1,000回の解決成功あたり$0.83(解決成功1回につき$0.000833)。解決に失敗した場合は課金されません。
- 422の場合は、エラーに含まれる提案と指定可能な値をもとにパラメータを修正してください。429または503の場合は、Retry-Afterで指定された時間だけ待ってから再試行してください。
コードを書く前に、処理する件数と結果の保存形式を私に確認し、そのうえで、計画と概算費用について私の了承を得てください。リクエストパラメータ
| 名前 | 場所 | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|---|
Authorization | header | string | はい | - | Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。 |
type | body | string | はい | text_captcha | CAPTCHAの種類です(固定値)。 |
question | body | string | はい | - | チャレンジに表示される、指示文または視覚タスクの指示をそのまま指定します。 |
language | body | string (enum) | いいえ | - | 認識や文字起こしの処理に使う言語のヒントです。言語の検出や翻訳を保証するものではありません。指定可能な値enru |
コードサンプル
curl -X POST 'https://api.everyinfra.com/api/v1/captcha' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"type": "text_captcha",
"question": "If today is Monday, what day is tomorrow?"
}'OpenAPI定義(JSON)サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。
レスポンス例
October 24, 2026 at 22:39(UTC)に、上記のコードサンプルのパラメータでこのAPIを呼び出して取得しました。tokenとsolutionはその呼び出しの実際のレスポンスです。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。
{
"id": "req_…",
"type": "text_captcha",
"token": "tuesday",
"solution": {
"text": "tuesday"
},
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}テキストCAPTCHAのパラメータの取得元
questionパラメータには、表示されている文言を正確にそのまま指定してください。languageは回答用の任意のヒントであり、画像OCRの設定ではありません。
テキストCAPTCHAの見分け方
テキストCAPTCHAは文章による質問と回答の形式で、ホスト型ウィジェットのベンダーではなく、フォーラムやCMSが提供していることが一般的です。
テキストCAPTCHAの特徴
回答テキストを返します。画像内の文字にはimage、音声によるチャレンジにはaudioを使用してください。
テキストCAPTCHA APIの使い方
テキストCAPTCHA APIはtextでtextを返します。ソリューションの形式はtextです。 返されたテキストをチャレンジの解答として使用します。
- 01GET /api/v1/captcha/typesを取得し、
text_captchaのエントリを選択します。 - 02
type: "text_captcha"と必須パラメータをPOST /api/v1/captchaに送信します。 - 03
textからtextを読み取ります。 - 04返されたテキストをチャレンジの解答として使用します。
課金と提供状況 EverySolveはソリューションを正常に返した場合のみ課金します。失敗した試行では最終的な課金は発生せず、仮押さえされた金額は自動的に戻ります。availableと価格フィールドはページ上の固定情報とみなさず、リクエスト時にGET /api/v1/captcha/typesから取得してください。
テキストCAPTCHAの連携に関するよくある質問
タイプを選ぶ前に、テキストCAPTCHAかどうかを見分けるにはどうすればよいですか?
テキストCAPTCHAは文章による質問と回答の形式で、ホスト型ウィジェットのベンダーではなく、フォーラムやCMSが提供していることが一般的です。 text_captchaは、これらのシグナルが対象のチャレンジと一致することを確認してから使用してください。
テキストCAPTCHAリクエストには、対象ページのどの値を含めればよいですか?
questionパラメータには、表示されている文言を正確にそのまま指定してください。languageは回答用の任意のヒントであり、画像OCRの設定ではありません。 questionを指定してください。 任意パラメータはlanguageです。
テキストCAPTCHAは何を返しますか?また、混同してはいけないものは何ですか?
テキストCAPTCHA APIはtextでtextを返します。ソリューションの形式はtextです。 回答テキストを返します。画像内の文字にはimage、音声によるチャレンジにはaudioを使用してください。
テキストCAPTCHAの連携について説明している外部資料はどれですか?
特定のベンダーはありません。phpBBの公式ソースは、CMSの質問応答型CAPTCHAに関する一次情報の一例です。[テキストCAPTCHAのリファレンスを開く](https://github.com/phpbb/phpbb/blob/master/phpBB/phpbb/captcha/plugins/qa.php)。EverySolve固有のフィールドとリアルタイムの提供状況は、引き続きタイプカタログで確認してください。
テキストCAPTCHAのリファレンス
関連するCAPTCHAタイプ
エラーと課金
- 401
- キーが未指定か無効です。
- 402
- 残高が不足しています。先にチャージしてください。
- 422
- パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
- 429
- 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
- 503
- 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
- 200(空)
- データがありません。課金はされません。