Hoppa till huvudinnehåll
Det här dokumentet förklarar hur priset fastställs när Ace Data Cloud API anropas med X402, och hur det förhåller sig till plattformens vanliga pris för Credits (krediter).

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:
Denna växelkurs är inte satt godtyckligt, utan motsvarar plattformens bästa nivå (stora volymer) Credits-pris per enhet. Att betala med X402 ≈ att köpa Credits till priset för bästa nivå och sedan använda dem, utan X402-påslag. Tvärtom får du direkt det billigaste Credits-priset per enhet, utan behov av förskottsladdning eller API Token.

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 som cost.amount i 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.
Protokolldetaljer om dessa två scheman finns i betalningsscheman för exact och upto. Nedan behandlas endast priser.

Chat-priser (chattkomplettering)

Chattkomplettering använder upto-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.
Det returnerade 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):
En begäran med 500 prompt-token + 200 completion-token:
Klienten signerar enligt 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) är maxAmountRequired i begärans 402-svar det belopp som ska betalas för denna gång (överensstämmer med cost.amount i det lyckade svaret, vilket har testats i föregående avsnitt).
  • Varje pris fås genom att avrunda Credits × 0.095215 nedå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:s amount ä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):
Observera: betalning per anrop (Chat / andra tjänster ovan) och orderbetalning är två olika vägar. Betalning per anrop använder konsekvent det optimala priset 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 utan Authorization), och läs 402:s returnerade accepts[].maxAmountRequired. Detta medför ingen debitering. För exact-API:er är det slutpriset; för upto-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äs pricing.input_usd / pricing.output_usd för varje modell (redan beräknat enligt credit_usd_rate).
  • Kontroll av omvandling: atomic = floor(Credits × 0.095215 × 1e6), USDC = atomic / 1e6 (dvs. USDC ≈ Credits × 0.095215).
Exempel på minimal begäran för att hämta pris:

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ör upto-gränssnitt (chatt) signeras en övre gräns, och avräkning sker enligt faktisk användning.
  • Det auktoritativa priset baseras på maxAmountRequired som returneras av 402: för exact är det det belopp som ska betalas (överensstämmer med cost.amount i ett lyckat svar, verifierat genom test); för upto är det den övre gränsen, medan cost.amount i ett lyckat svar är det faktiska belopp som avräknas enligt användning (≤ övre gränsen).

Relaterad dokumentation