Credits en gebruik
Factureerbare services worden verrekend in accountcredits. Bedragen worden weergegeven in millicredits (millicredits); 1000 millicredits zijn gelijk aan 1 credit. De bedragen die u in verzoeken opgeeft, moeten gehele getallen zijn; bedragen in saldi en records mogen één decimaal bevatten (0,1 millicredit). credit_precision in antwoorden is 4, wat betekent dat er na conversie naar credits maximaal 4 decimalen worden weergegeven.
Controleer het saldo
Section titled “Controleer het saldo”GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"Belangrijkste velden:
| Veld | Betekenis |
|---|---|
available | Millicredits beschikbaar nu, na schuld; negatief bij schuld |
debt | Schuld in millicredits: het deel van de werkelijke kosten van voltooide taken dat het saldo overschreed. Credits die later binnenkomen (opwaarderingen, dagelijkse subsidies, inwisselcodes, restituties enzovoort) worden eerst gebruikt om de schuld te vereffenen. |
spent | Totaal afgehandelde millicredits |
expired | Millicredits die zijn verlopen of ingetrokken |
today_charged | Millicredits zijn vandaag vereffend |
lots | Momenteel geldige creditlots en hun vervaldatum |
Creditpakketten
Section titled “Creditpakketten”GET /api/v1/billing/credits/plansEen openbaar eindpunt dat geen aanmelding vereist en de pakketten in de uitverkoop retourneert (purchase_plans, gesleuteld op plancode). Nu in de uitverkoop:
| Plancode | Credits | Prijs | Bonus |
|---|---|---|---|
credits_3000_v4 | 3,000 | ¥9.90 | — |
credits_10000_v4 | 10,000 | ¥29.90 | — |
credits_25000_v4 | 25,000 | ¥69 | 8% |
credits_50000_v4 (aanbevolen) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- “Bonus” wordt berekend op basis van de prijs van 10.000 credits voor ¥29,90 en staat in veld
bonus_percent; het aanbevolen pakket heeftrecommended: true. Geen van beide velden wordt weergegeven wanneer ze niet zijn ingesteld. price_fen(in fen, 1/100 yuan) is de officiële eenheid voor prijs, entotal_millicredits(millicredits) voor credits. Aangekochte credits vervallen niet; packs kunnen opnieuw worden gekocht en komen telkens in één keer aan.
Oplaadlevenscyclus
Section titled “Oplaadlevenscyclus”- Het saldo wordt vóór de start van een taak gecontroleerd tegen een drempelwaarde : het saldo (na schuld) moet hoger zijn dan de drempelwaarde van de taak, bijvoorbeeld “aantal pagina’s × 2 credits” voor PDF vertaling, de lengte van de brontekst voor andere bestanden (minimaal 2 credits), en voor audio, video en spraak de kosten berekend op basis van de duur of het aantal tekens dat de server heeft gemeten (prijzen in audio, video en stemmen ). Met een API-sleutel die een budget heeft, moet het resterende budget van de sleutel ook boven de drempelwaarde liggen. Anders is de reactie
402(een bestandsvertaaktaken eindigt als mislukt metquota_exceeded=true, een mediataak eindigt meterror_code=insufficient_credits) en worden er geen kosten in rekening gebracht. Het starten van een taak verandert het saldo niet. - Werkelijk gebruik wordt in rekening gebracht zodra het is voltooid : bestandstranslatie (inclusief afbeeldingen), gebundelde rich text, documentbewerkingen, audio, video en spraak worden bij voltooiing volledig in rekening gebracht op basis van werkelijk gebruik. Het budget van een API-sleutel wordt alleen gebruikt voor controle vóór de start en verlaagt nooit de kosten voor een voltooide taak; als hierdoor het gebruikte budget van de sleutel boven de limiet komt, kan de sleutel geen nieuwe taken starten totdat de limiet wordt verhoogd. Mislukte of geannuleerde taken worden niet in rekening gebracht.
- Het saldo kan negatief worden : het deel van de werkelijke kosten dat het saldo overschrijdt, wordt als schuld geregistreerd en het saldo wordt als negatief weergegeven; later binnengekomen tegoeden worden eerst gebruikt om de schuld af te lossen. Nieuwe opdrachten kunnen niet starten zolang het saldo negatief is; voer een aanvulling uit.
Cliënten geven nooit door “hoeveel in rekening moet worden gebracht”; de server berekent het af te wikkelen bedrag op basis van wat is geleverd.
Bewerkingen en records
Section titled “Bewerkingen en records”GET /api/v1/billing/credits/operations?limit=20GET /api/v1/billing/credits/operations/{operation_id}GET /api/v1/billing/credits/jobs/{job_id}Een record bevat de bewerking-ID, status, factureringsbasis en de in rekening gebrachte en gerestitueerde bedragen. Met een API-sleutel weergegeven, omvatten bewerkingen alleen die welke met die sleutel zijn gestart.
Gebruik
Section titled “Gebruik”GET /api/v1/usage?limit=50GET /api/v1/usage/summaryDe gebruiks-eindpunten retourneren het aantal bestanden, tekens, tokens en de verwerkingstijd van het account.
Queries zijn gratis
Section titled “Queries zijn gratis”Het controleren van het saldo, de taakstatus, het gebruik, afrekeningsgegevens, resultatenlijsten en downloadadressen kost geen credits.