> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # X402 Preisbeschreibung > Platform API guide - Ace Data Cloud Dieses Dokument erklärt, wie die Preise bei der Verwendung von X402 zur Abfrage der Ace Data Cloud API festgelegt werden und wie sie mit den Preisen der regulären **Credits** (Kontingent) der Plattform in Beziehung stehen. ## Kernschlussfolgerung X402 ist kein eigenständiges Preissystem. Jeder API-Aufruf hat bereits einen Kostenpunkt, der in **Credits** gemessen wird, und dies ist die einzige Preisquelle, die von allen Abrechnungsarten (API-Token-Abzug, Kontostand, X402 On-Chain-Zahlung) gemeinsam genutzt wird. X402 wandelt diese Credits-Kosten einfach zu einem festen Wechselkurs in On-Chain USDC um: > **1 Credit = 0.095215 USDC** (d.h. `95215` atomare USDC, USDC hat 6 Dezimalstellen) Das bedeutet: ```text theme={null} X402 Preis (USDC) = Die Credits-Kosten dieses Aufrufs × 0.095215 ``` Dieser Wechselkurs ist nicht willkürlich festgelegt, sondern entspricht dem **optimalen (Groß-)Credits-Einheitspreis** der Plattform. Daher ist die Bezahlung mit X402 ≈ der Kauf von Credits zum optimalen Einheitspreis und **es gibt keinen X402 Aufpreis**, sondern man profitiert direkt vom günstigsten Credits-Einheitspreis, ohne Vorauszahlung und ohne API-Token. ## Bewertungsbasis | Posten | Wert | Beschreibung | | - | - | - | | Wechselkurs | `1 Credit = 0.095215 USDC` | Festgelegter Wechselkurs der Plattform | | atomare Einheit | `1 Credit = 95215 atomare USDC` | USDC hat 6 Dezimalstellen, `atomic = floor(credits × 0.095215 × 1e6)` | | Mindestabzug | `1 atomare USDC`（\$0.000001） | Selbst bei extrem niedrigen Kosten wird mindestens 1 atomare Einheit abgerechnet | | Bewertungswährung | USDC | Base / SKALE ist ERC-20 USDC, Solana ist SPL USDC | Die Umrechnung erfolgt einheitlich durch die Plattform, die Beträge sind für alle unterstützten Netzwerke (Base, SKALE, Solana) identisch; die verschiedenen Netzwerke unterscheiden sich lediglich in den Vermögensverträgen und der Signaturmethode, der Preis bleibt gleich. ### Beziehung zu den regulären Credits-Einheitspreisen Die Plattform verkauft Credits nach dem Prinzip „je mehr genutzt wird, desto niedriger der Preis“ in Stufen. Bei der Abrechnung von X402 wird einheitlich der optimale Stufenpreis verwendet: | Kauf-/Zahlungsart | Ungefährer Credits-Einheitspreis | Beschreibung | | - | - | - | | Einstieg / Kleinstbeträge | Ca. `$0.13 / Credit` | Listenpreis, Einheitspreis beim Kauf von Credits in kleinen Beträgen | | Großbeträge / optimaler Preis | `$0.095215 / Credit` | Günstigster Einheitspreis | | **X402 nach Aufruf bezahlen** | **`$0.095215 / Credit`** | **Immer gleich dem optimalen Einheitspreis** | Anders ausgedrückt, X402 rechnet jeden Aufruf zum optimalen Credits-Einheitspreis ab. Nutzer, die Credits in kleinen Beträgen kaufen, zahlen einen höheren Preis als X402; nur Nutzer, die in großen Beträgen aufladen, haben den gleichen Preis wie X402. ## Zwei Preisformen: `exact` und `upto` In der 402-Antwort von X402 ist `maxAmountRequired` der Betrag, den Sie signieren müssen. Es gibt zwei Formen: * **`exact` (Festpreis)**: Der Preis kann vor der Bearbeitung der Anfrage festgelegt werden (Bilder, Videos, Musik, Suche, Bestellzahlung). `maxAmountRequired = Die Credits-Kosten dieses Aufrufs × 0.095215`, d.h. der zu zahlende Betrag für diesen Aufruf (entspricht dem `cost.amount` in der erfolgreichen Antwort). * **`upto` (Nutzungsabhängige Abrechnung)**: Schnittstellen wie Chat-Vervollständigung, bei denen „erst am Ende der Antwort bekannt ist, wie viele Tokens verwendet wurden“. `maxAmountRequired` ist ein **Obergrenze** (umgerechnet nach dem festgelegten Obergrenzenmodell: Obergrenze Credits × 0.095215), die tatsächliche Abrechnung erfolgt nach dem tatsächlichen Verbrauch und überschreitet nicht die Obergrenze. Details zu den Protokollen dieser beiden Modelle finden Sie in den [Abrechnungsplänen `exact` und `upto`](https://platform.acedata.cloud/documents/x402-metered-upto). Im Folgenden wird nur der Preis behandelt. ## Chat (Chat-Vervollständigung) Preis Die Chat-Vervollständigung wird nach dem `upto`-Modell abgerechnet: basierend auf dem tatsächlichen Verbrauch von Prompt / Completion Tokens. Der Preis pro Million (1M) Tokens = `Die Credits-Kosten des Modells pro 1M Tokens × 0.095215`, was vollständig mit dem in dem öffentlichen Modellverzeichnis der Plattform angezeigten USD-Einheitspreis übereinstimmt (`/api/v1/models?with_pricing=true`). Die folgende Tabelle zeigt die tatsächlichen Preise (entnommen aus dem Modellverzeichnis, gemäß dem X402-Wechselkurs), Einheit USD / 1M Token: | Modell | Eingabe / 1M | Ausgabe / 1M | `upto` Obergrenze | | - | - | - | - | | gpt-4o-mini | \$0.0796 | \$0.3183 | 1 Credit（\$0.095215） | | gemini-2.5-flash | \$0.1591 | \$1.3262 | 5 Credits（\$0.476074） | | gpt-5 / gpt-5.1 | \$0.6631 | \$5.3050 | 20 Credits（\$1.904299） | | gemini-2.5-pro | \$0.6631 | \$5.3050 | 50 Credits（\$4.760750） | | gpt-4.1 | \$1.0610 | \$4.2440 | 20 Credits（\$1.904299） | | claude-sonnet-4-5 | \$0.6006 | \$3.0028 | 50 Credits（\$4.760750） | | grok-4 | \$1.5915 | \$7.9574 | 10 Credits（\$0.952149） | | claude-opus-4-1 | \$3.0028 | \$15.0140 | 50 Credits（\$4.760750） | Hinweis: * In der Tabelle sind die Einheitspreise nach Token abgerechnet; die Kosten für eine Anfrage = Eingabe-Token × Eingabeeinheitspreis + Ausgabe-Token × Ausgabeeinheitspreis. * Die `upto`-Obergrenze ist der maximal erlaubte Betrag, den das Modell für eine Anfrage signieren kann; dies ist nicht der tatsächliche Abzug, die meisten Anfragen liegen weit unter der Obergrenze. * Die Obergrenze bestimmt nur „wie viel maximal abgezogen werden kann“, die tatsächliche Abrechnung erfolgt nach dem Tokenverbrauch. ### Beispiel: Preisangebot und Abzug stimmen überein (`exact`) Hier ist ein **echter kostenpflichtiger Aufruf** (Base `exact`), der mit dem offiziellen X402Client an `serp/google` gesendet wurde. Es zeigt die Übereinstimmung der drei Werte: 402 Preisangebot, signierter Betrag und der in der erfolgreichen Antwort zurückgegebene `cost`. ```text theme={null} # 1) Unbezahlte Anfrage -> 402, Preisangebot erhalten (keine Kosten) POST /serp/google -> 402 base/exact maxAmountRequired = 952 atomic = $0.000952 = 0.01 Credit # 0.01 × 0.095215 = 0.00095215, abgerundet auf atomic = 952 # 2) Mit Wallet 952 atomare Einheiten der PAYMENT-SIGNATURE signieren, erneut versuchen POST /serp/google (PAYMENT-SIGNATURE) -> 200 body.cost = {"amount": 0.000952, "currency": "usdc", "settlement": "authorized"} ``` 响应 zurückgegebene `cost.amount` (0.000952 USDC) entspricht vollständig dem 402 Angebot und `Credits × 0.095215`. Das `settlement` Feld ist der Abrechnungsstatus dieser Zahlung (`authorized` = autorisiert); die On-Chain-Abrechnung wird von der Plattform verarbeitet, Mechanismus siehe [`exact` und `upto` Abrechnungsmodelle](https://platform.acedata.cloud/documents/x402-metered-upto). ### `upto` Angebotsberechnung (Chat) Chats werden nach Token gemessen. Das Angebot für eine bestimmte Anfrage (nicht das Limit) wird nach folgender Formel berechnet (am Beispiel von gpt-4o-mini): ```text theme={null} Credits = 1e-6 × (0.835733 × prompt_tokens + 3.342933 × completion_tokens) USDC = Credits × 0.095215 ``` Eine Anfrage mit 500 Prompt + 200 Completion Token: ```text theme={null} Credits = 1e-6 × (0.835733 × 500 + 3.342933 × 200) ≈ 0.001086 Credits Angebot USDC ≈ 0.001086 × 0.095215 ≈ $0.0001034 ``` Der Client signiert nach dem `upto` Limit (gpt-4o-mini ist 1 Credit = `95215` atomic), dies ist nur **das Maximum, das abgezogen werden kann**; das tatsächliche Angebot dieser Anfrage (im obigen Beispiel etwa \$0.0001) liegt weit unter dem Limit und wird nach dem Tokenverbrauch abgerechnet. Der On-Chain-Abrechnungsmechanismus von `upto` siehe [`exact` und `upto` Abrechnungsmodelle](https://platform.acedata.cloud/documents/x402-metered-upto). ## Andere Dienstpreise (Festpreis `exact`) Schnittstellen wie Bilder, Videos, Musik, Suche haben beim Anfordern einen festgelegten Preis, verwenden `exact`. Die folgende Tabelle zeigt die tatsächlichen Preise, entnommen aus der Online-Schnittstelle für unbezahlte Anfragen, die 402 `maxAmountRequired` zurückgeben (Angebotsanfragen verursachen keine Gebühren): | Dienst | Beispielmodell / Parameter | Credits | USDC | atomic | | - | - | - | - | - | | Websuche | serp/google, ≤10 Ergebnisse | 0.01 | \$0.000952 | 952 | | Bild | nano-banana | 0.14 | \$0.013330 | 13330 | | Bild | gpt-image-1, 1024×1024 | 0.20 | \$0.019043 | 19043 | | Bild | flux-dev | 0.24 | \$0.022851 | 22851 | | Bild | midjourney imagine | 0.27 | \$0.025708 | 25708 | | Bild | seedream-4 | 0.32 | \$0.030468 | 30468 | | Musik | suno generate | 0.55 | \$0.052368 | 52368 | | Musik | producer generate | 0.68 | \$0.064746 | 64746 | | Video | luma | 1.19 | \$0.113305 | 113305 | | Video | hailuo (minimax-hailuo-2-3) | 1.72 | \$0.163769 | 163769 | | Video | kling-v2-6 std | 2.10 | \$0.199951 | 199951 | | Video | kling-v3 std | 4.20 | \$0.399903 | 399903 | | Video | veo-3 text→video | 5.00 | \$0.476074 | 476074 | | Video | seedance-1-0-pro, 1080p / 5s | 5.60 | \$0.533204 | 533204 | | Video | wan2.6-t2v | 13.50 | \$1.285402 | 1285402 | Hinweis: * Die Preise für denselben Dienst variieren je nach **Modell, Auflösung, Dauer, Aktion** (insbesondere bei Videos). Die obige Tabelle zeigt die tatsächlichen Werte für eine bestimmte Gruppe von Parametern, nur zur groben Orientierung. * Bei diesen Festpreis- (`exact`) Schnittstellen ist der `maxAmountRequired` in der 402 Antwort der Betrag, der für diese Anfrage zu zahlen ist (übereinstimmend mit dem `cost.amount` der erfolgreichen Antwort, wie im vorherigen Abschnitt getestet). * Jeder Preis wird durch `Credits × 0.095215` auf die atomic Einheit abgerundet (siehe oben zur Preisberechnung), und es wird die gleiche Umrechnung wie bei Chats verwendet. Aufgrund von Fließkommadarstellung und Abrundung kann es bei einzelnen Werten zu einer Abweichung von 1 atomic (\$0.000001) kommen, in jedem Fall ist der 402 Rückgabewert maßgeblich. ## Bestellzahlungsbetrag Bei der Zahlung von Bestellungen über das X402 Zahlungsportal (Kauf von Paketen / Aufladen von Credits) gilt der Preis, der auf der Bestellseite angezeigt wird, als maßgeblich, der Betrag in der 402 ist die endgültige Signaturgrundlage. Die Bestellzahlung erfolgt über die Plattform-API und benötigt ein Kontotoken, siehe [Bestellzahlungstutorial](https://platform.acedata.cloud/documents/x402-order-payment). Ein echtes Beispiel aus dem Bestellzahlungstutorial (Kauf von 10 Credits): ```text theme={null} description Ace Data Cloud Credits x 10.0 created price 1.26 # Bestellpreis (USD) settled 1.20 USDC # Endgültiger Signatur-/Abrechnungsbetrag (= 402 amount) = 1200000 atomic USDC ``` Hinweis: **Pay-per-call** (oben Chat / andere Dienste) und **Bestellzahlung** sind zwei verschiedene Wege. Pay-per-call verwendet einheitlich den optimalen Einzelpreis von `0.095215`/Credit; die Bestellzahlung erfolgt zu Paketpreisen, wobei die Differenz zwischen dem Erstellungsbetrag und dem endgültigen Abrechnungsbetrag gemäß [Bestellzahlungstutorial](https://platform.acedata.cloud/documents/x402-order-payment) zu berücksichtigen ist. ## So erhalten Sie Preise in Echtzeit Die Preise variieren je nach Modell und Parametern, bitte verwenden Sie Programme, um sie in Echtzeit abzurufen, und kodieren Sie sie nicht fest: * **Pay-per-call Preis**: Senden Sie eine Anfrage an die Ziel-API **ohne** `PAYMENT-SIGNATURE` (auch ohne `Authorization`), um den zurückgegebenen 402 `accepts[].maxAmountRequired` zu lesen. Dieser Schritt verursacht keine Gebühren. Für `exact` Schnittstellen ist dies der endgültige Preis; für `upto` Schnittstellen (Chat) ist es das Limit, das tatsächlich nach Verbrauch abgerechnet wird. * **Chat Preis pro Token**: `GET https://platform.acedata.cloud/api/v1/models?with_pricing=true&type=chat`, lesen Sie den `pricing.input_usd` / `pricing.output_usd` jedes Modells (bereits nach `credit_usd_rate` berechnet). * **Umrechnungsprüfung**: `atomic = floor(Credits × 0.095215 × 1e6)`, `USDC = atomic / 1e6` (d.h. `USDC ≈ Credits × 0.095215`). Beispiel für die kleinste Anfrage zur Preisabfrage: ```bash theme={null} curl -sS -X POST https://x402.acedata.cloud/midjourney/imagine \ -H 'Content-Type: application/json' \ -d '{"prompt": "a cat"}' # Rückgabe 402, accepts[].maxAmountRequired ist der Preis für diesen (exact) Aufruf ``` ## Zusammenfassung * X402 Preis = Die Kosten in Credits für diesen Aufruf × `0.095215`, und es ist der **gleiche Preis** wie bei normalen Credits, nur dass es in on-chain USDC abgerechnet wird. * `0.095215`/Credit ist der **optimale Tarif** (Großbeträge) für Credits; bei kleinen Aufladungen ist der Preis pro Credit höher, daher erhält man bei X402 automatisch den optimalen Preis. * Der `exact` Schnittstelle (Bilder / Videos / Musik / Suche / Bestellungen) signierte Betrag ist der zu zahlende Betrag; die `upto` Schnittstelle (Chat) signiert das Limit, abgerechnet wird nach dem tatsächlichen Verbrauch. * Der maßgebliche Preis richtet sich nach dem `maxAmountRequired`, das von 402 zurückgegeben wird: `exact` ist der zu zahlende Betrag (übereinstimmend mit dem `cost.amount` der erfolgreichen Antwort, bereits getestet); `upto` ist das Limit, der `cost.amount` der erfolgreichen Antwort ist der tatsächliche Betrag, der nach Verbrauch abgerechnet wird (≤ Limit). ## Verwandte Dokumente | Dokument | Link | | - | - | | X402 Integrationsleitfaden (Übersicht) | [X402 Integrationsleitfaden](https://platform.acedata.cloud/documents/x402-integration) | | Schnellstart | [X402 Schnellstart](https://platform.acedata.cloud/documents/x402-quickstart) | | `exact` und `upto` Abrechnungsmodelle | [Abrechnungsmodellbeschreibung](https://platform.acedata.cloud/documents/x402-metered-upto) | | Netzwerke und Zahlungsmethoden | [Netzwerke und Zahlungsmethoden](https://platform.acedata.cloud/documents/x402-networks) | | Bestellzahlung Anleitung | [Bestellzahlung Anleitung](https://platform.acedata.cloud/documents/x402-order-payment) | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.