Angebote für KI-Vorgänge
Einheitlichen HQ-Guthabenstand anzeigen, genehmigte Modelltarife finden und kontobezogene Angebote vor der angebotsgebundenen KI-Ausführung anfordern.
KI-Preise und Angebotserkennung#
PDFHQ unterstützt kontogebundene KI-Preisermittlung und Angebote über HQTools. Die KI-Ausführung ist standardmäßig deaktiviert und verwendet eine separate Quote-gebundene Job-API; diese Quote-Endpunkte führen kein Modell aus und berechnen keine Guthaben. Genehmigte, aktive Modell-Tarife werden zurückgegeben; andernfalls ist die Liste leer. Aktiviere Preise nicht, bevor du Anbieterkosten überprüfst und HQTools-Tarife genehmigst.
curl 'https://api.pdfhq.io/v1/ai/billing/balance' -H 'x-api-key: YOUR_API_KEY'
curl 'https://api.pdfhq.io/v1/ai/billing/prices' -H 'x-api-key: YOUR_API_KEY'
# Model catalogue shows provider, tier and tariff availability; no credentials exposed.
curl 'https://api.pdfhq.io/v1/ai/billing/models' -H 'x-api-key: YOUR_API_KEY'
curl -X POST 'https://api.pdfhq.io/v1/ai/billing/quotes' \
-H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"price_id":"APPROVED_PRICE_ID","quantity":"1"}'Wähle OpenAI, Claude oder Gemini#
Die Modellliste wird von HQTools kuratiert und bepreist. Ein Modell wird nur als verfügbar angezeigt, wenn die Bereitstellung Inferenz ermöglicht, die Anbieter-Anmeldedaten serverseitig konfiguriert sind, das Modell auf der Operator-Allowlist steht und ein genehmigter HQTools-Tarif existiert. Das ausgewählte price_id bestimmt Anbieter, Modell und das HQ-Guthabenangebot; Aufrufer können dies nicht durch einen beliebigen Modellnamen überschreiben. Alle Modelle nutzen dieselben geprüften Dokumentnachweise, Zustimmungen, Projektisolierung und dauerhafte Abrechnung. Hinterlegen Sie niemals Anbieter-API-Schlüssel im Browsercode.
# 1. Find available models and approved prices
curl 'https://api.pdfhq.io/v1/ai/billing/models' -H 'x-api-key: YOUR_API_KEY'
curl 'https://api.pdfhq.io/v1/ai/billing/prices' -H 'x-api-key: YOUR_API_KEY'
# 2. Quote a price_id for your chosen provider/model; jobs use the returned quote_id
curl -X POST 'https://api.pdfhq.io/v1/ai/billing/quotes' \
-H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"price_id":"APPROVED_PRICE_ID","quantity":"1"}'Dual-Wallet-Preisgestaltung#
HQTools berechnet für jedes PDFHQ-AI-Angebot einen AI-Anbieter-Teil und einen separaten HQ-Verarbeitungsteil. Nur vertrauenswürdige Verarbeitungsdienste können Credits reservieren, abrechnen oder freigeben. Ein Kunde kann keine willkürliche tatsächliche Nutzung einreichen oder Credits durch Aufrufe dieser öffentlichen Routen reservieren. Das Angebot gibt eine Ablaufzeit zurück; verwende keine veralteten Angebote erneut.
Beide Wallets sind in deinem sichtbar Account-Credit-Dashboard . API-Schlüssel benötigen den Bereich pdfhq.ai.quote und eine aktivierte API-Berechtigung. Quote-gebundene asynchrone KI-Ausführung wird auf der KI-Jobs Seite; sie ist gesperrt, es sei denn, der Operator aktiviert und verifiziert seine Modell-, Abrechnungs- und Datenschutzkonfiguration.
