> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # X402 Prissättning > Platform API guide - Ace Data Cloud 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: ```text theme={null} X402 pris (USDC) = den här anropets Credits kostnad × 0.095215 ``` 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 | Post | Värde | Beskrivning | | - | - | - | | Växelkurs | `1 Credit = 0.095215 USDC` | Fast växelkurs fastställd av plattformen | | atomisk enhet | `1 Credit = 95215 atomiska USDC` | USDC 6 decimaler, `atomisk = golv(credits × 0.095215 × 1e6)` | | Minsta avgift | `1 atomisk USDC`（\$0.000001） | Även om kostnaden är extremt låg, avräknas minst 1 atomisk | | Valuta | USDC | Base / SKALE är ERC-20 USDC, Solana är SPL USDC | 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: | Köpa/betala metod | Ungefärligt Credits enhetspris | Beskrivning | | - | - | - | | Inledande / Liten insättning | Cirka `$0.13 / Credit` | Listpris, enhetspriset vid köp av Credits i små mängder | | Stora / Optimala nivå | `$0.095215 / Credit` | Det billigaste enhetspriset | | **X402 betalar per anrop** | **`$0.095215 / Credit`** | **Är alltid lika med det optimala enhetspriset** | 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](https://platform.acedata.cloud/documents/x402-metered-upto). 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: | Modell | Inmatning / 1M | Utmatning / 1M | `upto` övre gräns | | - | - | - | - | | gpt-4o-mini | \$0.0796 | \$0.3183 | 1 Credit（\$0.095215） | | gemini-2.5-flash | \$0.1591 | \$1.3262 | 5 Credits（\$0.476074） | | gpt-5 / gpt-5.1 | \$0.6631 | \$5.3050 | 20 Credits（\$1.904299） | | gemini-2.5-pro | \$0.6631 | \$5.3050 | 50 Credits（\$4.760750） | | gpt-4.1 | \$1.0610 | \$4.2440 | 20 Credits（\$1.904299） | | claude-sonnet-4-5 | \$0.6006 | \$3.0028 | 50 Credits（\$4.760750） | | grok-4 | \$1.5915 | \$7.9574 | 10 Credits（\$0.952149） | | claude-opus-4-1 | \$3.0028 | \$15.0140 | 50 Credits（\$4.760750） | 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`. ```text theme={null} # 1) Obetald begäran -> 402, får offert (ingen debitering) POST /serp/google -> 402 base/exact maxAmountRequired = 952 atomiska = $0.000952 = 0.01 Credit # 0.01 × 0.095215 = 0.00095215, avrundas ner till atomisk = 952 # 2) Signera 952 atomiska med plånboken som PAYMENT-SIGNATURE, försök igen POST /serp/google (PAYMENT-SIGNATURE) -> 200 body.cost = {"amount": 0.000952, "currency": "usdc", "settlement": "authorized"} ``` 响应返回的 `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](https://platform.acedata.cloud/documents/x402-metered-upto). ### `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): ```text theme={null} Credits = 1e-6 × (0.835733 × prompt_tokens + 3.342933 × completion_tokens) USDC = Credits × 0.095215 ``` En begäran med 500 prompt + 200 completion token: ```text theme={null} Credits = 1e-6 × (0.835733 × 500 + 3.342933 × 200) ≈ 0.001086 Credits Offert USDC ≈ 0.001086 × 0.095215 ≈ $0.0001034 ``` 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](https://platform.acedata.cloud/documents/x402-metered-upto). ## 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): | Tjänst | Exempelmodell / parametrar | Credits | USDC | atomic | | - | - | - | - | - | | Webb-sökning | serp/google, ≤10 resultat | 0.01 | \$0.000952 | 952 | | Bild | nano-banana | 0.14 | \$0.013330 | 13330 | | Bild | gpt-image-1, 1024×1024 | 0.20 | \$0.019043 | 19043 | | Bild | flux-dev | 0.24 | \$0.022851 | 22851 | | Bild | midjourney imagine | 0.27 | \$0.025708 | 25708 | | Bild | seedream-4 | 0.32 | \$0.030468 | 30468 | | Musik | suno generate | 0.55 | \$0.052368 | 52368 | | Musik | producer generate | 0.68 | \$0.064746 | 64746 | | Video | luma | 1.19 | \$0.113305 | 113305 | | Video | hailuo（minimax-hailuo-2-3） | 1.72 | \$0.163769 | 163769 | | Video | kling-v2-6 std | 2.10 | \$0.199951 | 199951 | | Video | kling-v3 std | 4.20 | \$0.399903 | 399903 | | Video | veo-3 text→video | 5.00 | \$0.476074 | 476074 | | Video | seedance-1-0-pro, 1080p / 5s | 5.60 | \$0.533204 | 533204 | | Video | wan2.6-t2v | 13.50 | \$1.285402 | 1285402 | 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](https://platform.acedata.cloud/documents/x402-order-payment). Ett verkligt exempel från beställningsbetalningshandledningen (köp 10 Credits): ```text theme={null} description Ace Data Cloud Credits x 10.0 created price 1.26 # Beställningens skapelsepris (USD) settled 1.20 USDC # Slutlig signering/avräkningsbelopp (= 402 amount) = 1200000 atomic USDC ``` 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](https://platform.acedata.cloud/documents/x402-order-payment). ## 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: ```bash theme={null} curl -sS -X POST https://x402.acedata.cloud/midjourney/imagine \ -H 'Content-Type: application/json' \ -d '{"prompt": "a cat"}' # Returnerar 402, accepts[].maxAmountRequired är priset för denna (exact) begäran ``` ## 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 | Dokument | Länk | | - | - | | X402 integrationsguide (översikt) | [X402 integrationsguide](https://platform.acedata.cloud/documents/x402-integration) | | Snabbstart | [X402 snabbstart](https://platform.acedata.cloud/documents/x402-quickstart) | | `exact` och `upto` avgiftsplaner | [Avgiftsplanbeskrivning](https://platform.acedata.cloud/documents/x402-metered-upto) | | Nätverk och betalningsmetoder | [Nätverk och betalningsmetoder](https://platform.acedata.cloud/documents/x402-networks) | | Beställningsbetalningshandledning | [Beställningsbetalningshandledning](https://platform.acedata.cloud/documents/x402-order-payment) | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.