# YesCaptcha Docs

> YesCaptcha est une API de reconnaissance de captchas : résolvez reCAPTCHA, hCaptcha, Cloudflare Turnstile, FunCaptcha, AWS WAF et les captchas image via une seule API JSON, avec un paiement par tâche et un remboursement automatique des tâches échouées ou expirées.

These pages are machine-translated from Chinese; the Chinese version prevails.

- Home: https://docs.yescaptcha.com/fr/index.md
- OpenAPI 3.1: https://docs.yescaptcha.com/openapi.json
- Data (JSON): https://docs.yescaptcha.com/data/task-types.json, https://docs.yescaptcha.com/data/error-codes.json, https://docs.yescaptcha.com/data/vip-levels.json
- Full text: https://docs.yescaptcha.com/fr/llms-full.txt

## Prise en main

- [Introduction](https://docs.yescaptcha.com/fr/getting-started/introduction.md): Qu'est-ce que YesCaptcha : résolvez reCAPTCHA, hCaptcha, Turnstile, FunCaptcha et les captchas d'images via une API ou une extension de navigateur. Facturation par tâche, remboursement automatique des tâches échouées.
- [Démarrage rapide](https://docs.yescaptcha.com/fr/getting-started/quickstart.md): Envoyez votre première requête YesCaptcha en 5 minutes : créez un compte, copiez votre ClientKey, rechargez votre solde, puis lisez un captcha image avec curl, Python ou Node.js (ImageToTextTaskOcrBase, synchrone, 2 points par image).
- [Endpoints](https://docs.yescaptcha.com/fr/getting-started/endpoints.md): Les deux endpoints de l'API YesCaptcha, l'endpoint mondial api.yescaptcha.com et l'endpoint Chine cn.yescaptcha.com. HTTPS POST avec JSON uniquement ; créez et interrogez une tâche sur le même endpoint.
- [Facturation et remboursements](https://docs.yescaptcha.com/fr/getting-started/billing.md): Comment YesCaptcha débite les points : 1,000 points = ¥1, selon le type de tâche ; les tâches échouées ou expirées sont remboursées automatiquement, les requêtes qui renvoient une erreur ne sont pas débitées ; le solde doit être supérieur à 10 points ; les signalements d'échec en reconnaissance d'images sont remboursés environ 24 heures plus tard.

## Référence de l'API

- [Requêtes et réponses](https://docs.yescaptcha.com/fr/api/overview.md): Conventions communes de l'API YesCaptcha : POST JSON, authentification par clientKey, format de réponse avec errorId, tâches synchrones et asynchrones, interrogation toutes les 5 secondes, délai maximal de 110 secondes, résultats conservés environ 10 minutes, langue des messages selon Accept-Language.
- [createTask — créer une tâche](https://docs.yescaptcha.com/fr/api/create-task.md): POST /createTask crée une tâche de reconnaissance de captcha : paramètres de la requête (clientKey, task, softID), ordre des vérifications, taskId renvoyé en asynchrone, solution renvoyée directement en synchrone. Le solde doit être supérieur à 10 points.
- [getTaskResult — récupérer le résultat](https://docs.yescaptcha.com/fr/api/get-task-result.md): POST /getTaskResult renvoie le résultat d'une tâche asynchrone. Interrogez toutes les 5 secondes, continuez d'attendre tant que le statut est processing, lisez solution quand il est ready, arrêtez en cas d'erreur ; une tâche dure environ 110 secondes au maximum, le résultat est conservé environ 10 minutes, les requêtes ne débitent aucun point.
- [getBalance : consulter le solde](https://docs.yescaptcha.com/fr/api/get-balance.md): POST /getBalance renvoie le solde du compte en points (1,000 points = ¥1) ainsi que les soldes de part développeur et de récompense de parrainage. Sans débit de points ; pratique pour vérifier votre ClientKey.
- [getSoftID — consulter votre ID développeur](https://docs.yescaptcha.com/fr/api/get-soft-id.md): POST /getSoftID renvoie votre ID développeur (softID) et le montant cumulé de votre part développeur ; ajoutez le softID aux requêtes createTask que votre logiciel envoie pour d'autres utilisateurs afin de percevoir une part.
- [report — signaler le résultat](https://docs.yescaptcha.com/fr/api/report.md): POST /report indique à YesCaptcha si les résultats des tâches étaient corrects ; signalez honnêtement les succès comme les échecs ; les tâches de reconnaissance d'images signalées comme échouées dans l'heure suivant leur création font l'objet d'un remboursement de points après environ 24 heures.
- [useragent — obtenir le User-Agent](https://docs.yescaptcha.com/fr/api/useragent.md): GET https://api.yescaptcha.com/useragent renvoie le User-Agent de navigateur à utiliser (texte brut). Le champ userAgent des tâches hCaptcha n'accepte que cette valeur.
- [Codes d'erreur](https://docs.yescaptcha.com/fr/api/errors.md): Tous les codes d'erreur de l'API YesCaptcha avec leur signification et la marche à suivre : format de la requête, compte et solde, tâches simultanées et suspension, résultat de la tâche, paramètres du site, images, proxy, serveur. Les requêtes qui renvoient une erreur ne sont pas débitées.
- [Limite de tâches simultanées et suspension automatique](https://docs.yescaptcha.com/fr/api/rate-limits.md): Limite de tâches simultanées de YesCaptcha (ERROR_THREADS_MAXIMUM, sans débit de points ni comptage pour la suspension), suspension automatique en cas d'erreurs trop nombreuses (100 par minute entraînent 5 minutes de suspension, ERROR_IP_BLOCKED_5MIN) et cache des paramètres invalides (cached).

## Types de tâches

- [Types de tâches et tarifs](https://docs.yescaptcha.com/fr/tasks.md): Tarifs de tous les types de tâches publics de YesCaptcha (en points, 1,000 points = ¥1) et mode de retour : token pour reCAPTCHA, hCaptcha et Turnstile, Cookie pour la page de vérification Cloudflare, résultat de reconnaissance pour le texte dans une image et la reconnaissance d'images.
- [reCAPTCHA v2](https://docs.yescaptcha.com/fr/tasks/recaptcha-v2.md): Obtenez des tokens reCAPTCHA v2 (version case à cocher, invisible et Enterprise) avec YesCaptcha : types de tâche et prix, paramètres de requête, exemples curl/Python/Node.js et format du résultat.
- [reCAPTCHA v3](https://docs.yescaptcha.com/fr/tasks/recaptcha-v3.md): Obtenez des tokens reCAPTCHA v3 (y compris Enterprise) avec YesCaptcha : comment renseigner pageAction, les types à score fixe 0.7 et 0.9, types de tâche et prix, paramètres, exemples et résultat renvoyé.
- [hCaptcha](https://docs.yescaptcha.com/fr/tasks/hcaptcha.md): Obtenez des tokens hCaptcha avec YesCaptcha : HCaptchaTaskProxyless, HCaptchaTaskProxylessM1 et HCaptchaTask avec votre propre proxy, comment renseigner userAgent et rqdata, et comment utiliser le respKey renvoyé.
- [Cloudflare Turnstile](https://docs.yescaptcha.com/fr/tasks/turnstile.md): Obtenez des tokens Cloudflare Turnstile avec YesCaptcha : TurnstileTaskProxyless, TurnstileTaskProxylessM1 et TurnstileTask avec votre propre proxy, paramètres, exemples et résultat renvoyé, et différence avec la page de vérification Cloudflare.
- [Page de vérification Cloudflare](https://docs.yescaptcha.com/fr/tasks/cloudflare-challenge.md): Passez la page de vérification « Just a moment... » de Cloudflare avec YesCaptcha et récupérez cf_clearance et les autres cookies, le User-Agent et le contenu de la page : paramètres de CloudFlareTaskS2 et CloudFlareTaskS3, exigences sur le proxy, résultat, utilisation du résultat et erreurs courantes.
- [Reconnaissance de texte dans une image](https://docs.yescaptcha.com/fr/tasks/image-to-text.md): Lisez les lettres et les chiffres d'une image avec YesCaptcha. ImageToTextTaskOcrBase et ImageToTextTaskMuggle renvoient le résultat de façon synchrone ; ImageToTextTask et ImageToTextTaskM1 sont asynchrones et gèrent la casse, les chiffres seuls, les opérations et la longueur ; modèles personnalisés disponibles.
- [Reconnaissance d'images reCAPTCHA v2](https://docs.yescaptcha.com/fr/tasks/recaptcha-classification.md): Reconnaissez les défis d'images reCAPTCHA v2 avec YesCaptcha (ReCaptchaV2Classification) : envoyez une image 3x3, 4x4 ou 1x1 avec l'ID de la question et recevez de façon synchrone les cases à cliquer ; tarif selon la taille de l'image ; table des ID de questions.
- [Reconnaissance d'images hCaptcha](https://docs.yescaptcha.com/fr/tasks/hcaptcha-classification.md): Reconnaissez les défis d'images hCaptcha avec YesCaptcha (HCaptchaClassification) : sélection dans une grille, clic sur une position, glisser vers une position et questions animées ; réponse synchrone, sans débit de points quand aucune cible n'est trouvée.
- [Reconnaissance d'images FunCaptcha](https://docs.yescaptcha.com/fr/tasks/funcaptcha-classification.md): Reconnaissez les épreuves d'images FunCaptcha (Arkose Labs) avec YesCaptcha (FunCaptchaClassification) : envoyez l'image de l'épreuve (grille de 6 images ou épreuve à flèches en deux moitiés) et la question en anglais, puis obtenez de façon synchrone l'image à choisir ; tous les types d'épreuves sont pris en charge.
- [Reconnaissance d'images AWS WAF / bCaptcha](https://docs.yescaptcha.com/fr/tasks/aws-bcaptcha-classification.md): Reconnaissez les captchas en grille 3×3 d'AWS WAF CAPTCHA et de bCaptcha avec YesCaptcha (AwsClassification, bCaptchaClassification) : envoyez l'image entière et la question, et obtenez de façon synchrone les cases à cliquer.

## Extension de navigateur

- [YesCaptcha Assistant](https://docs.yescaptcha.com/fr/extension.md): YesCaptcha Assistant (extension de navigateur) : reconnaît et clique automatiquement les captchas reCAPTCHA, hCaptcha, FunCaptcha, AWS WAF et autres dans Chrome et Firefox. L'extension est gratuite ; vous payez les appels API qu'elle utilise. Liens des boutiques, téléchargement des paquets et vidéos d'installation pour Chrome, BitBrowser et Kiwi Browser.

## Guides

- [Identifier le type de captcha](https://docs.yescaptcha.com/fr/guides/identify-captcha.md): Comment savoir quel captcha utilise une page (reCAPTCHA v2, v2 invisible, v3, Enterprise, hCaptcha, différence entre Cloudflare Turnstile et la page de vérification Cloudflare) et quel type de tâche YesCaptcha utiliser.
- [Trouver les paramètres reCAPTCHA](https://docs.yescaptcha.com/fr/guides/find-recaptcha-parameters.md): Comment trouver le websiteKey (sitekey) de reCAPTCHA, le websiteURL, le pageAction de v3 et la fonction de rappel dans les onglets Network, Sources et Console des outils de développement, avec un script de recherche automatique.
- [Trouver les paramètres hCaptcha](https://docs.yescaptcha.com/fr/guides/find-hcaptcha-parameters.md): Comment trouver le websiteKey (sitekey) d'hCaptcha, le websiteURL et le rqdata de la version Enterprise : cherchez data-sitekey dans le code source de la page, ou les requêtes checksiteconfig et getcaptcha dans l'onglet Network.
- [Trouver les paramètres Turnstile](https://docs.yescaptcha.com/fr/guides/find-turnstile-parameters.md): Comment trouver le websiteKey (sitekey, commençant par 0x) et le websiteURL de Cloudflare Turnstile : cherchez data-sitekey ou turnstile.render dans le code source de la page, ou consultez les requêtes challenges.cloudflare.com dans l'onglet Network.
- [Utiliser un token pour valider un reCAPTCHA](https://docs.yescaptcha.com/fr/guides/submit-recaptcha-token.md): Que faire d'un token reCAPTCHA (gRecaptchaResponse) : principe, envoi direct d'une requête (champ g-recaptcha-response), remplissage dans le navigateur avec appel du callback, avec des exemples Python complets sur la page de démonstration de Google.
- [Clic automatique sur les images reCAPTCHA v2 avec Selenium](https://docs.yescaptcha.com/fr/guides/recaptcha-click-selenium.md): Utilisez Python, Selenium 4 et ReCaptchaV2Classification pour cliquer sur les images d'un reCAPTCHA v2 dans un vrai navigateur : déclenchez le captcha, lisez la question et l'image, appelez l'API, cliquez sur les cases et validez. Code d'exemple complet.
- [Clic sur hCaptcha par reconnaissance d'images avec Selenium](https://docs.yescaptcha.com/fr/guides/hcaptcha-click-selenium.md): Utilisez Python, Selenium 4 et HCaptchaClassification pour résoudre les grilles d'images 3×3 de hCaptcha dans un vrai navigateur : cliquer sur la case, lire la question et les 9 images, appeler l'API de reconnaissance, cliquer et valider. Code d'exemple complet.

## Exemples de code

- [Exemples de code et SDK](https://docs.yescaptcha.com/fr/samples.md): Exemples de code YesCaptcha exécutables (Python, Node.js, curl, C#, Easy Language) et SDK communautaires non officiels (Python, Node.js, Go).
- [Python](https://docs.yescaptcha.com/fr/samples/python.md): Exemples Python pour YesCaptcha : consulter le solde, lire un captcha image, une classe cliente réutilisable (création de tâche, interrogation périodique (polling) toutes les 5 secondes), contrôle des tâches simultanées avec asyncio, et envoi de reCAPTCHA avec requests et Selenium.
- [Node.js](https://docs.yescaptcha.com/fr/samples/nodejs.md): Exemples Node.js pour YesCaptcha (Node.js 18+ avec le fetch intégré, sans dépendance) : consulter le solde, lire un captcha image, et une classe client réutilisable (création de tâche, interrogation périodique toutes les 5 secondes).
- [C#](https://docs.yescaptcha.com/fr/samples/csharp.md): Exemple C# pour YesCaptcha (.NET 6+, HttpClient et System.Text.Json) : consultez le solde, puis créez une tâche reCAPTCHA v2 et interrogez le résultat toutes les 5 secondes.
- [Easy Language (易语言)](https://docs.yescaptcha.com/fr/samples/easy-language.md): Exemples YesCaptcha en Easy Language (易语言) fournis par des utilisateurs : clics simulés pour reCAPTCHA et hCaptcha, reconnaissance d'images FunCaptcha, envoi de token reCAPTCHA ; téléchargements et points clés pour appeler l'API.

## Compte

- [Plusieurs ClientKey : limites, liste blanche d'IP et expiration](https://docs.yescaptcha.com/fr/account/client-keys.md): Un compte YesCaptcha peut avoir jusqu'à 20 ClientKey, qui débitent toutes le même solde. Chacune peut avoir sa propre limite de dépenses (par jour, par semaine, par mois ou en total unique, remise à zéro à l'heure de Pékin), sa liste blanche d'IP et son expiration, appliquées en quelques secondes.
- [Recharge et VIP](https://docs.yescaptcha.com/fr/account/recharge.md): Comment recharger YesCaptcha (WeChat Pay, Alipay, PayPal, cryptomonnaies) ; 1,000 points = ¥1. Votre recharge cumulée vous fait passer automatiquement de VIP 1 à VIP 10, puis chaque recharge suivante reçoit des points bonus.
- [Programme de parrainage](https://docs.yescaptcha.com/fr/account/referral.md): Programme de parrainage YesCaptcha. Les utilisateurs parrainés obtiennent un niveau VIP dès l'inscription (votre niveau moins 1, de VIP 1 à VIP 6), et vous recevez 20% de leurs dépenses (10% chacun lorsqu'une part développeur s'applique aussi), à convertir en solde ou à retirer dès ¥100 depuis le tableau de bord.
- [Part développeur](https://docs.yescaptcha.com/fr/account/developer.md): Part développeur YesCaptcha : ajoutez votre softID dans les requêtes que votre logiciel ou votre extension envoie pour ses utilisateurs et recevez 20% de leurs dépenses (10% chacun lorsqu'un parrain est aussi concerné) ; convertissez-la en solde ou retirez-la dès ¥100 dans le tableau de bord.

## Aide

- [FAQ](https://docs.yescaptcha.com/fr/help/faq.md): Questions fréquentes sur YesCaptcha : débit de points en cas d'échec, durée de validité d'un token, taux de réussite, reconnaissance humaine ou automatique, risque de blocage de compte, utilisation d'un même ClientKey à plusieurs endroits, choix de l'endpoint, extension ou API.
- [Problèmes de connexion et de réseau](https://docs.yescaptcha.com/fr/help/troubleshooting.md): Que faire quand vous ne parvenez pas à joindre l'API YesCaptcha : Failed to establish a new connection, échec de résolution DNS, interférence d'un logiciel de proxy, erreurs SSL (Certificate has expired, SSLEOFError) et étapes de diagnostic.
- [Nous contacter](https://docs.yescaptcha.com/fr/help/contact.md): Contactez le support YesCaptcha par WeChat, QQ, WhatsApp, LINE, Telegram @yescaptcha_official ou e-mail yescaptcha@gmail.com, de 9:00 à 21:00 UTC+8.
- [Journal des modifications du service](https://docs.yescaptcha.com/fr/changelog.md): Les changements qui concernent les utilisateurs de YesCaptcha, par date : types de tâche ajoutés et retirés, règles de facturation et de remboursement, limite de tâches simultanées, migration de la documentation. Journal tenu à partir d'octobre 2026.

## Other languages

- [简体中文](https://docs.yescaptcha.com/zh/llms.txt)
- [English](https://docs.yescaptcha.com/en/llms.txt)
- [日本語](https://docs.yescaptcha.com/ja/llms.txt)
- [한국어](https://docs.yescaptcha.com/ko/llms.txt)
- [Русский](https://docs.yescaptcha.com/ru/llms.txt)
- [Español](https://docs.yescaptcha.com/es/llms.txt)
- [Português](https://docs.yescaptcha.com/pt/llms.txt)
- [Tiếng Việt](https://docs.yescaptcha.com/vi/llms.txt)
- [Deutsch](https://docs.yescaptcha.com/de/llms.txt)
- [Türkçe](https://docs.yescaptcha.com/tr/llms.txt)
- [Bahasa Indonesia](https://docs.yescaptcha.com/id/llms.txt)
- [ไทย](https://docs.yescaptcha.com/th/llms.txt)