X402 Prezzo Spiegazione

​

Conclusione Chiave

1 Credit = 0.095215 USDC (cioè 95215 atomic USDC, USDC con 6 decimali)

Prezzo X402 (USDC) = Costo in Credits di questa chiamata × 0.095215

​

Base di Valutazione

​

Relazione con il Prezzo Unitario dei Credits Normali

​

Due Forme di Prezzo: exact e upto

• 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.

​

Prezzo Chat (Completamento della Chat)

• 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)

# 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"}

​

Calcolo della quotazione upto (chat)

Credits = 1e-6 × (0.835733 × prompt_tokens + 3.342933 × completion_tokens)
USDC    = Credits × 0.095215

Credits = 1e-6 × (0.835733 × 500 + 3.342933 × 200) ≈ 0.001086 Credits
Quotazione USDC ≈ 0.001086 × 0.095215 ≈ $0.0001034

​

Prezzi di altri servizi (prezzo fisso exact)

• 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

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

​

Come ottenere i prezzi in tempo reale

• 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).

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