跳转到内容

క్రెడిట్‌లు మరియు వినియోగం

బిల్లబడే సేవలు అకౌంట్ క్రెడిట్‌లలో తీర్చబడతాయి. మొత్తాలు మిల్లీక్రెడిట్‌లలో (millicredits) ఇవ్వబడతాయి; 1000 మిల్లీక్రెడిట్‌లు 1 క్రెడిట్‌కు సమానం. మీరు అభ్యర్థనలలో పంపే మొత్తాలు పూర్ణాంకాలుగా ఉండాలి; బ్యాలెన్స్‌లు మరియు రికార్డులలోని మొత్తాలు ఒక దశాంశ స్థానాన్ని (0.1 మిల్లీక్రెడిట్) కలిగి ఉండవచ్చు. ప్రతిస్పందనలో credit_precision 4 గా ఉంటుంది, అంటే క్రెడిట్‌లుగా మారిన తర్వాత గరిష్టంగా 4 దశాంశ స్థానాలు ఉంటాయి.

బ్యాలెన్స్‌ను తనిఖీ చేయండి

Section titled “బ్యాలెన్స్‌ను తనిఖీ చేయండి”
GET /api/v1/billing/credits/balance
Terminal window
curl https://omnidoc.top/api/v1/billing/credits/balance \
-H "X-API-Key: $OMNIDOC_API_KEY"

ప్రధాన ఫీల్డ్‌లు:

క్షేత్రంఅర్థం
availableఅప్పు తీరిన తర్వాత ఇప్పుడు అందుబాటులో ఉన్న మిల్లీక్రెడిట్‌లు; అప్పు ఉన్నప్పుడు ఋణాత్మకం
debtమిల్లీక్రెడిట్‌లలో అప్పు: పూర్తయిన పనుల వాస్తవ ఖర్చులో బ్యాలెన్స్‌ను మించిన భాగం. తర్వాత వచ్చే క్రెడిట్‌లు (టాప్-అప్‌లు, రోజువారీ గ్రాంట్‌లు, రీడీమ్ కోడ్‌లు, రిఫండ్‌లు మరియు మొదలైనవి) ముందుగా ఆ అప్పును తీర్చుతాయి
spentమొత్తం నిర్వహించబడిన మిల్లీక్రెడిట్‌లు
expiredముగిసిన లేదా ఉపసంహరించబడిన మిల్లీక్రెడిట్‌లు
today_chargedనేడు మిల్లీక్రెడిట్‌లు సెటిల్ అయ్యాయి
lotsప్రస్తుతం చెల్లుబాటులో ఉన్న క్రెడిట్ లాట్‌లు మరియు వాటి గడువు

క్రెడిట్ ప్యాక్‌లు

Section titled “క్రెడిట్ ప్యాక్‌లు”
GET /api/v1/billing/credits/plans

సైన్-ఇన్ అవసరం లేని ఒక పబ్లిక్ ఎండ్‌పాయింట్, ఇది అమ్మకానికి ఉన్న ప్యాక్‌లను (purchase_plans) తిరిగి ఇస్తుంది, ఇక్కడ ప్లాన్ కోడ్‌తో కీ చేయబడింది. ప్రస్తుతం అమ్మకానికి అందుబాటులో ఉన్నది:

ప్లాన్ కోడ్క్రెడిట్‌లుధరబోనస్
credits_3000_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4 (సిఫార్సు చేయబడింది)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • “బోనస్” ¥29.90 కోసం 10,000 క్రెడిట్ల ధరతో లెక్కించబడుతుంది మరియు bonus_percent ఫీల్డ్‌గా ఉంటుంది; సిఫార్సు చేయబడిన ప్యాక్‌లో recommended: true ఉంటుంది. ఇవి సెట్ చేయనప్పుడు ఏ ఫీల్డ్‌ కూడా కనిపించదు.
  • price_fen (ఫెన్‌లో, 1/100 యువాన్) ధరకు అధికారికంగా ఉపయోగించబడుతుంది, మరియు total_millicredits (మిల్లీక్రెడిట్‌లు) క్రెడిట్‌లకు వర్తిస్తుంది. కొనుగోలు చేసిన క్రెడిట్‌లకు గడువు లేదు; ప్యాక్‌లను మళ్లీ కొనుగోలు చేయవచ్చు మరియు ప్రతిసారీ ఒకేసారి అందుతాయి.

ఛార్జింగ్ జీవితచక్రం

Section titled “ఛార్జింగ్ జీవితచక్రం”
  1. ఒక పని ప్రారంభమవడానికి ముందు, బ్యాలెన్స్‌ను ఒక ప్రాథమిక స్థాయితో పోల్చి చూస్తారు : బ్యాలెన్స్ (అప్పు తర్వాత) పని యొక్క ప్రాథమిక స్థాయి కంటే ఎక్కువగా ఉండాలి, ఉదాహరణకు PDF అనువాదం కోసం “పేజీలు × 2 క్రెడిట్‌లు”, ఇతర ఫైళ్ళ కోసం మూల టెక్స్ట్ పొడవు (కనీసం 2 క్రెడిట్‌లు), మరియు ఆడియో, వీడియో మరియు ప్రసంగం కోసం సర్వర్ కొలిచిన నిడివి లేదా అక్షరాల ఆధారంగా లెక్కించబడిన ఖర్చు ( ఆడియో, వీడియో మరియు వాయిస్‌ల ధరలు ). బడ్జెట్ ఉన్న API కీ ఉన్నప్పుడు, కీ యొక్క మిగిలిన బడ్జెట్ కూడా ప్రాథమిక స్థాయి కంటే ఎక్కువగా ఉండాలి. లేకపోతే ప్రతిస్పందన 402 (ఒక ఫైల్ అనువాద పని quota_exceeded=true తో విఫలమైనట్లుగా ముగుస్తుంది, ఒక మీడియా పని error_code=insufficient_credits తో ముగుస్తుంది) మరియు ఏమీ వసూలు చేయబడదు. ఒక పనిని ప్రారంభించడం వలన బ్యాలెన్స్ మారదు.
  2. నిజమైన వినియోగం పూర్తయినప్పుడు ఛార్జ్ చేయబడుతుంది : ఫైల్ అనువాదం (చిత్రాలతో సహా), బ్యాచ్‌డ్ రిచ్ టెక్స్ట్, డాక్యుమెంట్ ఆపరేషన్‌లు, ఆడియో, వీడియో మరియు స్పీచ్‌లకు నిజమైన వినియోగం కోసం పూర్తయిన తర్వాత పూర్తి ఛార్జ్ వసూలు చేయబడుతుంది. ఒక API కీ యొక్క బడ్జెట్ ప్రారంభానికి ముందు జరిగే తనిఖీలో మాత్రమే ప్రభావం చూపుతుంది మరియు పూర్తయిన పనికి వచ్చే ఛార్జ్‌ను ఎప్పుడూ తగ్గించదు; అది కీ యొక్క ఉపయోగించిన బడ్జెట్‌ను దాని పరిమితిని దాటిపోయేలా చేస్తే, పరిమితిని పెంచే వరకు ఆ కీ కొత్త పనులను ప్రారంభించలేదు. విఫలమైన లేదా రద్దు చేయబడిన పనులకు ఛార్జ్ వసూలు చేయబడదు.
  3. బ్యాలెన్స్ ఋణాత్మకంగా మారవచ్చు : వాస్తవ ఖర్చులో బ్యాలెన్స్‌ను మించిన భాగాన్ని అప్పుగా నమోదు చేస్తారు మరియు బ్యాలెన్స్ ఋణాత్మకంగా చూపబడుతుంది; తర్వాత వచ్చే క్రెడిట్‌లు మొదట అప్పును తీర్చుతాయి. బ్యాలెన్స్ ఋణాత్మకంగా ఉన్నప్పుడు కొత్త పనులు ప్రారంభించలేరు; బ్యాలెన్స్‌ను పూర్తి చేయండి.

క్లయింట్‌లు ఎప్పుడూ “ఎంత వసూలు చేయాలి” అని సమర్పించరు; సర్వర్ డెలివరీ చేసిన దాని నుండి సెటిల్ అయిన మొత్తాన్ని లెక్కిస్తుంది.

ఆపరేషన్‌లు మరియు రికార్డులు

Section titled “ఆపరేషన్‌లు మరియు రికార్డులు”
GET /api/v1/billing/credits/operations?limit=20
GET /api/v1/billing/credits/operations/{operation_id}
GET /api/v1/billing/credits/jobs/{job_id}

ఒక రికార్డ్‌లో ఆపరేషన్ ఐడీ, స్టేటస్, బిల్లింగ్ ప్రాతిపదిక, మరియు వసూలు చేసిన మరియు తిరిగి చెల్లించిన మొత్తాలు ఉంటాయి. API కీతో జాబితా చేయబడిన ఆపరేషన్‌లలో, ఆ కీ ద్వారా ప్రారంభించబడినవి మాత్రమే ఉంటాయి.

GET /api/v1/usage?limit=50
GET /api/v1/usage/summary

ఉపయోగ చివరి పాయింట్‌లు ఖాతా ఫైల్ సంఖ్య, అక్షరాలు, టోకెన్‌లు మరియు ప్రాసెసింగ్ సమయాన్ని తిరిగి ఇస్తాయి.

బ్యాలెన్స్, జాబ్ స్టేటస్, వినియోగం, సెటిల్‌మెంట్ రికార్డులు, ఫలితాల జాబితాలు మరియు డౌన్‌లోడ్ చిరునామాలను తనిఖీ చేయడానికి ఎలాంటి క్రెడిట్లు అవసరం లేదు.