Zum Inhalt springen

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.

GET /api/v1/billing/credits/balance
Terminal-Fenster
curl https://omnidoc.top/api/v1/billing/credits/balance \
-H "X-API-Key: $OMNIDOC_API_KEY"

Schlüssel-Felder:

FeldBedeutung
availableMillicredits verfügbar jetzt, nach Schulden; negativ bei Schulden
debtSchulden 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.
spentInsgesamt beglichene Millikredite
expiredMillicredits, die abgelaufen oder zurückgezogen wurden
today_chargedMillicredits wurden heute beglichen
lotsAktuell gültige Kreditlots und deren Ablauf
GET /api/v1/billing/credits/plans

Ein öffentlicher Endpunkt, der keine Anmeldung erfordert und die zum Verkauf stehenden Pakete zurückgibt (purchase_plans, indexiert nach Plancode). Jetzt im Angebot:

PlancodeCreditsPreisBonus
credits_3000_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4 (empfohlen)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • 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 hat recommended: 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, und total_millicredits (Millikredite) für die Kredite. Erworbene Kredite verfallen nicht; Packs können erneut gekauft werden und werden jeweils auf einmal geliefert.
  1. 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 mit quota_exceeded=true, ein Mediaprojekt endet mit error_code=insufficient_credits), und es werden keine Gebühren erhoben. Das Starten eines Auftrags ändert den Kontostand nicht.
  2. 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.
  3. 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.

GET /api/v1/billing/credits/operations?limit=20
GET /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.

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

Die Nutzungsendpunkte geben die Dateianzahl, Zeichen, Tokens und die Verarbeitungszeit des Kontos zurück.

Das Überprüfen von Guthaben, Auftragsstatus, Nutzung, Abrechnungsdaten, Ergebnislisten und Download-Adressen kostet keine Credits.