> ## 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 Prezzo Spiegazione > Platform API guide - Ace Data Cloud Questo documento spiega come viene determinato il prezzo quando si utilizza X402 per chiamare l'API di Ace Data Cloud, e quale relazione ha con il prezzo normale dei **Credits** della piattaforma. ## Conclusione Chiave X402 non è un sistema di prezzo indipendente. Ogni chiamata API ha già un costo espresso in **Credits**, che è l'unica fonte di prezzo condivisa da tutti i metodi di fatturazione (detrarre dal token API, saldo dell'account, pagamento on-chain con X402). X402 converte semplicemente questo costo in Credits in USDC on-chain a un tasso fisso: > **1 Credit = 0.095215 USDC** (cioè `95215` atomic USDC, USDC con 6 decimali) In altre parole: ```text theme={null} Prezzo X402 (USDC) = Costo in Credits di questa chiamata × 0.095215 ``` Questo tasso di cambio non è stabilito a caso, ma è uguale al **prezzo unitario dei Credits nella fascia ottimale (grandi quantità)** della piattaforma. Quindi pagare con X402 ≈ acquistare Credits al prezzo unitario ottimale e poi consumarli, **senza sovrapprezzo X402**, godendo invece del prezzo unitario dei Credits più economico, senza necessità di ricarica anticipata o di un token API. ## Base di Valutazione | Voce | Valore | Spiegazione | | - | - | - | | Tasso di cambio | `1 Credit = 0.095215 USDC` | Tasso fisso stabilito uniformemente dalla piattaforma | | Unità atomic | `1 Credit = 95215 atomic USDC` | USDC con 6 decimali, `atomic = floor(credits × 0.095215 × 1e6)` | | Minimo addebito | `1 atomic USDC`（\$0.000001） | Anche se il costo è molto basso, si addebita almeno 1 atomic | | Valuta di valutazione | USDC | Base / SKALE è ERC-20 USDC, Solana è SPL USDC | La conversione è effettuata uniformemente dalla piattaforma, l'importo è lo stesso per tutte le reti supportate (Base, SKALE, Solana); le diverse reti hanno solo contratti di asset e modalità di firma differenti, ma il prezzo è lo stesso. ### Relazione con il Prezzo Unitario dei Credits Normali I Credits della piattaforma sono venduti in base a "maggiore è l'uso, minore è il prezzo" in fasce. X402 utilizza sempre il prezzo unitario ottimale della fascia quando fattura per chiamata: | Metodo di acquisto/pagamento | Prezzo unitario dei Credits | Spiegazione | | - | - | - | | Inizio / Piccole ricariche | Circa `$0.13 / Credit` | Prezzo di listino, prezzo unitario per l'acquisto di Credits in piccole quantità | | Grandi quantità / Fascia ottimale | `$0.095215 / Credit` | Prezzo unitario più economico | | **X402 Pagamento per Chiamata** | **`$0.095215 / Credit`** | **Sempre uguale al prezzo unitario ottimale** | In altre parole, X402 addebita ogni chiamata al prezzo unitario dei Credits della fascia ottimale. Gli utenti che acquistano Credits con piccole ricariche pagheranno un prezzo unitario superiore a quello di X402; solo gli utenti con ricariche elevate avranno un prezzo unitario uguale a quello di X402. ## Due Forme di Prezzo: `exact` e `upto` Nella risposta 402 di X402, `maxAmountRequired` è l'importo che devi firmare. Ha due forme: * **`exact` (prezzo fisso)**: il prezzo può essere determinato prima dell'elaborazione della richiesta (immagini, video, musica, ricerca, pagamento ordini). `maxAmountRequired = Costo in Credits di questa chiamata × 0.095215`, cioè l'importo da pagare per questa chiamata (corrisponde a `cost.amount` nella risposta di successo). * **`upto` (misurazione post-utilizzo)**: interfacce come il completamento della chat in cui "si sa quanto token sono stati utilizzati solo alla fine della risposta". `maxAmountRequired` è un **limite** (convertito in base al limite stabilito da questo modello: limiti Credits × 0.095215), il pagamento effettivo è calcolato in base all'uso reale, senza superare il limite. Per i dettagli del protocollo su queste due modalità, vedere [`exact` e `upto` piani di fatturazione](https://platform.acedata.cloud/documents/x402-metered-upto). Qui si parla solo di prezzi. ## Prezzo Chat (Completamento della Chat) Il completamento della chat è misurato in `upto`: il costo è calcolato in base all'uso effettivo di token prompt/completamento. Il prezzo per milione (1M) di token = `Costo in Credits per 1M token di questo modello × 0.095215`, completamente coerente con il prezzo in USD mostrato nel catalogo pubblico dei modelli della piattaforma (`/api/v1/models?with_pricing=true`). La tabella seguente mostra i prezzi reali (presi dal catalogo dei modelli, calcolati secondo il tasso di cambio X402), unità USD / 1M token: | Modello | Input / 1M | Output / 1M | Limite `upto` | | - | - | - | - | | 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） | Spiegazione: * La tabella mostra il prezzo unitario calcolato per token; il costo di una richiesta = input token × prezzo unitario input + output token × prezzo unitario output. * Il limite `upto` è l'importo massimo che il modello consente di firmare per una richiesta; non è l'importo effettivamente addebitato, la maggior parte delle richieste è ben al di sotto del limite. * Il limite determina solo "quanto massimo potrebbe essere addebitato", il pagamento reale è calcolato in base all'uso dei token. ### Esempio: Prezzo e Addebito Coerenti (`exact`) Di seguito è riportata una **chiamata a pagamento reale** effettuata con il client ufficiale X402Client su `serp/google` (Base `exact`). Dimostra la coerenza tra i tre: prezzo 402, importo firmato e `cost` restituito nella risposta di successo. ```text theme={null} # 1) Richiesta non pagata -> 402, ottieni il prezzo (senza addebito) POST /serp/google -> 402 base/exact maxAmountRequired = 952 atomic = $0.000952 = 0.01 Credit # 0.01 × 0.095215 = 0.00095215, arrotondato a atomic = 952 # 2) Firma con il portafoglio 952 atomic di PAYMENT-SIGNATURE, riprova POST /serp/google (PAYMENT-SIGNATURE) -> 200 body.cost = {"amount": 0.000952, "currency": "usdc", "settlement": "authorized"} ``` 响应返回的 `cost.amount`（0.000952 USDC） con 402 quotazione, con `Credits × 0.095215` è completamente coerente. Il campo `settlement` è lo stato di regolamento di questo pagamento (`authorized` = autorizzato); il regolamento on-chain è gestito dalla piattaforma, meccanismo visibile nei piani di fatturazione [`exact` e `upto`](https://platform.acedata.cloud/documents/x402-metered-upto). ### Calcolo della quotazione `upto` (chat) La chat è misurata in token. La quotazione per una richiesta (non il limite) è calcolata secondo la seguente formula (prendendo come esempio gpt-4o-mini): ```text theme={null} Credits = 1e-6 × (0.835733 × prompt_tokens + 3.342933 × completion_tokens) USDC = Credits × 0.095215 ``` Una richiesta di 500 prompt + 200 completion token: ```text theme={null} Credits = 1e-6 × (0.835733 × 500 + 3.342933 × 200) ≈ 0.001086 Credits Quotazione USDC ≈ 0.001086 × 0.095215 ≈ $0.0001034 ``` Il client firma secondo il limite `upto` (gpt-4o-mini è 1 Credit = `95215` atomic), questo è solo **il massimo che potrebbe essere addebitato**; la vera quotazione di questa richiesta (circa \$0.0001 nell'esempio) è molto al di sotto del limite, regolata in base all'uso dei token. Il meccanismo di regolamento on-chain di `upto` è visibile nei piani di fatturazione [`exact` e `upto`](https://platform.acedata.cloud/documents/x402-metered-upto). ## Prezzi di altri servizi (prezzo fisso `exact`) Interfacce come immagini, video, musica e ricerca hanno un prezzo che può essere determinato al momento della richiesta, utilizzando `exact`. La tabella sottostante mostra i prezzi reali, presi dalla risposta 402 `maxAmountRequired` per richieste non pagate (la consultazione dei prezzi non comporta costi): | Servizio | Modello / Parametri esempio | Credits | USDC | atomic | | - | - | - | - | - | | Ricerca web | serp/google, ≤10 risultati | 0.01 | \$0.000952 | 952 | | Immagine | nano-banana | 0.14 | \$0.013330 | 13330 | | Immagine | gpt-image-1, 1024×1024 | 0.20 | \$0.019043 | 19043 | | Immagine | flux-dev | 0.24 | \$0.022851 | 22851 | | Immagine | midjourney imagine | 0.27 | \$0.025708 | 25708 | | Immagine | seedream-4 | 0.32 | \$0.030468 | 30468 | | Musica | suno generate | 0.55 | \$0.052368 | 52368 | | Musica | 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 | Nota: * I prezzi dello stesso servizio variano in base a **modello, risoluzione, durata, azione** (soprattutto per i video). La tabella sopra mostra i valori reali per un certo insieme di parametri, solo a scopo di riferimento. * Per queste interfacce a prezzo fisso (`exact`), il `maxAmountRequired` nella risposta 402 di questa richiesta è l'importo dovuto (coerente con il `cost.amount` della risposta di successo, già testato nel paragrafo precedente). * Ogni prezzo è ottenuto arrotondando per difetto a unità atomic da `Credits × 0.095215` (vedi il riferimento di calcolo sopra), utilizzando lo stesso sistema di conversione usato per la chat. A causa della rappresentazione in virgola mobile e dell'arrotondamento, alcuni valori potrebbero differire di 1 atomic (\$0.000001) dal prodotto semplice, e si deve sempre fare riferimento al valore restituito dalla risposta 402. ## Prezzo di pagamento dell'ordine Quando si paga un ordine tramite la console di pagamento X402 (acquisto di pacchetti / ricarica di Credits), il prezzo è quello visualizzato nella pagina dell'ordine, l'`amount` della risposta 402 è la base finale per la firma. Il pagamento dell'ordine utilizza l'API della piattaforma e richiede un token dell'account, vedi [guida al pagamento dell'ordine](https://platform.acedata.cloud/documents/x402-order-payment). Un esempio reale dalla guida al pagamento dell'ordine (acquisto di 10 Credits): ```text theme={null} description Ace Data Cloud Credits x 10.0 created price 1.26 # Prezzo di creazione dell'ordine (USD) settled 1.20 USDC # Importo finale per la firma/regolamento (= 402 amount) = 1200000 atomic USDC ``` Nota: **Pagamento per chiamata** (come sopra per Chat / altri servizi) e **pagamento dell'ordine** sono due percorsi diversi. Il pagamento per chiamata utilizza uniformemente il prezzo unitario ottimale di `0.095215`/Credit; il pagamento dell'ordine è basato sui prezzi dei pacchetti, la differenza tra il prezzo di creazione e l'importo finale di regolamento è conforme a quanto indicato nella [guida al pagamento dell'ordine](https://platform.acedata.cloud/documents/x402-order-payment). ## Come ottenere i prezzi in tempo reale I prezzi variano in base a modello e parametri, si prega di ottenere i prezzi in tempo reale tramite programma, non codificare a mano: * **Prezzo per chiamata**: inviare una richiesta all'API target **senza** `PAYMENT-SIGNATURE` (e nemmeno `Authorization`), leggere il `accepts[].maxAmountRequired` restituito nella risposta 402. Questo passaggio non comporta costi. Per l'interfaccia `exact` è il prezzo finale; per l'interfaccia `upto` (chat) è il limite, regolato in base all'uso. * **Prezzo per token della chat**: `GET https://platform.acedata.cloud/api/v1/models?with_pricing=true&type=chat`, leggere `pricing.input_usd` / `pricing.output_usd` di ogni modello (già calcolato secondo `credit_usd_rate`). * **Verifica della conversione**: `atomic = floor(Credits × 0.095215 × 1e6)`, `USDC = atomic / 1e6` (cioè `USDC ≈ Credits × 0.095215`). Esempio di richiesta minima per ottenere il prezzo: ```bash theme={null} curl -sS -X POST https://x402.acedata.cloud/midjourney/imagine \ -H 'Content-Type: application/json' \ -d '{"prompt": "a cat"}' # Restituisce 402, accepts[].maxAmountRequired è il prezzo di questa chiamata (exact) ``` ## Riepilogo * Prezzo X402 = Costo in Crediti di questa chiamata × `0.095215`, e il costo dei Crediti normali è **lo stesso prezzo**, solo che si regola in USDC sulla blockchain. * `0.095215`/Credito è il prezzo unitario dei Crediti **ottimali** (grandi quantità) della piattaforma; il prezzo unitario per l'acquisto di Crediti in piccole ricariche è più alto, quindi X402 equivale automaticamente a ottenere il prezzo ottimale. * L'importo firmato dall'interfaccia `exact` (immagini / video / musica / ricerca / ordini) è l'importo da pagare; l'interfaccia `upto` (chat) firma il limite, regolato in base all'uso reale. * Il prezzo autoritativo è basato su `maxAmountRequired` restituito da 402: `exact` è l'importo da pagare (corrisponde a `cost.amount` della risposta di successo, già testato); `upto` è il limite, l'importo `cost.amount` della risposta di successo è l'importo reale calcolato in base all'uso (≤ limite). ## Documenti correlati | Documento | Link | | - | - | | Guida all'integrazione X402 (Panoramica) | [Guida all'integrazione X402](https://platform.acedata.cloud/documents/x402-integration) | | Inizio rapido | [Inizio rapido X402](https://platform.acedata.cloud/documents/x402-quickstart) | | Piano tariffario `exact` e `upto` | [Descrizione del piano tariffario](https://platform.acedata.cloud/documents/x402-metered-upto) | | Reti e metodi di pagamento | [Reti e metodi di pagamento](https://platform.acedata.cloud/documents/x402-networks) | | Guida al pagamento degli ordini | [Guida al pagamento degli ordini](https://platform.acedata.cloud/documents/x402-order-payment) | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.