Skip to main content
Detta dokument förklarar hur priserna sätts när man använder X402 för att anropa Ace Data Cloud API, samt hur det relaterar till plattformens vanliga Credits (krediter) priser.

Kärnkonklusion

X402 är inte ett fristående prissystem. Varje API-anrop har redan en kostnad som mäts i Credits, vilket är den enda gemensamma priskällan för alla faktureringsmetoder (API-token avdrag, kontobalans, X402 betalning på kedjan). X402 omvandlar bara denna Credits-kostnad till kedje-USDC enligt en fast växelkurs:
1 Credit = 0.095215 USDC (dvs 95215 atomiska USDC, USDC har 6 decimaler)
Det betyder att:
Denna växelkurs är inte godtyckligt fastställd, den är lika med plattformens optimala nivå (stora) Credits enhetspris. Så att betala med X402 ≈ att köpa Credits till det optimala enhetspriset och sedan konsumera, ingen X402-premie, utan istället direkt njuta av det billigaste Credits enhetspriset, utan att behöva förladda, utan API-token.

Prissättningsgrund

Omvandlingen görs enhetligt av plattformen, beloppet är detsamma för alla stödda nätverk (Base, SKALE, Solana); olika nätverk har bara olika tillgångskontrakt och signeringsmetoder, men priset är detsamma.

Relation till vanliga Credits enhetspriser

Plattformens Credits säljs enligt en trappa där “ju mer man använder, desto lägre enhetspris”. X402 använder det optimala enhetspriset vid fakturering per anrop: Med andra ord, X402 avräknar varje anrop enligt det optimala Credits enhetspriset. Användare som köper Credits i små mängder kommer att ha ett högre enhetspris än X402; användare som gör stora insättningar har samma enhetspris som X402.

Två prissättningsformer: exact och upto

I X402:s 402-svar är maxAmountRequired det belopp du ska signera. Det finns två former:
  • exact (fast pris): Priset kan fastställas innan begäran behandlas (bilder, videor, musik, sökningar, orderbetalningar). maxAmountRequired = den här anropets Credits kostnad × 0.095215, vilket är det belopp som ska betalas (överensstämmer med cost.amount i det framgångsrika svaret).
  • upto (användning efter mätning): Gränssnitt som “chat completions” där “man vet först efter svaret hur många tokens som använts”. maxAmountRequired är en övre gräns (beräknad enligt den här modellen: övre Credits × 0.095215), den faktiska avräkningen görs baserat på verklig användning, och överstiger inte gränsen.
För detaljer om dessa två scheman, se exact och upto prissättningsplan. Nedan diskuteras endast priser.

Chat (chat completions) priser

Chat completions är upto mätning: avgifter baseras på faktisk användning av prompt / completion tokens. Priset per miljon (1M) tokens = den här modellens Credits kostnad per 1M tokens × 0.095215, vilket är helt i linje med plattformens offentliga modellkatalog (/api/v1/models?with_pricing=true). Nedanstående tabell visar de verkliga priserna (hämtade från modellkatalogen, enligt X402 växelkurs), enhet USD / 1M token: Anmärkningar:
  • Tabellen visar enhetspriserna baserat på tokens; kostnaden för en begäran = inmatning tokens × inmatningsenhetspris + utmatning tokens × utmatningsenhetspris.
  • upto övre gräns är det maximala belopp som modellen tillåter att signera för en begäran; det är inte den faktiska debiteringen, de flesta begärningar ligger långt under gränsen.
  • Gränsen avgör endast “maximalt möjligt belopp som kan debiteras”, den verkliga avräkningen baseras på token-användning.

Exempel: Offert och debitering överensstämmer (exact)

Nedan visas en verklig betalningsbegäran som görs med den officiella X402Client mot serp/google (Base exact). Den visar att de tre är överensstämmande: 402-offert, signerat belopp, samt det framgångsrika svaret som returnerar cost.
响应返回的 cost.amount(0.000952 USDC) med 402 offert, med Credits × 0.095215 är helt överensstämmande. settlement fältet är betalningens avräkningsstatus (authorized = auktoriserad); avräkningen på kedjan hanteras av plattformen, mekanismen ses i exact och upto prissättningsplaner.

upto offertberäkning (chatt)

Chatt mäts i token. Offerten för en viss begäran (inte taket) beräknas enligt följande formel (som exempel med gpt-4o-mini):
En begäran med 500 prompt + 200 completion token:
Klienten signerar enligt upto taket (gpt-4o-mini är 1 Credit = 95215 atomic), detta är bara maximalt möjligt att debiteras; den verkliga offerten för denna begäran (som i exemplet ca $0.0001) är långt under taket, avräknas enligt tokenanvändning. upto kedjeavräkningsmekanismen ses i exact och upto prissättningsplaner.

Andra tjänsters priser (fast pris exact)

Gränssnitt som bilder, video, musik, sökning har priser som kan fastställas vid begäran, använder exact. Tabellen nedan visar verkliga priser, hämtade från onlinegränssnittets 402 maxAmountRequired för obetalda begärningar (prissättning av offert medför ingen debitering): Förklaring:
  • Priserna för samma tjänst varierar med modell, upplösning, längd, åtgärd (särskilt för video). Tabellen ovan visar verkliga värden för en viss uppsättning parametrar, endast för storleksreferens.
  • För dessa fasta priser (exact) är maxAmountRequired i 402 svaret det belopp som ska betalas (överensstämmer med det framgångsrika svaret cost.amount, vilket har testats i föregående avsnitt).
  • Varje pris beräknas genom att Credits × 0.095215 avrundas nedåt till atomic enhet (se ovanstående prissättningsreferens), samma omvandling används som för chatt. På grund av flyttal och avrundning kan vissa värden avvika med 1 atomic ($0.000001) från det enkla produkten, alltid baserat på 402 returvärdet.

Beställningsbetalningspriser

Vid betalning av beställningar i X402 betalningskonsolen (köp paket / ladda Credits) gäller priserna som visas på beställningssidan, 402:s amount är den slutliga signeringsgrunden. Beställningsbetalningar går via plattformens API, kräver kontotoken, se beställningsbetalningshandledning. Ett verkligt exempel från beställningsbetalningshandledningen (köp 10 Credits):
Observera: Betala per anrop (ovanstående Chatt / andra tjänster) och beställningsbetalning är två olika vägar. Betala per anrop använder enhetligt 0.095215/Credit som det optimala enhetspriset; beställningsbetalning enligt paketprissättning, skillnaden mellan skapelsepriset och det slutliga avräkningsbeloppet baseras på beställningsbetalningshandledning.

Hur man får priser i realtid

Priserna varierar med modell och parametrar, vänligen använd program för att hämta i realtid, hårdkoda inte:
  • Per anropspris: Gör en begäran till mål-API utan PAYMENT-SIGNATURE (och utan Authorization), läs 402:s accepts[].maxAmountRequired. Detta steg medför ingen debitering. För exact gränssnittet är det det slutliga priset; för upto gränssnittet (chatt) är det taket, avräknas enligt användning.
  • Chatt varje token enhetspris: GET https://platform.acedata.cloud/api/v1/models?with_pricing=true&type=chat, läs varje modells pricing.input_usd / pricing.output_usd (redan beräknat enligt credit_usd_rate).
  • Omvandlingskontroll: atomic = floor(Credits × 0.095215 × 1e6), USDC = atomic / 1e6 (dvs USDC ≈ Credits × 0.095215).
Exempel på minimi begäran för att hämta priser:

Sammanfattning

  • X402 pris = kostnaden för Credits för detta samtal × 0.095215, och det är samma pris som för vanliga Credits, bara att det avräknas i kedjans USDC.
  • 0.095215/Credit är plattformens bästa nivå (stora) Credits enhetspris; mindre insättningar köper Credits till ett högre pris, så X402 får automatiskt det bästa enhetspriset.
  • exact-gränssnittet (bilder / videor / musik / sökningar / beställningar) signerar beloppet som är det belopp som ska betalas; upto-gränssnittet (chatt) signerar taket, som avräknas baserat på verklig användning.
  • Det auktoritativa priset baseras på maxAmountRequired som returneras av 402: exact är det belopp som ska betalas (överensstämmer med det framgångsrika svaret cost.amount, har testats); upto är taket, det framgångsrika svaret cost.amount är det verkliga beloppet som avräknas baserat på användning (≤ taket).

Relaterad dokumentation