Paiement à la résolution · API
1. Script masqué
Un script chargé avec la clé du site s’exécute en arrière-plan sur chaque page qui l’utilise. Le visiteur ne voit aucune case à cocher et n’effectue aucune action.
Un script chargé avec la clé du site s’exécute en arrière-plan sur chaque page qui l’utilise. Le visiteur ne voit aucune case à cocher et n’effectue aucune action.
D’après les données de comportement collectées, Google attribue au visiteur un score indiquant la probabilité qu’il s’agisse d’un humain. Le propriétaire du site choisit le seuil.
Le site compare le score à son propre seuil. En dessous, le site peut demander une vérification supplémentaire ou bloquer la requête.
grecaptcha.execute pour une action.success est true, que le score atteint le seuil et que l’action correspond. Un jeton valide avec un score bas peut quand même être rejeté.Les scores reCAPTCHA v3 vont de 0.0 (bot probable) à 1.0 (humain probable). Google suggère un seuil de 0.5. Observez le trafic réel avant de l’appliquer ou de l’ajuster.
Google prend en charge 11 niveaux de score. Essentials gratuit renvoie 0.1, 0.3, 0.7 et 0.9 ; la facturation débloque tous les niveaux et les codes de motif. Les scores en staging et la première semaine peuvent différer de la production.
Le paramètre CapMonster Cloud minScore (0.1–0.9) définit le score minimal du jeton. Alignez-le sur le seuil du site ; des valeurs élevées comme 0.9 augmentent les échecs.
pageAction doit correspondre à l’action dans grecaptcha.execute. Utilisez uniquement lettres, chiffres, barres obliques et underscores. Les sites peuvent rejeter les écarts. Passez minScore et pageAction.
Un test de score nécessite un backend : le score arrive dans la réponse siteverify.
1. Sur une page de test, utilisez votre clé de site et appelez grecaptcha.execute avec une action.
2. Envoyez le jeton et la clé secrète depuis votre backend vers https://www.google.com/recaptcha/api/siteverify.
3. Comparez le score renvoyé à votre seuil et vérifiez l’action.
Essayez notre page démo reCAPTCHA v3 sans créer de page de test.
Le tableau indique le prix, le temps de réponse API et le taux de réussite de quatre services de résolution reCAPTCHA v3.
| Paramètre | CapMonster Cloud | 2Captcha | CapSolver | DeathByCaptcha |
|---|---|---|---|---|
Prix pour 1000 résolutions (à partir de) | $ 0.90 | $1.45 | $1.00 | $2.89 |
Temps de réponse API | ≤ 2 s | ≤ 2 s | < 3 s | ≤ 3 s |
Taux de réussite | jusqu’à 99% | ~77–92% | ~95–98% | ~64–90% |
Avertissement : 2Captcha, CapSolver et DeathByCaptcha sont des marques de leurs propriétaires respectifs. CapMonster Cloud n’est pas affilié à ces entités. Les métriques de performance et les comparaisons de prix reposent sur des données publiques et des benchmarks internes du 28.09.2026.
$0.10
Les nouveaux utilisateurs reçoivent $0.10 de solde d’essai pour essayer CapMonster Cloud.
1. Inscrivez-vous sur CapMonster Cloud.
2. Contactez le support via le chat en direct ou support@capmonster.cloud avec l’e-mail lié à votre compte.
CapMonster Cloud accepte les paramètres du captcha, les traite sur ses serveurs et renvoie un jeton prêt à l’emploi. Insérez ce jeton dans le formulaire pour passer la vérification sans interaction utilisateur. La tâche RecaptchaV3TaskProxyless s’exécute sur les serveurs proxy de CapMonster Cloud, vous n’avez donc pas à transmettre de paramètres proxy.
À cette étape, vous transmettez votre clé API, le type de captcha et ses paramètres. Le service renvoie un taskId unique, qui permettra d’obtenir ultérieurement le résultat.
Dans la requête pour résoudre reCAPTCHA v3, vous devez indiquer les paramètres suivants :
| Paramètre | Description |
|---|---|
typestringObligatoire | RecaptchaV3TaskProxyless |
websiteURLstringObligatoire | l’adresse de la page sur laquelle le captcha est résolu |
websiteKeystringObligatoire | l’identifiant de clé (sitekey) indiqué sur la page de votre site avec le captcha https://www.google.com/recaptcha/api.js?render=SITE_KEY6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob |
isEnterprisebooleanFacultatif | Pour reCAPTCHA v3 Enterprise, définissez isEnterprise: true dans RecaptchaV3TaskProxyless (true/false ou 1/0). CapMonster Cloud le traite comme RecaptchaV3EnterpriseTask. |
minScoredoubleFacultatif | peut avoir une valeur de 0.1 à 0.9 |
pageActionstringFacultatif | la valeur du paramètre action transmise par le widget ReCaptcha de Google. Valeur par défaut : verify grecaptcha.execute('site_key', {action: 'login_test'}) |
https://api.capmonster.cloud/createTask{
"clientKey": "API_KEY",
"task": {
"type": "RecaptchaV3TaskProxyless",
"websiteURL": "https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta",
"websiteKey": "6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob",
"minScore": 0.3,
"pageAction": "myverify"
}
}
{
"errorId":0,
"taskId":407533072
}
https://api.capmonster.cloud/getTaskResult{
"clientKey":"API_KEY",
"taskId": 407533072
}
{
"errorId": 0,
"status": "ready",
"solution": {
"gRecaptchaResponse": "3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKv…hKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
}
}
{
"errorId": 0,
"status": "ready",
"solution": {
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36",
"gRecaptchaResponse": "0cAFcWeA5Y3...hF8UWA",
"cookies": {
"nocookies": "true"
}
}
}userAgent. Utilisez ce UserAgent pour envoyer le jeton ou confirmer la solution, même s’il diffère de celui de votre navigateur ou script.userAgent. Utilisez ce UserAgent pour envoyer le jeton ou confirmer la solution, même s’il diffère de celui de votre navigateur ou script.Une tâche reCAPTCHA v3 nécessite la clé du site (websiteKey) et le nom de l’action (pageAction).
1. Faites un clic droit sur la page et choisissez Inspect.
2. Dans Elements ou Network, trouvez api.js?render=SITE_KEY. La valeur après render= est websiteKey. reCAPTCHA Enterprise utilise enterprise.js?render=SITE_KEY.
3. Trouvez grecaptcha.execute('SITE_KEY', {action: 'ACTION'}). ACTION est pageAction. Enterprise utilise grecaptcha.enterprise.execute. Si omis, la tâche utilise verify par défaut.
4. Interceptez grecaptcha.execute dans un navigateur headless comme Playwright pour collecter les deux valeurs. Voir des exemples JavaScript, Python et C# dans la documentation CapMonster Cloud.
import asyncio
from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import RecaptchaV3ProxylessRequest
client_options = ClientOptions(api_key="YOUR_API_KEY") # Indiquez votre clé API CapMonster Cloud
cap_monster_client = CapMonsterClient(options=client_options)
# Si nécessaire, vous pouvez vérifier le solde
balance = asyncio.run(cap_monster_client.get_balance())
print("Balance:", balance)
recaptcha_v3_request = RecaptchaV3ProxylessRequest(
websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta", # URL de votre page avec le captcha
websiteKey="6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob", # Remplacez par une valeur correcte
minScore=0.7, # Seuil minimal du score de confiance
pageAction="myverify" # Action sur la page
)
async def solve_captcha():
return await cap_monster_client.solve_captcha(recaptcha_v3_request)
responses = asyncio.run(solve_captcha())
print(responses)Exécutez les parcours d’inscription, de paiement et de formulaires en CI/CD avec Playwright, Puppeteer ou Selenium sur des pages que vous possédez ou êtes autorisé à tester.
Vérifiez que les formulaires et endpoints protégés restent opérationnels après les releases et les changements de seuil.
Collectez des données publiques sur des pages ouvertes avec des contrôles basés sur le score.
Prenez en charge des workflows d’assistance automatisés sur des sites à contrôles anti-bots invisibles.
Un agent peut demander un jeton via MCP lorsqu’un scénario atteint un captcha.
Utilisez CapMonster Cloud pour des données publiques et sur des sites que vous possédez ou êtes autorisé à tester. La collecte de données tierces derrière un login ou un paywall sans autorisation est interdite.
reCAPTCHA Enterprise utilise des contrôles basés sur le score : Essentials renvoie quatre niveaux.
Premium et Enterprise en renvoient 11, avec des raisons d’explicabilité de base et avancées respectivement.
Pour reCAPTCHA v3 Enterprise, définissez isEnterprise: true dans RecaptchaV3TaskProxyless (true/false ou 1/0). CapMonster Cloud le traite comme RecaptchaV3EnterpriseTask.
POST https://www.google.com/recaptcha/api/siteverify secret=YOUR_SECRET_KEY response=TOKEN
Sur votre site, envoyez secret et response à https://www.google.com/recaptcha/api/siteverify. Les jetons expirent en 2 minutes et ne fonctionnent qu’une fois. Vérifiez success, score et action ; Google suggère un seuil de 0.5.
Voir Captcha API (Google reCAPTCHA v3) pour des exemples Node.js et Python, la gestion des erreurs et les actions basées sur le score.
Python SDK
secretSecret keymissing-input-secretLe paramètre secret est manquant
secretSecret keyinvalid-input-secretLe paramètre secret est invalide ou mal formé
responseTokenmissing-input-responseLe jeton est manquant
responseTokeninvalid-input-responseLe jeton est invalide ou mal formé
requestRequestbad-requestLa requête est invalide ou mal formée
responseDurée de vie du tokentimeout-or-duplicateLe jeton est trop ancien ou a déjà été utilisé
reCAPTCHA v2reCAPTCHA v3· actuellereCAPTCHA v2 EnterprisereCAPTCHA v3 Enterprise
GeeTest
Cloudflare TurnstileCloudflare Bot Challenge
DataDome
Tencent CAPTCHA
Amazon Waf
Faucet Pay
Imperva (Incapsula)
Prosopo
Text CAPTCHA
BinanceComplexImageTask Recaptcha
ComplexImageTask RecognitionreCAPTCHA Enterprise (Spotify, Yahoo)
Yidun
MTCaptcha
Altcha
Funcaptcha
TSPD
Hunt
Alibaba
Friendly
Documentation reCAPTCHA v3 (EN) →Documentation reCAPTCHA v3 Enterprise (EN) →Comment résoudre ReCaptcha v3 en Python avec Selenium & CapMonster Cloud (EN) →Comment résoudre ReCaptcha v3 en JavaScript avec Selenium & CapMonster Cloud (EN) →Comment résoudre ReCaptcha v3 en C# avec Selenium & CapMonster Cloud (EN) →Captcha API (Google reCAPTCHA v3) : documentation et guide d’intégration pour les développeurs (EN) →Le paramètre minScore accepte des valeurs de 0.1 à 0.9 et indique à CapMonster Cloud le score de confiance minimum que le jeton retourné doit porter. 0.3 est un point de départ raisonnable. Une valeur trop élevée (par ex. 0.9) augmente le risque d'échecs de résolution ; une valeur trop basse peut renvoyer des jetons dont le score serait de toute façon rejeté par votre seuil côté serveur. Ajustez la valeur selon les taux de rejet réels dans votre environnement de test.
Ouvrez la page et recherchez api.js?render=SITE_KEY dans l’inspecteur. La valeur après render= est le sitekey. L’action figure dans grecaptcha.execute(siteKey, {action: "..."}). Playwright permet de capturer cet appel automatiquement. Certaines valeurs changent à chaque chargement : créez la tâche juste après leur collecte. Consultez les étapes détaillées.
1.0 indique une interaction très probablement légitime et 0.0 un bot probable. Google recommande 0.5 comme seuil par défaut. Le bon score dépend du seuil du site. Réglez minScore sur ce seuil et adaptez-le au trafic réel. Comment vérifier un score.
Un jeton reçu de reCAPTCHA v3 est valide environ 2 minutes. Votre pipeline d'automatisation doit soumettre le jeton au serveur dans ce délai ; après expiration, l'endpoint siteverify de Google renvoie success: false. Gardez l'étape de résolution aussi proche que possible de l'envoi du formulaire et évitez de mettre en cache les jetons entre les requêtes.
Chaque token ne peut être vérifié qu’une seule fois. Un token expiré ou déjà utilisé entraîne timeout-or-duplicate. Demandez un nouveau token pour chaque envoi.
Pour injecter un jeton reCAPTCHA v3, trouvez le champ de réponse caché (généralement un textarea ou input avec l'ID g-recaptcha-response) et insérez-y le jeton obtenu auprès de votre service de résolution CAPTCHA. Voici comment procéder dans les trois frameworks d'automatisation.
Playwright / Puppeteer (Node.js)
const token = "YOUR_TOKEN";
await page.evaluate((t) => {
document.getElementById('g-recaptcha-response').value = t;
}, token);
await page.click('#submit-btn');Selenium (Python)
token = "YOUR_TOKEN"
driver.execute_script(f"document.getElementById('g-recaptcha-response').value = '{token}';")
driver.find_element("id", "submit-btn").click()Certaines sites utilisent des fonctions callback pour valider le jeton. Si le formulaire ne s'envoie pas, trouvez le nom de la fonction via la console (___grecaptcha_cfg.clients) et appelez-la manuellement :
await page.evaluate((t) => {
window.onSuccessCallback(t);
}, token);Une réponse success: true de Google signifie seulement que le jeton est valide. Votre backend peut tout de même rejeter la requête si le score du jeton est inférieur à votre seuil configuré.
Un autre problème fréquent est une discordance d'action. Le jeton doit être vérifié avec la même valeur action que celle utilisée lors de la création de la tâche.
Pour diagnostiquer le problème :
Si success est true, le tableau error-codes est généralement vide — score et action sont alors les champs principaux à examiner.
Oui. Ajoutez isEnterprise: true à la tâche reCAPTCHA v3 (valeurs acceptées : true/false ou 1/0). Elle est traitée comme RecaptchaV3EnterpriseTask. Consultez la section ci-dessus et la documentation de l’API.
Aucun outil ne peut garantir un taux de réussite de 100 % face à des protections évolutives, mais CapMonster Cloud offre un taux de réussite élevé pour reCAPTCHA v3. Ces résultats reposent sur les tests comparatifs internes mensuels de l’équipe CapMonster Cloud. Le temps de réponse réel de l’API et le taux de réussite varient selon le site cible, la charge du serveur et les conditions du réseau.
reCAPTCHA est une marque de Google LLC. CapMonster Cloud n’est ni affilié à Google ni approuvé par Google. Le service est destiné aux données publiques, aux tests de sites vous appartenant ou pour lesquels vous avez une autorisation, à la reconnaissance d’images et à l’accessibilité. La collecte sans autorisation de données de tiers protégées par une connexion ou un accès payant est interdite ; vos propres comptes ne sont pas concernés. Vous déterminez le statut juridique de vos données avant de commencer.