Passer au contenu principal

Introduction

Image2Text est un service de reconnaissance de captcha fourni par Ace Data Cloud, permettant la reconnaissance de captchas d’image. Grâce à l’API unifiée d’Ace Data Cloud, vous pouvez intégrer rapidement Image2Text en JavaScript pour réaliser la reconnaissance de captchas d’image, avec des entrées en Base64, URL, etc.

Prérequis

  • Posséder un compte Ace Data Cloud et obtenir un Token API
  • Environnement Node.js 18+ ou navigateur moderne

Utilisation de base

Le point d’accès principal de l’API Image2Text est :
POST https://api.acedata.cloud/captcha/recognition/image2text
Exemple complet de code JavaScript :
const response = await fetch("https://api.acedata.cloud/captcha/recognition/image2text", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."
}),
});

const result = await response.json();
console.log(result);
Veuillez remplacer YOUR_API_TOKEN par le Token réel obtenu sur la plateforme Ace Data Cloud.

Gestion de la réponse

Il est conseillé de vérifier le code de statut de la réponse et de gérer les erreurs :
if (response.ok) {
  const result = await response.json();
  console.log("Appel réussi :", result);
} else {
  console.error(`Appel échoué, code de statut : ${response.status}`);
  const error = await response.text();
  console.error(error);
}

Encapsulation Node.js

Il est recommandé d’encapsuler dans une fonction réutilisable :
async function callImage2Text(data) {
  const response = await fetch("https://api.acedata.cloud/captcha/recognition/image2text", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`Erreur API : ${response.status}`);
  return response.json();
}

Gestion des erreurs

Codes d’erreur courants :
CodeDescription
401Échec d’authentification, veuillez vérifier le Token API
403Solde insuffisant ou accès non autorisé
429Limite de fréquence des requêtes dépassée
500Erreur interne du serveur

Étapes suivantes