API human-in-the-loop : confiez des tâches humaines à vos agents IA
Donnez des mains à votre agent IA : une API REST et un serveur MCP pour créer des tâches humaines dans 85 pays, recevoir captures, liens ou textes en preuve, puis valider ou refuser chacune. Compatible avec Claude Code et tout client MCP.
Par Romain, fondateur de Hitworkers · Mis à jour le · 7 min de lecture
Sans abonnement · Travail refusé = remboursé · De vraies personnes, avec preuve
Une API human-in-the-loop permet à un logiciel, et de plus en plus à un agent IA, d'envoyer une tâche à une vraie personne et de recevoir un résultat vérifiable. Les agents savent lire, écrire et appeler des outils, mais certaines étapes exigent encore un humain : chercher depuis un vrai téléphone dans un autre pays, tester un parcours d'inscription de bout en bout, enregistrer un échantillon de voix, vérifier une traduction, juger si une page est lisible ou publier depuis un vrai compte. Hitworkers transforme ces étapes en appels d'API. Votre agent crée une campagne avec des consignes, une rémunération et la preuve attendue ; de vrais workers dans 85 pays réalisent la tâche et renvoient capture, lien, fichier ou champs structurés ; l'agent relit chaque preuve et la valide ou la refuse. Tout est disponible en API REST et en serveur MCP, si bien que Claude Code et les autres clients MCP l'utilisent comme une boîte à outils. Documentation sur /docs, spécification OpenAPI sur /openapi.json et version texte pour les modèles de langage sur /llms.txt.
Comment ça marche
Créez une clé API dans votre espace client et ajoutez le serveur MCP à Claude Code en une commande, ou appelez l'API REST depuis votre code.
Il lit le catalogue, obtient un devis, puis crée la campagne : consignes, rémunération, pays, rythme et preuve exigée.
Il liste les preuves en attente, examine captures et textes, et valide ou refuse chacune avec un motif. Le travail refusé est remboursé.
Vous validez chaque envoi
Chaque worker joint une capture d'écran ou un lien. Vous validez en un clic ce qui est conforme — le travail refusé est remboursé, vous ne payez jamais une tâche hors cahier des charges.
Pourquoi les annonceurs l'utilisent
Outils MCP, OpenAPI, documentation en texte brut et écritures idempotentes : conçu pour être appelé par un logiciel.
Chaque tâche renvoie une preuve que l'agent contrôle avant de payer : l'étape humaine reste auditable dans un flux automatisé.
1 087 workers activés sur leurs propres appareils, pour les étapes qui exigent un vrai navigateur, un téléphone, un lieu ou un jugement.
Devis d'abord, budget réservé, seules les preuves validées payées, arrêt possible à tout moment.
Ce que human-in-the-loop veut dire pour un agent IA
Human-in-the-loop désigne habituellement un humain qui relit le travail d'un modèle. Avec les agents, la boucle tourne aussi dans l'autre sens : l'agent délègue une étape à une personne et relit son travail. Exemples typiques : les étapes qui exigent un vrai appareil ou un vrai lieu (chercher sur Google depuis le Kenya et capturer les résultats), les tests réels (s'inscrire sur notre préproduction depuis un téléphone et signaler ce qui casse), la perception humaine (cette miniature se lit-elle en petit ?), les contenus qui doivent venir de vrais comptes, ou la collecte de données qu'une personne fait en quelques minutes mais qu'un script ne fait pas de façon fiable. L'agent définit la tâche et la preuve, de vraies personnes l'exécutent, et l'agent garde la main en validant ou refusant chaque résultat.
- Vérifications sur appareil réel : résultats de recherche, rendu d'une page, comportement d'une app depuis un pays.
- Tests de bout en bout : inscriptions, paiements, formulaires, confirmations d'e-mail.
- Jugement humain : lisibilité, traductions, première impression, questionnaires courts.
- Tâches de données : collecte ou vérification d'informations publiques.
- Publication ou engagement depuis de vrais comptes, dans le respect des règles des plateformes.
Connecter Claude Code ou tout client MCP
Créez une clé API dans votre espace client Hitworkers ; elle commence par hw_live_ et ne s'affiche qu'une fois. Dans Claude Code, ajoutez le serveur MCP en une commande : claude mcp add --transport http hitworkers https://hitworkers.com/api/mcp --header "Authorization: Bearer hw_live_…" (en remplaçant par votre clé). Le serveur utilise le transport HTTP « Streamable » et la même clé que l'API REST. Vous pouvez ensuite demander en langage naturel, par exemple : lance Google SEO Boost sur ma page tarifs avec le mot-clé « crm pour startups », 100 recherches sur 5 jours ; ou relis les preuves de ma dernière campagne et refuse celles sans capture du commentaire. En HTTP classique, l'URL de base est https://hitworkers.com/api/v1, tout est en JSON et la limite est de 120 requêtes par minute, REST et MCP confondus.
- Endpoint MCP : https://hitworkers.com/api/mcp.
- URL de base REST : https://hitworkers.com/api/v1.
- Authentification : Authorization: Bearer hw_live_… à chaque requête.
- Documentation : /docs, /docs.md et /llms.txt (texte brut), /openapi.json.
Les outils dont dispose votre agent
Le serveur MCP expose 18 outils, calqués sur les endpoints REST. Un agent commence en général par get_catalog et get_account, chiffre le travail avec quote_campaign, lance avec create_campaign, puis enchaîne list_submissions, get_proof_file et review_submission.
| Outil MCP | Endpoint REST | Rôle |
|---|---|---|
| get_catalog | GET /catalog | Modèles, modèles simplifiés, audiences, prix et minimums |
| quote_campaign | POST /quote | Total exact et coût par tâche, sans rien créer |
| create_campaign | POST /campaigns | Créer une campagne ou un brouillon (budget réservé) |
| get_campaign | GET /campaigns/{id} | Statut, compteurs, questions de notre équipe, prix suggéré |
| campaign_action | POST /campaigns/{id}/actions | pause, reprise, arrêt, ajout de places, réponse, rythme |
| list_submissions | GET /campaigns/{id}/submissions | Preuves, par exemple au statut to_review |
| get_proof_file | GET /submissions/{id}/image | Capture ou fichier d'un worker, renvoyé comme image |
| review_submission | POST /submissions/{id}/review | Valider, refuser, demander une correction ou signaler |
Une boucle d'agent complète
Un agent fiable suit toujours la même boucle. Il lit le catalogue et le solde, demande un devis, puis crée la campagne avec une clé d'idempotence pour qu'un nouvel essai réseau ne crée ni ne facture rien en double. Notre équipe relit chaque campagne avant sa mise en ligne, généralement en quelques heures ; certains modèles partent immédiatement. Pendant ce temps, l'agent interroge la campagne : en ligne, refusée avec une note et remboursée, ou en attente d'une réponse à une question de notre équipe ou d'une rémunération suggérée à accepter. Une fois les workers lancés, l'agent consulte les preuves toutes les quelques heures, les compare aux consignes, télécharge les captures si besoin et valide ou refuse avec un motif clair. Les preuves non relues dans le délai de 24 ou 48 heures sont validées automatiquement. Quand il a assez de résultats, l'agent arrête la campagne et le budget inutilisé revient sur le solde.
Prix, délais et limites pour un agent
Un agent paie les mêmes prix que tout annonceur : rémunération du worker dès 0,15 $ plus 10 % de frais, +0,03 $ par capture supplémentaire, +0,30 $ par worker pour l'audience Best Workers ; les modèles simplifiés ont leurs prix tout compris dans le catalogue. Le budget est réservé à la création, seules les preuves validées sont facturées, et une réponse 402 avec need_usd signale un solde insuffisant. Le délai est la principale contrainte de conception : 10,1 minutes en médiane entre prise de tâche et preuve, et le premier worker arrive plus ou moins vite selon les pays, la rémunération et le rythme. Concevez l'agent pour créer, repasser plus tard et continuer, pas pour attendre sur un seul appel.
| Élément | Valeur |
|---|---|
| Coût minimum d'une tâche sur mesure | 0,165 $ (0,15 $ + 10 %) |
| Capture supplémentaire | +0,03 $ par tâche |
| Audience Best Workers | +0,30 $ par worker |
| Délai médian prise de tâche → preuve | 10,1 minutes |
| Délai de relecture avant validation automatique | 24 ou 48 heures |
| Limite de requêtes | 120 par minute (REST + MCP) |
| Taux de validation, toutes preuves relues | 93 % (13 478 sur 14 549) |
Garde-fous : ce qu'un agent peut demander, et ce qu'il ne doit pas
Placer des humains dans une boucle automatisée crée des responsabilités. Chaque campagne, qu'elle vienne du tableau de bord ou d'un agent, est relue par notre équipe avant sa mise en ligne, et les tâches illégales, pour adultes, de jeux d'argent, trompeuses ou de vente de comptes sont refusées. L'agent doit rédiger des étapes numérotées, une action par étape, et préciser ce que la preuve doit montrer et ce qui sera refusé. Jamais de mot de passe, de données de paiement ou de données personnelles au-delà du strict nécessaire, jamais de faux avis. Les tâches d'engagement et de trafic restent soumises aux règles des plateformes, comme celles de Google sur le spam et de YouTube sur l'engagement factice, qu'une personne ou un script réalise l'action. Enfin, gardez un responsable humain du budget de l'agent et consultez régulièrement le relevé.
Questions fréquentes
Qu'est-ce qu'une API human-in-the-loop ?
Une API qui permet à un logiciel ou à un agent IA d'envoyer une tâche à une vraie personne et de recevoir un résultat vérifiable (capture, lien, fichier ou réponses structurées), que l'agent relit avant de payer.
Comment connecter Hitworkers à Claude Code ?
Créez une clé API dans votre espace client, puis lancez : claude mcp add --transport http hitworkers https://hitworkers.com/api/mcp --header "Authorization: Bearer hw_live_…" avec votre clé. Claude Code peut alors créer des campagnes et relire les preuves en langage naturel.
Existe-t-il une API REST en plus du MCP ?
Oui. L'API REST (https://hitworkers.com/api/v1) couvre les mêmes fonctions, en JSON, avec clés d'idempotence et une spécification OpenAPI sur /openapi.json. La documentation en texte brut pour les modèles est sur /llms.txt.
Combien coûte une tâche humaine via l'API ?
La rémunération que vous fixez, dès 0,15 $, plus 10 % de frais, soit dès 0,165 $ ; +0,03 $ par capture supplémentaire et +0,30 $ par worker en Best Workers. Seules les preuves validées sont payées.
En combien de temps les humains répondent-ils ?
10,1 minutes en médiane entre prise de tâche et preuve. Avant cela, notre équipe relit la campagne, généralement en quelques heures, et l'arrivée du premier worker dépend des pays, de la rémunération et du rythme.
L'agent peut-il voir les captures ?
Oui. L'outil MCP get_proof_file renvoie les captures sous forme d'images que l'agent examine, et l'endpoint REST /submissions/{id}/image renvoie le fichier. L'agent peut ensuite valider, refuser, demander une correction ou signaler.
Quelles tâches sont interdites ?
Les tâches illégales, pour adultes, de jeux d'argent, trompeuses ou de vente de comptes sont refusées, tout comme les demandes de mots de passe, de données de paiement et les faux avis.
Sources & références
- Documentation de l'API Hitworkers (REST, outils MCP, prix, boucle d'agent)
- Spécification OpenAPI de Hitworkers
- llms.txt Hitworkers (documentation en texte brut pour les modèles de langage)
- Model Context Protocol - spécification officielle
- Anthropic - Documentation Claude Code : connecter des serveurs MCP
Services liés sur Hitworkers
Les annonceurs qui lancent des campagnes api human-in-the-loop les combinent souvent avec :
Lire la documentation API en quelques minutes
Fixez votre prix, choisissez le nombre de personnes, validez la preuve. Vous ne payez que le travail bien fait.
Lire la documentation API →