跳转到内容

Кредиттер және пайдалану

Есептелетін қызметтер шот несиелерінде есептеледі. Сомалар миллинесялармен көрсетіледі (millicredits); 1000 миллинесял тең 1 несие. Сұраныстарда жіберетін сомалар бүтін сан болуы тиіс; қалдықтар мен жазбалардағы сомалар бір ондық таразысына дейін (0,1 миллинесял) болуы мүмкін. Жауаптардағы credit_precision — 4, яғни несиеге айналдырылғаннан кейін ең көп дегенде 4 ондық таразысы болады.

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Қазіргі уақытта жарамды несие лоттары мен олардың мерзімінің аяқталуы
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 (милликредиттер) кредиттер бойынша. Сатып алынған кредиттернің мерзімі өтпейді; пакеттерді қайта сатып алуға болады және әр ретте бірден келеді.
  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}

Жазба операцияның ID-сін, мәртебесін, есептеу негізін және салынған және қайтарылған сомаларды қамтиды. API кілтімен тізімделген операциялар тек осы кілтпен басталғандарды ғана қамтиды.

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

Пайдалану нүктелері есептік жазбаның файлдар санын, таңбаларды, токендерді және өңдеу уақытын қайтарады.

Балансты, жұмыс мәртебесін, пайдалануды, есеп айырысу жазбаларын, нәтиже тізімдерін және жүктеу мекенжайларын тексеру үшін несие жұмсалмайды.