X402 Preisbeschreibung

​

Kernschlussfolgerung

1 Credit = 0.095215 USDC (d.h. 95215 atomare USDC, USDC hat 6 Dezimalstellen)

X402 Preis (USDC) = Die Credits-Kosten dieses Aufrufs × 0.095215

​

Bewertungsbasis

​

Beziehung zu den regulären Credits-Einheitspreisen

​

Zwei Preisformen: exact und upto

• 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.

​

Chat (Chat-Vervollständigung) Preis

• 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)

# 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"}

​

upto Angebotsberechnung (Chat)

Credits = 1e-6 × (0.835733 × prompt_tokens + 3.342933 × completion_tokens)
USDC    = Credits × 0.095215

Credits = 1e-6 × (0.835733 × 500 + 3.342933 × 200) ≈ 0.001086 Credits
Angebot USDC ≈ 0.001086 × 0.095215 ≈ $0.0001034

​

Andere Dienstpreise (Festpreis exact)

• 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

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

​

So erhalten Sie Preise in Echtzeit

• 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).

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