OCR පෙළ හඳුනාගැනීමේ සහකාර

විවෘත API අතුරුමුහුණත සංවර්ධන මාර්ගෝපදේශය

API බැර ලබා ගන්න

OCR පෙළ හඳුනාගැනීමේ සහකාර විවෘත වේදිකාව වෙත සාදරයෙන් පිළිගනිමු!
අපි ස්ථාවර, අධිවේගී පෙළ නිස්සාරණය සහ මේස හඳුනා ගැනීමේ සේවාවන් සපයන්නෙමු.

1. ගෝලීය සත්යාපන යාන්ත්රණය (Auth)

සියලුම අතුරුමුහුණත් ඉල්ලීම් URL හි පහත සඳහන් සත් යාපන පරාමිතීන් ඇතුළත් විය යුතුය:

පරාමිතියේ නම අවශ්යයි විස්තරය
app එය ස්ථාවර වටිනාකම api
token එය ඔබට එය සොයා ගත හැකිය පුද්ගලික මධ් යස්ථානය ඔබේම ටෝකනය ලබා ගන්න
2. මූලික අතුරුමුහුණත හඳුනා ගන්න (op = කේතය)

URL එක ඉල්ලන්න: /Code.ashx?op=code&app=api&token=YOUR_TOKEN&type=0

ඇමතුම් ක් රමය: POST

පරාමිතීන් URL හි ඒකාකාරව අක්ෂර වින් යාසය කර ඇති අතර රූප දත්ත POST ශරීරය හරහා ගමන් කරයි (බහු කොටස් සඳහා සහය දක්වයි ගොනු ප්රවාහය, ආකෘති ක්ෂේත්රය හෝ සරල පෙළ).

2.1 හඳුනාගත යුතු රූපය ඇතුලත් කරන්න (තුනෙන් එකක් තෝරන්න)

පරාමිතියේ නම වර්ගය විස්තරය
(ලියවිල්ල) File සම්මත බහු කොටස් උඩුගත ගොනු ප්රවාහය.
url String පින්තූරයේ පොදු ජාලයට සෘජු සබැඳි ලිපිනයට ප් රවේශ විය හැකිය.
code String රූපයේ Base64 වැල (ශීර්ෂ හැඩතල ගැන්වීමේ ප්රකාශය ඇතුළත් කිරීමට අවශ්ය නැත).

2.2 හරය මාදිලිය සහ එන්ජින් පාලනය

පරාමිතියේ නම අවශ්යයි විස්තරය
type නැහැ රටා හඳුනා ගන්න:
0: පෙළ හඳුනා ගැනීම (පෙරනිමි)
1: සිරස් හඳුනා ගැනීම
2: වගුව හඳුනා ගැනීම
3: සූත් ර හඳුනා ගැනීම (වැනි MathPix)

2.3 හැඩතල ගැන්වීම සහ පිරිසැලසුම නීති (විකල්ප)

පහත සඳහන් පරාමිතීන් අගයන් සමත් වේ 1 අනුරූප සැකසුම් සක්රිය කරන්න, අගය 0 ක් රියාත්මක නෑ.
නිශ්චිත අවශ්යතාවයක් නොමැති නම්, එය ලබා නොදීම රෙකමදාරු කරනු ලැබේ, එය තීරණය කිරීමට පද්ධතියට භාර දෙන්න:

පරාමිතියේ නම අවශ්යයි විස්තරය
left නැහැ චරිතාපදානය 1 වමේ සිට දකුණට ආකාරයේ මැහුම් බල කරන්න.
top නැහැ චරිතාපදානය 1 බලහත්කාරයෙන් ඉහළ සිට පහළට වර්ග කිරීම.
autodirection නැහැ චරිතාපදානය 1 රූපයේ දිශානතිය ස්වයංක් රීයව තීරණය කර පෙළගැස්වීමට එය භ් රමණය කරයි.
half නැහැ චරිතාපදානය 1 සාමාන්ය අර්ධ පළල දක්වා ස්වයංක්රීය පූර්ණ පළල විරාම ලකුණු
space නැහැ චරිතාපදානය 1 ඉංග්රීසි සහ චීන, ජපන් සහ කොරියානු අක්ෂර අතර වචන අවකාශයන් ස්වයංක්රීයව හසුරුවයි.
symbol නැහැ චරිතාපදානය 1 අමුතු විරාම ලකුණු ස්වයංක් රීයව නිවැරදි කරන්න.
duplicate නැහැ චරිතාපදානය 1 ස්වයංක් රීයව හයිෆන් නැවත නැවත කරන්න.

2.4 ආපසු අගය විස්තරය (JSON)

හඳුනාගැනීමේ අතුරුමුහුණත සම්මත JSON ආකෘතියක් ලබා දෙයි. වටිනාකම තමයි null ක්ෂේත්රය ස්වයංක්රීයව මඟ හැරේ.

ඉහළ මට්ටමේ ක්ෂේත්ර

ක්ෂේත් රය වර්ගය විස්තරය
id String මෙම ඉල්ලීමේ අද්විතීය කාණ්ඩ හැඳුනුම්පත (UUID ආකෘතිය) අසමමුහුර්ත ලෙස ප් රතිඵල විමසීමට භාවිතා කළ හැකිය.
ocrType Int ඉල්ලීම් පරාමිතීන් සමඟ වර්ගය හඳුනා ගන්න type ලිපි හුවමාරුව.
processId Int ඉල්ලීම හසුරුවන එන්ජින් නෝඩයේ හැඳුනුම්පත.
processName String එන්ජින් නාම සැකසීම. හිස් වූ විට හඳුනා ගැනීම කාලය අවසන් වී ඇති බව හෝ නෝඩයකට පවරා නොමැති බව ඇඟවේ.
state Int තත්ත්ව කේත හැසිරවිය (පහත ගණනය කිරීමේ වගුව බලන්න).
message String අතිරේක පණිවිඩය / දෝෂ විස්තරය, සුවිශේෂී අවස්ථාවන්හිදී පමණක් ආපසු ලබා දෙනු ලැබේ.
result Object හරය හඳුනා ගැනීමේ ප්රතිඵල වස්තූන් (විස්තර සඳහා පහත උපක්ෂේත්ර වගුව බලන්න).
desc String එන්ජිමට අමුණා ඇති අතිරේක විස්තරාත්මක තොරතුරු, ඇත්නම්.

result උප වස්තුව - පෙළ ප්රතිඵලය

ක්ෂේත් රය වර්ගය විස්තරය
autoText String නිර්දේශිත භාවිතය。 බුද්ධිමත් ඡේදය ඒකාබද්ධ කිරීම සහ පිරිසැලසුම ප්රශස්තිකරණය සමඟ සම්පූර්ණ පෙළ.
spiltText String මුල් ඡේදයෙන් බෙදී ඇති පෙළ (ඡේද අතර \t ඉන්ඩෙන්ට් + \n රේඛා බිඳීම). වගු මාදිලියේ දී, දත්ත JSON තීරු වේ.
transText String එහි ප්රතිඵලයක් ලෙස පෙළ පරිවර්තනය (පමණක් වර්ගය = පරිවර්තනය මාදිලිය ප්රතිලාභ, සමග ව්යුහය spiltText ලිපි හුවමාරුව).
lang String එන්ජිම විසින් ස්වයංක්රීයව අනාවරණය රූප භාෂාව හඳුනාගැනීමේ (උදා chi_sim, eng, jpn)。
resultType Int ප්රතිඵල ආකෘතිය වර්ගය.0= සරල පෙළ, 1= වෙබ් පිටුව (සූත් රය විදැහුම් සමඟ), 2= මේසය.

result උප වස්තුව - සම්බන්ධීකරණ ස්ථානගත දත්ත 🗺️

පහත දැක්වෙන ක්ෂේත් රවල මුල් රූපයේ එක් එක් පෙළ වාරණයේ නිශ්චිත පිහිටීම අඩංගු වන අතර එය ඉස්මතු කිරීම, ප් රදේශය නිස්සාරණය කිරීම වැනි අවස්ථාවන් සඳහා සුදුසු වේ.

ක්ෂේත් රය වර්ගය විස්තරය
spiltLocText String ඛණ්ඩාංක තොරතුරු සමග මුල් ඛණ්ඩනය පෙළ (ස්මාර්ට් ඡේදය ඒකාබද්ධ ප්රතිඵලය, ස්ථානය තොරතුරු ඇතුළුව).
transLocText String ඛණ්ඩාංක තොරතුරු සමඟ පරිවර්තනය ඛණ්ඩිත පෙළ.
verticalText String (JSON) ⭐ සම්පූර්ණ පෙළ වාරණ ඛණ්ඩාංක අරාවක JSON වැලක්. එක් එක් මූලද්රව්යය සඳහා එකක් TextCellInfo වස්තුව (පහත ව්යුහය බලන්න).

verticalText TextCellInfo වස්තු ව්යුහය

[
  {
    "words": "හඳුනාගත් පෙළ අන්තර්ගතය",
    "trans": "පරිවර්තන ප් රතිඵල (ඇත්නම්)",
    "pageIndex": 0,
    "location": {
      "left": 120.0,
      "top": 45.0,
      "width": 230.0,
      "height": 28.0
    }
  },
  ...
]
ක්ෂේත් රය වර්ගය විස්තරය
words String මෙම පෙළ වාරණය මගින් හඳුනාගත් පෙළ.
trans String පරිවර්තන ප්රතිඵල (පරිවර්තන මාදිලිය තුළ පමණක් අගය කරනු ලැබේ).
pageIndex Int පිටු අංක දර්ශකය (0 සිට ආරම්භ වන බහු-පිටු ලේඛන අවස්ථාවන්හිදී වලංගු වේ).
location.left Double පෙළ වාරණයේ ඉහළ වම් කෙළවරේ X ඛණ්ඩාංක (පික්සල්).
location.top Double පෙළ වාරණයේ ඉහළ වම් කෙළවරේ Y ඛණ්ඩාංක (පික්සල්).
location.width Double පෙළ වාරණ පළල (පික්සල් වලින්).
location.height Double පෙළ වාරණ උස (පික්සල් වලින්).

result උප වස්තුව - ගොනුව බාගත කරන්න

ක්ෂේත් රය වර්ගය විස්තරය
viewUrl String කවදාද? resultType=1 (වෙබ් පිටුව / සූත්රය), සබැඳි පෙරදසුන පිටුවේ ලිපිනය ආපසු පැමිණියේය.
downloadHtml String බාගත සබැඳි සමග HTML කොටසක්.
files Array බාගත කිරීම සඳහා ලබා ගත හැකි ප්රතිඵල ගොනු ලැයිස්තුවක්, එක් එක් වේ: DownLoadInfo වස්තුව (පහත ව්යුහය බලන්න).

files මෙම DownLoadInfo වස්තු ව්යුහය තුළ DownLoadInfo වස්තු ව්යුහය

ක්ෂේත් රය වර්ගය විස්තරය
url String ගොනු බාගත කිරීමේ ලිපිනය.
param String ඔබට අවශ්ය අතිරේක පරාමිතීන් බාගත කරන්න.
fileType Int ගොනු වර්ගය ගණනය කිරීම:1=PDF, 2=Word, 3=PPT, 4=Excel, 5=TXT, 6=Markdown
desc String ලේඛන විස්තරය.

state රාජ් ය ගණනය කිරීම

වටිනාකම අර්ථය විස්තරය
0 විභාග වෙමින් පවතී ඉල්ලීම ලැබී ඇති අතර එන්ජිම පවරා නැත.
2 සාර්ථක සැකසුම් සාමාන්යයෙන් පිළිගැනීමේ ප්රතිඵල ආපසු ලබා දෙන්න.
3 සැකසීම අසාර්ථක විය එන්ජිම ව් යතිරේකයක් හසුරුවන අතර නැවත උත්සාහ කළ හැකිය.
4 සැකසුම් කල් ඉකුත් වලංගු කාල සීමාව තුළ එන්ජිම නැවත පැමිණියේ නැත.
6 සමගාමී සීමාව සමගාමී ඉල්ලීම් ඕනෑවට වඩා ඇත, එබැවින් කරුණාකර සංඛ් යාතය අඩු කරන්න.
7 වර්ග සහාය නොදක්වයි වර්තමාන පිළිගැනීමේ වර්ගය හෝ ගොනු ආකෘතිය සහය නොදක්වයි.

පසුපස උදාහරණය

✅ සාර්ථක ප්රතිචාරය (ඛණ්ඩාංක දත්ත සමඟ):

{
  "ocrType": 0,
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "processId": 3,
  "processName": "OCR-Node-01",
  "state": 2,
  "result": {
    "autoText": "ස්මාර්ට් ඒකාබද්ධ කිරීමෙන් පසු සම්පූර්ණ පෙළ",
    "spiltText": "මුල් පෙළ ඡේද වලින් බෙදී ඇත",
    "verticalText": "[{\"words\":\"ආයුබෝවන්\",\"location\":{\"left\":10,\"top\":20,\"width\":80,\"height\":22}}]",
    "resultType": 0,
    "lang": "chi_sim"
  }
}

❌ දෝෂය / සීමා ප්රතිචාරය:

{
  "ocrType": 0,
  "processName": "ඉඟි",
  "result": {
    "spiltText": "අද API කෝටාව අවසන් වී ඇත, කරුණාකර රීචාර්ජ් කර එය දිගටම භාවිතා කරන්න!",
    "autoText": "අද API කෝටාව අවසන් වී ඇත, කරුණාකර රීචාර්ජ් කර එය දිගටම භාවිතා කරන්න!"
  },
  "id": 1
}
3. අසමමිතික ප්රතිඵල විමසුම (op = idcode)

URL එක ඉල්ලන්න: /Code.ashx?op=idcode&app=api&token=YOUR_TOKEN

ඇමතුම් ක් රමය: POST

කාර්යය: පිළිගැනීමක් අතුරු මුහුණත අනුව ආපසු id අසමමිතික සැකසුම් ප්රතිඵල විමසන්න. හඳුනා අතුරුමුහුණත නැවත පැමිණෙන විට state=0(විභාග වෙමින්), අවසාන ප්රතිඵලය ලබා ගැනීම සඳහා ඡන්දය විමසීමට ඔබට මෙම අතුරුමුහුණත භාවිතා කළ හැකිය.

පරාමිතියේ නම අවශ්යයි වර්ගය විස්තරය
id එය String අතුරුමුහුණත මගින් ආපසු ලබා දුන් කණ්ඩායමේ ඉල්ලීම් හැඳුනුම්පත හඳුනාගෙන එය POST ශරීරය හරහා ගමන් කරන්න.

පසුපස උදාහරණය

✅ සාර්ථක ප්රතිචාරය:

[
  {
    "ocrType": 0,
    "id": "a1b2c3d4-...",
    "processName": "OCR-Node-01",
    "state": 2,
    "result": {
      "autoText": "එහි ප්රතිඵලයක් ලෙස පෙළ හඳුනා ගන්න",
      "spiltText": "ඛණ්ඩනය කරන ලද පෙළ",
      "resultType": 0
    }
  }
]

❌ අසාර්ථක ප් රතිචාරය (හැඳුනුම්පත නොපවතියි හෝ ප් රති result ලය කල් ඉකුත් වී ඇත):

no

සරල පෙළ නැවත ලබා දෙයි no හැඳුනුම්පතක් විය හැකි එම හැඳුනුම්පත සඳහා කිසිදු ප් රතිඵලයක් හමු නොවූ බව පෙන්නුම් කරයි දෝෂය හෝ ප්රතිඵලය කල් ඉකුත් වී ඇති අතර ඉවත් කර ඇත.

4. රූප උඩුගත ඇඳ (op = imgUpload)

URL එක ඉල්ලන්න: /Code.ashx?op=imgUpload&app=api&token=YOUR_TOKEN

ඇමතුම් ක් රමය: POST (multipart/form-data)

කාර්යය: නොමිලේ රූප ඇඳට රූපයක් උඩුගත කර පොදු ජාලයට ප් රවේශ විය හැකි සෘජු සබැඳි URL එකක් ආපසු ලබා දෙන්න. ඔබ මුලින්ම රූපයක් උඩුගත කළ යුතු අවස්ථාවන් සඳහා එය සුදුසු වන අතර පසුව හඳුනාගැනීමේ අතුරුමුහුණත ඇමතීමට URL එක භාවිතා කරන්න.

පරාමිතියේ නම අවශ්යයි වර්ගය විස්තරය
(ලියවිල්ල) එය File රූප ගොනු බහු කොටස් විලාසිතාවෙන් උඩුගත කර ඇත.

පසුපස උදාහරණය

✅ සාර්ථක ප්රතිචාරය:

https://cdn.example.com/uploads/abc123.jpg

❌ අසාර්ථක ප්රතිචාරය (ගොනුව උඩුගත කර නැත හෝ ව්යතිරේකය):

no

සරල පෙළ නැවත ලබා දෙයි no උඩුගත කිරීමේ ක්රියාවලිය තුළ ගොනුව නොලැබුණු බව හෝ ව්යතිරේකයක් සිදු වූ බව පෙන්නුම් කරයි.

5. ශේෂ විමසීම් අතුරුමුහුණත (API කෝටා)

URL එක ඉල්ලන්න: /Code.aspx?op=count&app=api&token=YOUR_TOKEN

ඇමතුම් ක් රමය: GET

මෙම අතුරුමුහුණත හරහා, ඔබට අද ටෝකනය භාවිතා කර ඇති වාර ගණන සහ ඉතිරි කෝටාව දැක ගත හැකිය.

පසුපස උදාහරණය

✅ සාර්ථක ප්රතිචාරය:

{
  "Account": "api",
  "TodayCount": 52, // අද භාවිතා"LimitCount": 9948       // මුළු ධාරාව ඉතිරිව ඇති සංඛ්යාව
}

❌ අසාර්ථක ප්රතිචාරය (අවලංගු හෝ සම්ප්රේෂණය නොකළ ටෝකනය):

{
  "Account": "api",
  "TodayCount": 0,
  "LimitCount": 0
}

සටහන: ටෝකනය අවලංගු නම්, කිසිදු දෝෂයක් වාර්තා නොවනු ඇත, නමුත් LimitCount ඔව් ද නැද්ද යන්න මත පදනම්ව, 0 හි සියලු අගයන් සමඟ JSON නැවත පැමිණෙනු ඇත 0 සංකේතයේ වලංගුභාවය විනිශ්චය කිරීමට.

💻 ඔන්ලයින් කොමිස් කිරීම & ප් රවේශ කේතය
// ඉල්ලීම එවන තෙක් රැඳී සිටින්න...
📋 ඉක්මන් ප්රවේශ කේතය (ස්වයංක්රීයව උත්පාදනය කිරීමට ඉහත විකල්ප අනුගමනය කරන්න)
Code Snippet
අතුරු මුහුණත සහ පරාමිතීන් තෝරා ගැනීමෙන් පසුව, එය ස්වයංක්රීයව ජනනය කරනු ඇත ...
OCR සහකාර QQ සමඟ අමුත්තන් පාරිභෝගික සේවා
QQ පාරිභෝගික සේවා(365833440)
OCR සහකාර QQ පරිශීලක සන්නිවේදන කණ්ඩායම
QQකණ්ඩායම(100029010)
OCR සහකාර විද්යුත් තැපෑලෙන් පාරිභෝගික සේවය අමතන්න
තැපැල් පෙට්ටිය:net10010@qq.com

ඔබේ අදහස් සහ යෝජනා වලට ස්තූතියි!