Credits und Nutzung
Abrechenbare Dienste werden mit Kontoguthaben abgerechnet. Beträge werden in Milliguthaben (millicredits) angegeben; 1000 Milliguthaben entsprechen 1 Guthaben. Die in Anfragen übermittelten Beträge müssen ganzzahlig sein; Beträge in Salden und Aufzeichnungen dürfen eine Dezimalstelle aufweisen (0,1 Milliguthaben). credit_precision in Antworten entspricht 4, was maximal 4 Dezimalstellen nach der Umrechnung in Guthaben bedeutet.
Überprüfen Sie den Kontostand
Abschnitt betitelt „Überprüfen Sie den Kontostand“GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"Schlüssel-Felder:
| Feld | Bedeutung |
|---|---|
available | Millicredits verfügbar jetzt, nach Schulden; negativ bei Schulden |
debt | Schulden in Millikrediten: Der Teil der tatsächlichen Kosten abgeschlossener Aufträge, der das Guthaben überstieg. Später eingehende Gutschriften (Aufstockungen, tägliche Zuschüsse, Einlösecodes, Rückerstattungen usw.) werden zuerst zur Tilgung der Schulden verwendet. |
spent | Insgesamt beglichene Millikredite |
expired | Millicredits, die abgelaufen oder zurückgezogen wurden |
today_charged | Millicredits wurden heute beglichen |
lots | Aktuell gültige Kreditlots und deren Ablauf |
Guthabenpakete
Abschnitt betitelt „Guthabenpakete“GET /api/v1/billing/credits/plansEin öffentlicher Endpunkt, der keine Anmeldung erfordert und die zum Verkauf stehenden Pakete zurückgibt (purchase_plans, indexiert nach Plancode). Jetzt im Angebot:
| Plancode | Credits | Preis | 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 (empfohlen) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- Der „Bonus“ wird auf Basis des Preises von 10.000 Credits für 29,90 ¥ berechnet und entspricht dem Feld
bonus_percent; das empfohlene Paket hatrecommended: true. Keines der beiden Felder wird angezeigt, wenn es nicht gesetzt ist. price_fen(in Fen, 1/100 Yuan) ist maßgeblich für den Preis, undtotal_millicredits(Millikredite) für die Kredite. Erworbene Kredite verfallen nicht; Packs können erneut gekauft werden und werden jeweils auf einmal geliefert.
Ladezyklus
Abschnitt betitelt „Ladezyklus“- Der Kontostand wird vor Beginn eines Auftrags gegen einen Schwellenwert geprüft : Der Kontostand (nach Abzug von Schulden) muss über dem Schwellenwert des Auftrags liegen, zum Beispiel „Seiten × 2 Credits“ für die Übersetzung PDF, die Länge des Quelltextes für andere Dateien (mindestens 2 Credits) sowie für Audio, Video und Sprache die aus der Dauer oder Anzahl der Zeichen berechneten Kosten, die der Server gemessen hat (Preise in Audio, Video und Stimmen ). Bei einem API-Schlüssel mit Budget muss auch das verbleibende Budget des Schlüssels über dem Schwellenwert liegen. Andernfalls lautet die Antwort
402(ein Dateiübersetzungsjob endet fehlgeschlagen mitquota_exceeded=true, ein Mediaprojekt endet miterror_code=insufficient_credits), und es werden keine Gebühren erhoben. Das Starten eines Auftrags ändert den Kontostand nicht. - Die tatsächliche Nutzung wird abgerechnet, sobald sie abgeschlossen ist : Dateiübersetzung (einschließlich Bildern), gebündelter Rich-Text, Dokumentoperationen sowie Audio-, Video- und Sprachverarbeitung werden nach Abschluss vollständig nach tatsächlichem Verbrauch abgerechnet. Das Budget eines API-Schlüssels fließt nur vor dem Start in die Überprüfung ein und mindert die Abrechnung eines abgeschlossenen Auftrags niemals; überschreitet der verbrauchte Betrag des Schlüssels dabei sein Limit, kann der Schlüssel keine neuen Aufträge starten, bis das Limit erhöht wurde. Gescheiterte oder stornierte Aufträge werden nicht berechnet.
- Der Saldo kann negativ werden : Der Teil der tatsächlichen Kosten, der den Saldo übersteigt, wird als Schulden erfasst und der Saldo wird negativ angezeigt; später eingehende Gutschriften tilgen zuerst die Schulden. Neue Aufträge können nicht begonnen werden, solange der Saldo negativ ist; bitte aufladen.
Kunden geben niemals an, „wie viel berechnet werden soll“; der Server ermittelt den abgerechneten Betrag auf Grundlage des tatsächlich Gelieferten.
Operationen und Aufzeichnungen
Abschnitt betitelt „Operationen und Aufzeichnungen“GET /api/v1/billing/credits/operations?limit=20GET /api/v1/billing/credits/operations/{operation_id}GET /api/v1/billing/credits/jobs/{job_id}Ein Datensatz enthält die Vorgangs-ID, den Status, die Abrechnungsgrundlage sowie die berechneten und erstatteten Beträge. Bei Angabe eines API-Schlüssels werden nur die durch diesen Schlüssel gestarteten Vorgänge angezeigt.
Verwendung
Abschnitt betitelt „Verwendung“GET /api/v1/usage?limit=50GET /api/v1/usage/summaryDie Nutzungsendpunkte geben die Dateianzahl, Zeichen, Tokens und die Verarbeitungszeit des Kontos zurück.
Abfragen sind kostenlos
Abschnitt betitelt „Abfragen sind kostenlos“Das Überprüfen von Guthaben, Auftragsstatus, Nutzung, Abrechnungsdaten, Ergebnislisten und Download-Adressen kostet keine Credits.