> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Digital engelsk verifieringskod igenkänning API integration instruktioner > Recognition of English numerical verification codes API guide - Ace Data Cloud Denna artikel kommer att introducera en digital engelsk verifieringskod igenkänning API integration instruktioner, som är baserad på djupinlärningsteknik och kan användas för att känna igen variabla längd engelska siffror och bokstäver verifieringskoder. Inmatning av verifieringskodens bildinnehåll ger utdata av verifieringskodens resultat. ## Ansökningsprocess För att använda den digitala engelska verifieringskod igenkänning API, börja med att gå till [Ace Data Cloud kontrollpanelen](https://platform.acedata.cloud/console/applications) för att få din API-token, som du ska spara. ![](https://cdn.acedata.cloud/5hmkdg.jpg) Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan som bjuder in dig att registrera dig och logga in, och efter att ha slutfört detta kommer du automatiskt att återvända till den aktuella sidan. **En API-token kan användas för att anropa alla tjänster på plattformen, utan att behöva ansöka separat för varje tjänst.** Första ansökan ger en gratis kvot för att prova; när kvoten är otillräcklig kan du ladda på allmän balans i [kontrollpanelen](https://platform.acedata.cloud/console/coin). > 📘 Fullständig dokumentation: [Digital engelsk verifieringskod igenkänning API →](https://platform.acedata.cloud/documents/captcha-recognition-image2text) ## Grundläggande användning Först bör du förstå den grundläggande användningen, vilket innebär att du matar in den bild av den variabla längd engelska siffror och bokstäver verifieringskoden som behöver bearbetas, så får du det bearbetade resultatet. Först behöver du enkelt överföra ett `image` fält, vilket är den specifika bilden av den engelska verifieringskoden, som visas i bilden:

Sedan behöver vi konvertera verifieringskodens bild till Base64-kodad bild, för att konvertera till Base64-kod rekommenderas det att använda Google Chrome-tillägget FeHelper, och den specifika användningen kan refereras till bilden nedan:

Därefter kan du kopiera den Base64-kod som erhållits från Google Chrome-tillägget FeHelp, kom ihåg att den inte inkluderar prefixet data:image/png;base64, den specifika innehållet är som följer:

Här kan vi se att vi har ställt in Request Headers, inklusive: * `accept`: vilken format av svar du vill ta emot, här fylls det i som `application/json`, det vill säga JSON-format. * `authorization`: nyckeln för att anropa API, efter ansökan kan du direkt välja från rullgardinsmenyn. Dessutom har vi ställt in Request Body, inklusive: * `image`: Base64-kodad verifieringskodens bild (utan prefixet data:image/png;base64). När du har valt kan du se att motsvarande kod också har genererats till höger, som visas i bilden:

Klicka på "Try" knappen för att testa, som visas i bilden ovan, här har vi fått följande resultat: ```json theme={null} { "text": "7364" } ``` Det returnerade resultatet har flera fält, som beskrivs nedan: * `text`, textinnehållet efter att ha bearbetat den variabla längd engelska verifieringskodens bild. Vi kan se att vi har fått verifieringsresultatet för den bearbetade variabla längd engelska verifieringskodens bild, vi behöver bara använda textinnehållet i `text` för att klara verifieringen. Om du vill generera motsvarande integrationskod kan du direkt kopiera den som genererats, till exempel CURL-koden är som följer: ```shell theme={null} curl -X POST 'https://api.acedata.cloud/captcha/recognition/image2text' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "image": "iVBORw0KGgoAAAANSUhEUgAAAgUAAAE3CAYAAAA6xjI2AAAAAX..." }' ``` Python integrationskoden är som följer: ```python theme={null} import requests url = "https://api.acedata.cloud/captcha/recognition/image2text" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "image": "iVBORw0KGgoAAAANSUhEUgAAAgUAAAE3CAYAAAA6xjI2AAAAAX..." } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` ## Asynkron läge (async) Som standard är API:et synkront och blockerande: en begäran kommer att vänta tills igenkänningens resultat har bearbetats klart innan det returneras. Om du gör en rotation av flera kodare (multi-solver rotation) och vill "skicka uppgiften och omedelbart få task\_id, först schemalägga andra kodare och sedan återvända för att hämta resultatet", kan du skicka in `async: true` i begärningskroppen. Genom att skicka in `async: true` kommer gränssnittet omedelbart att returnera ett `task_id`, utan att blockera och vänta: ```shell theme={null} curl -X POST 'https://api.acedata.cloud/captcha/recognition/image2text' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "image": "iVBORw0KGgoAAAANSUhEUgAAAgUAAAE3CAYAAAA6xjI2AAAAAX...", "async": true }' ``` ```json theme={null} { "success": true, "task_id": "61138bb6-19aa-11ec-a9c8-0242ac110002", "trace_id": "2efa9340-b21b-4e26-9e14-4aac95f343ab", "status": "processing" } ``` Använd sedan det `task_id` för att pollera `POST /captcha/tasks` (rekommenderas var 3-5 sekund) för att hämta resultatet: ```shell theme={null} curl -X POST 'https://api.acedata.cloud/captcha/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "task_id": "61138bb6-19aa-11ec-a9c8-0242ac110002" }' ``` Under bearbetning kommer det att returnera `status: processing`: ```json theme={null} { "success": true, "task_id": "61138bb6-19aa-11ec-a9c8-0242ac110002", "status": "processing" } ``` När bearbetningen är klar kommer det att returnera `status: ready` och igenkänningsresultatet `text` (fältstrukturen är helt identisk med det synkrona läget): ```json theme={null} { "success": true, "task_id": "61138bb6-19aa-11ec-a9c8-0242ac110002", "status": "ready", "text": "7364" } ``` Avgiftsbeskrivning: I asynkront läge debiteras inte skapandet av uppgifter och polling "bearbetning" avgifter; **endast när du framgångsrikt får igenkänningsresultatet debiteras en gång** (samma pris som det synkrona läget). Därför kommer avbokning av uppgifter som inte har slutförts under rotationen inte att medföra kostnader. `/captcha/tasks` är gemensam för alla verifieringskod API:er (token och igenkänning serie), och du kan pollera med samma `task_id`. ## Felhantering När du anropar API:et, om du stöter på fel, kommer API:et att returnera motsvarande felkod och information. Till exempel: * `400 token_mismatched`: Bad request, möjligtvis på grund av saknade eller ogiltiga parametrar. * `400 api_not_implemented`: Bad request, möjligtvis på grund av saknade eller ogiltiga parametrar. * `401 invalid_token`: Obehörig, ogiltig eller saknad auktoriseringstoken. * `429 too_many_requests`: För många begärningar, du har överskridit hastighetsgränsen. * `500 api_error`: Internt serverfel, något gick fel på servern. ### Exempel på felrespons ```json theme={null} { "success": false, "error": { "code": "api_error", "message": "hämtning misslyckades" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" } ``` ## Slutsats Genom detta dokument har du fått en förståelse för hur man använder API:et för att känna igen digitala engelska verifieringskoder som kan användas för att känna igen variabla engelska sifferverifieringskoder. Innehållet i den inmatade verifieringskodens bild ger ut verifieringskodens resultat. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda detta API. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.