Kärnslutsats
X402 är inte ett separat prissystem. Varje API-anrop har redan en kostnad räknad i Credits, vilket är den enda priskällan som delas av alla betalningsmetoder (avdrag från API Token-krediter, kontosaldo, X402-betalning on-chain). X402 omvandlar bara denna Credits-kostnad till USDC on-chain enligt en fast växelkurs:
1 Credit = 0.095215 USDC (dvs. 95215 atomic USDC, där USDC har 6 decimaler)
Det vill säga:
Prisgrund
Omvandlingen utförs enhetligt av plattformen, och beloppet är detsamma för alla nätverk som stöds (Base, Solana); olika nätverk skiljer sig endast åt i tillgångskontrakt och signeringsmetod, medan priset är samma.
Relation till vanliga Credits-priser per enhet
Plattformens Credits säljs i nivåer enligt principen ”ju högre användning, desto lägre pris per enhet”. Vid debitering per anrop använder X402 enhetligt priset per enhet för den bästa nivån:
Med andra ord avräknar X402 varje anrop enligt Credits-priset per enhet för bästa nivå. Användare som köper Credits genom små påfyllningar får ett högre pris per enhet än X402; endast användare som fyller på stora volymer har samma pris per enhet som X402.
Två prisformer: exact och upto
I X402:s 402-svar är maxAmountRequired beloppet du ska signera. Det har två former:
exact(fast pris): Priset kan fastställas innan begäran behandlas (bilder, videor, musik, sökning, orderbetalning).maxAmountRequired = Credits-kostnaden för anropet × 0.095215, dvs. det betalbara beloppet för detta anrop (samma somcost.amounti det lyckade svaret).upto(användning mäts i efterhand): Gränssnitt såsom chattkomplettering, där det först när svaret är klart går att veta hur många token som använts.maxAmountRequiredär en övre gräns (omräknad enligt den övre gränsen för Credits som anges för modellen: maximal Credits × 0.095215), och faktisk avräkning sker enligt verklig användning, utan att överskrida gränsen.
exact och upto. Nedan behandlas endast priser.
Chat-priser (chattkomplettering)
Chattkomplettering använderupto-mätning: debitering sker enligt faktisk användning av prompt- / completion-token. Priset per en miljon (1M) token = modellens Credits-kostnad per 1M token × 0.095215, vilket är helt identiskt med USD-priset per enhet som visas i plattformens offentliga modellkatalog (/api/v1/models?with_pricing=true).
Tabellen nedan visar faktiska priser (hämtade från modellkatalogen och beräknade enligt X402-växelkursen), i USD / 1M token:
Beskrivning:
- Tabellen visar priser per enhet baserat på token-mätning; kostnaden för en begäran = indata-token × indata-pris per enhet + utdata-token × utdata-pris per enhet.
upto-gränsen är det maximala beloppet som får signeras för en begäran för denna modell; det är inte den faktiska debiteringen, och de allra flesta begäranden ligger långt under gränsen.- Gränsen avgör endast ”hur mycket som maximalt kan debiteras”; den faktiska avräkningen beräknas enligt token-användningen.
Exempel: offert och debitering stämmer överens (exact)
Nedan visas ett verkligt betalt anrop till serp/google med den officiella X402Client (Base exact). Det visar att följande tre är konsekventa: 402-offerten, signeringsbeloppet och den cost som returneras i det lyckade svaret.
cost.amount (0.000952 USDC) överensstämmer helt med 402-offerten och med Credits × 0.095215. Fältet settlement är avvecklingsstatusen för denna betalning (authorized = auktoriserad); avveckling på kedjan hanteras av plattformen, mekanismen beskrivs i debiteringsmodellerna exact och upto.
Beräkning av upto-offert (chatt)
Chatt mäts per token. Offerten för en viss begäran (inte taket) beräknas enligt följande formel (med gpt-4o-mini som exempel):
upto-taket (för gpt-4o-mini är 1 Credit = 95215 atomic), vilket bara är det maximalt möjliga beloppet som kan debiteras; den faktiska offerten för denna begäran (cirka $0.0001 i exemplet ovan) är mycket lägre än taket och avräknas enligt tokenanvändning. upto-mekanismen för avveckling på kedjan beskrivs i debiteringsmodellerna exact och upto.
Priser för andra tjänster (fast pris exact)
För API:er som bilder, video, musik och sökningar kan priset fastställas vid begäran, och de använder exact. Tabellen nedan visar faktiska priser, hämtade från 402 maxAmountRequired som online-API:erna returnerar för obetalda begäranden (att fråga efter en offert medför ingen debitering):
Förklaring:
- Priset för samma tjänst varierar med modell, upplösning, längd och rörelse (särskilt för video). Tabellen ovan visar faktiska värden för en viss uppsättning parametrar och är endast avsedd som storleksreferens.
- För denna typ av API med fast pris (
exact) ärmaxAmountRequiredi begärans 402-svar det belopp som ska betalas för denna gång (överensstämmer medcost.amounti det lyckade svaret, vilket har testats i föregående avsnitt). - Varje pris fås genom att avrunda
Credits × 0.095215nedåt till atomic-enheter (se prissättningsgrunden ovan), och samma omvandling används som för chatt. På grund av flyttalsrepresentation och avrundning kan enstaka värden skilja sig med 1 atomic ($0.000001) från den naiva produkten; 402-returvärdet gäller alltid.
Pris för orderbetalning
Vid betalning av kontrollpanelorder med X402 (köp av paket / påfyllning av Credits) gäller priset som visas på ordersidan, och 402:samount är den slutliga grunden för signering. Orderbetalningar går via plattformens API och kräver en kontotoken, se handledningen för orderbetalning.
Ett verkligt exempel från handledningen för orderbetalning (köp av 10 Credits):
0.095215/Credit; orderbetalning prissätts per paket, och skillnaden mellan dess skapandepris och slutliga avvecklingsbelopp följer handledningen för orderbetalning.
Hur man hämtar priser i realtid
Priser varierar med modeller och parametrar, så hämta dem i realtid programmatiskt och hårdkoda dem inte:- Pris per anrop: Skicka en begäran till mål-API:t utan
PAYMENT-SIGNATURE(och även utanAuthorization), och läs 402:s returneradeaccepts[].maxAmountRequired. Detta medför ingen debitering. Förexact-API:er är det slutpriset; förupto-API:er (chatt) är det taket, medan den faktiska avräkningen baseras på användning. - Chattpris per token:
GET https://platform.acedata.cloud/api/v1/models?with_pricing=true&type=chat, läspricing.input_usd/pricing.output_usdför varje modell (redan beräknat enligtcredit_usd_rate). - Kontroll av omvandling:
atomic = floor(Credits × 0.095215 × 1e6),USDC = atomic / 1e6(dvs.USDC ≈ Credits × 0.095215).
Sammanfattning
- X402-priset = Credits-kostnaden för det aktuella anropet ×
0.095215, vilket är samma pris som vanlig Credits-debitering, men avräknas med USDC på kedjan. 0.095215/Credit är plattformens mest förmånliga nivå (stora volymer) för Credits-enhetspriset; mindre påfyllningar för att köpa Credits har ett högre enhetspris, så X402 innebär automatiskt att man får det mest förmånliga enhetspriset.- För
exact-gränssnitt (bild / video / musik / sökning / order) är det signerade beloppet det belopp som ska betalas för det aktuella anropet; förupto-gränssnitt (chatt) signeras en övre gräns, och avräkning sker enligt faktisk användning. - Det auktoritativa priset baseras på
maxAmountRequiredsom returneras av 402: förexactär det det belopp som ska betalas (överensstämmer medcost.amounti ett lyckat svar, verifierat genom test); föruptoär det den övre gränsen, medancost.amounti ett lyckat svar är det faktiska belopp som avräknas enligt användning (≤ övre gränsen).

