Kernaussage
X402 ist kein eigenständiges Preissystem. Jeder API-Aufruf hat bereits eigene Kosten in Credits, die die einzige Preisquelle für alle Abrechnungsmethoden (Abzug über API Token, Kontoguthaben, X402-On-Chain-Zahlung) darstellen. X402 rechnet diese Credits-Kosten lediglich zu einem festen Wechselkurs in On-Chain-USDC um:
1 Credit = 0.095215 USDC (d. h. 95215 atomic USDC, USDC hat 6 Dezimalstellen)
Das heißt:
Preisgrundlage
Die Umrechnung wird einheitlich von der Plattform durchgeführt, und der Betrag ist für alle unterstützten Netzwerke (Base, Solana) identisch; verschiedene Netzwerke unterscheiden sich nur in Asset-Verträgen und Signaturmethoden, der Preis ist gleich.
Verhältnis zum regulären Credits-Stückpreis
Plattform-Credits werden gestaffelt verkauft: „Je höher die Menge, desto niedriger der Stückpreis“. Bei der Abrechnung pro Aufruf verwendet X402 einheitlich den günstigsten Preis der Staffel:
Mit anderen Worten: X402 rechnet jeden Aufruf zum günstigsten Credits-Stückpreis ab. Nutzer, die Credits durch kleine Aufladungen kaufen, zahlen einen höheren Stückpreis als mit X402; nur Nutzer mit großen Aufladungen haben denselben Stückpreis wie X402.
Zwei Preisformen: exact und upto
In der 402-Antwort von X402 ist maxAmountRequired der Betrag, den Sie signieren müssen. Er hat zwei Formen:
exact(Festpreis): Der Preis kann vor der Verarbeitung der Anfrage bestimmt werden (Bilder, Videos, Musik, Suche, Bestellzahlungen).maxAmountRequired = Credits-Kosten des Aufrufs × 0.095215, also der für diesen Aufruf fällige Betrag (identisch mitcost.amountin der erfolgreichen Antwort).upto(verbrauchsbasierte nachträgliche Messung): Schnittstellen wie Chat Completions, bei denen erst nach Ende der Antwort bekannt ist, wie viele Token verwendet wurden.maxAmountRequiredist ein Höchstbetrag (umgerechnet anhand des für dieses Modell festgelegten Höchst-Credits: maximale Credits × 0.095215); tatsächlich wird nach dem realen Verbrauch abgerechnet und der Höchstbetrag nicht überschritten.
exact und upto Abrechnungsschemata. Im Folgenden geht es nur um Preise.
Chat-Preise (Chat Completions)
Chat Completions verwenden dieupto-Messung: Die Abrechnung erfolgt nach dem tatsächlichen Verbrauch von Prompt-/Completion-Token. Der Preis pro einer Million (1M) Token = Credits-Kosten dieses Modells pro 1M Token × 0.095215 und entspricht vollständig dem USD-Stückpreis, der im öffentlichen Modellkatalog der Plattform (/api/v1/models?with_pricing=true) angezeigt wird.
Die folgende Tabelle zeigt die tatsächlichen Preise (aus dem Modellkatalog, nach dem X402-Wechselkurs berechnet), in USD / 1M Token:
Hinweise:
- Die Tabelle zeigt die nach Token gemessenen Stückpreise; die Kosten einer Anfrage = Eingabe-Token × Eingabe-Stückpreis + Ausgabe-Token × Ausgabe-Stückpreis.
- Die
upto-Obergrenze ist der maximale Betrag, der für eine Anfrage dieses Modells signiert werden darf; sie ist nicht die tatsächliche Abbuchung, und die meisten Anfragen liegen deutlich unter der Obergrenze. - Die Obergrenze bestimmt nur, „wie viel maximal abgebucht werden könnte“; die tatsächliche Abrechnung erfolgt nach dem Token-Verbrauch.
Beispiel: Angebot und Abbuchung stimmen überein (exact)
Im Folgenden sehen Sie einen tatsächlich kostenpflichtigen Aufruf, der mit dem offiziellen X402Client an serp/google gesendet wurde (Base exact). Er demonstriert die Übereinstimmung von drei Punkten: dem 402-Angebot, dem signierten Betrag und den in der erfolgreichen Antwort zurückgegebenen cost.
cost.amount (0.000952 USDC) stimmt vollständig mit dem 402-Angebot und mit Credits × 0.095215 überein. Das Feld settlement ist der Abrechnungsstatus dieser Zahlung (authorized = autorisiert); die On-Chain-Abrechnung wird von der Plattform verarbeitet, siehe den Mechanismus in den Abrechnungsmodellen exact und upto.
Berechnung des upto-Angebots (Chat)
Chat wird nach Tokens berechnet. Das Angebot einer bestimmten Anfrage (nicht das Limit) wird nach folgender Formel berechnet (am Beispiel von gpt-4o-mini):
upto-Limit (für gpt-4o-mini: 1 Credit = 95215 atomic), dies ist nur der Betrag, der höchstens möglicherweise abgebucht wird; das tatsächliche Angebot dieser Anfrage (im obigen Beispiel etwa $0.0001) liegt weit unter dem Limit und wird nach Token-Verbrauch abgerechnet. Den On-Chain-Abrechnungsmechanismus von upto finden Sie in den Abrechnungsmodellen exact und upto.
Preise anderer Dienste (Festpreis exact)
Bei Schnittstellen wie Bild, Video, Musik und Suche kann der Preis bereits bei der Anfrage bestimmt werden, daher wird exact verwendet. Die folgende Tabelle enthält tatsächliche Preise, entnommen aus dem 402-maxAmountRequired, das von Online-Schnittstellen für unbezahlte Anfragen zurückgegeben wird (eine Angebotsabfrage verursacht keine Gebühren):
Hinweise:
- Die Preise desselben Dienstes variieren je nach Modell, Auflösung, Dauer und Aktion (insbesondere bei Videos). Die obige Tabelle zeigt tatsächliche Werte für einen bestimmten Parametersatz und dient nur als Referenz für die Größenordnung.
- Bei diesen Festpreis- (
exact-) Schnittstellen istmaxAmountRequiredin der 402-Antwort dieser Anfrage genau der für diese Anfrage zu zahlende Betrag (identisch mitcost.amountin der erfolgreichen Antwort, wie im vorherigen Abschnitt getestet). - Jeder Preis wird durch Abrunden von
Credits × 0.095215auf die atomic-Einheit berechnet (siehe oben zur Preisgrundlage), wobei dieselbe Umrechnung wie beim Chat verwendet wird. Aufgrund von Fließkommadarstellung und Rundung können einzelne Werte um 1 atomic ($0.000001) vom naiven Produkt abweichen; maßgeblich ist stets der 402-Rückgabewert.
Preis der Bestellzahlung
Beim Bezahlen von Konsolenbestellungen mit X402 (Kauf von Paketen / Aufladen von Credits) gilt der auf der Bestellseite angezeigte Preis, undamount von 402 ist die endgültige Grundlage für die Signatur. Bestellzahlungen erfolgen über die Plattform-API und erfordern ein Kontotoken; Details finden Sie im Tutorial zur Bestellzahlung.
Ein tatsächliches Beispiel aus dem Tutorial zur Bestellzahlung (Kauf von 10 Credits):
0.095215/Credit; bei der Bestellzahlung gelten Paketpreise, und für die Differenz zwischen Erstellungspreis und endgültigem Abrechnungsbetrag ist das Tutorial zur Bestellzahlung maßgeblich.
So erhalten Sie Preise in Echtzeit
Die Preise ändern sich je nach Modell und Parametern. Rufen Sie sie bitte programmgesteuert in Echtzeit ab, statt sie fest zu codieren:- Preis pro Aufruf: Senden Sie eine Anfrage an die Ziel-API ohne
PAYMENT-SIGNATURE(und auch ohneAuthorization) und lesen Sie das zurückgegebene 402-accepts[].maxAmountRequired. Dieser Schritt verursacht keine Gebühren. Beiexact-Schnittstellen ist dies der endgültige Preis; beiupto-Schnittstellen (Chat) ist dies das Limit, die tatsächliche Abrechnung erfolgt nach Verbrauch. - Chat-Preis pro Token:
GET https://platform.acedata.cloud/api/v1/models?with_pricing=true&type=chat, lesen Sie für jedes Modellpricing.input_usd/pricing.output_usd(bereits anhand voncredit_usd_rateberechnet). - Umrechnungsprüfung:
atomic = floor(Credits × 0.095215 × 1e6),USDC = atomic / 1e6(d. h.USDC ≈ Credits × 0.095215).
Zusammenfassung
- X402-Preis = die Credits-Kosten dieses Aufrufs ×
0.095215, derselbe Preis wie bei der normalen Credits-Abrechnung, nur dass die Abrechnung mit On-Chain-USDC erfolgt. 0.095215/Credit ist der Credits-Stückpreis der Plattform in der besten Preisstufe (große Mengen); beim Kauf von Credits durch kleinere Aufladungen ist der Stückpreis höher, daher entspricht X402 dem automatischen Erhalt des besten Stückpreises.- Bei
exact-Schnittstellen (Bilder / Videos / Musik / Suche / Bestellungen) ist der signierte Betrag der für diesen Vorgang zu zahlende Betrag; beiupto-Schnittstellen (Chat) wird das Limit signiert und nach dem tatsächlichen Verbrauch abgerechnet. - Der maßgebliche Preis richtet sich nach dem von 402 zurückgegebenen
maxAmountRequired: Beiexacthandelt es sich um den zu zahlenden Betrag (identisch mitcost.amountin der erfolgreichen Antwort, bereits getestet); beiuptohandelt es sich um das Limit, und erstcost.amountin der erfolgreichen Antwort ist der nach Verbrauch abgerechnete tatsächliche Betrag (≤ Limit).

