Vai al contenuto principale
L’SDK Python è adatto per servizi backend, attività di dati, Agent automatizzati e script batch. acedatacloud è responsabile delle chiamate API, mentre acedatacloud-x402 è responsabile della firma dell’header della richiesta PAYMENT-SIGNATURE. Codice sorgente e indirizzi dei pacchetti:

Installare le dipendenze

Se si desidera utilizzare upto, è inoltre necessario chiamare una volta la CLI di approve Permit2, che dipende da web3:
Output dell’installazione e del controllo di importazione in un Python venv pulito:
Spiegazione dei risultati:
  • Sia acedatacloud sia acedatacloud-x402 possono essere installati e importati da PyPI.
  • pip install 'acedatacloud-x402[cli]' include la CLI approve-permit2, usata per l’autorizzazione preliminare di upto.

Esempio Base

L’esempio seguente non richiede un API Token. La chiave privata del wallet firma solo localmente e non verrà inviata ad Ace Data Cloud.
L’SDK Python attualmente restituisce un dict, quindi l’esempio usa res["choices"][0]["message"]["content"]. Non supporre direttamente che abbia necessariamente un attributo .choices.

Esempio Solana

Solana utilizza una secret key codificata in base58:
Il percorso Solana costruisce e invia una transazione SPL USDC TransferChecked, quindi inserisce la firma della transazione nell’envelope PAYMENT-SIGNATURE. Il paid retry Solana ha già restituito HTTP 200 e ADC_SOLANA_E2E_OK sull’API di produzione. In questa query RPC pubblica si è verificata una limitazione della frequenza, quindi la signature on-chain non è stata confermata in modo stabile; se è necessaria una riconciliazione, utilizzare il proprio RPC Solana per interrogare questa transazione.

Client Async

Lo stesso payment handler può essere utilizzato con AsyncAceDataCloud:

Utilizzare la misurazione posticipata upto

Il costo reale di API come chat completion e chiamate al modello potrebbe essere noto solo dopo il termine della risposta. In questo caso, l’API potrebbe restituire contemporaneamente exact e upto. Se si desidera dare priorità a upto:
Risultato dell’esecuzione del programma Base upto:
Conferma on-chain:
Spiegazione dei risultati:
  • content ADC_BASE_UPTO_OK indica che la richiesta è effettivamente entrata nell’API del modello.
  • settled value 3 atomic USDC indica che upto viene regolato in base all’utilizzo effettivo, anziché addebitare l’intero limite massimo.
  • settlement tx può essere aperta su BaseScan; durante la riconciliazione, salvare l’hash tx, il payer, il completion id e il riepilogo della richiesta.
upto utilizza un’autorizzazione Permit2 per un limite massimo e l’importo effettivo della regolazione non può superare tale limite. Prima del primo utilizzo, è necessario effettuare una volta approve(Permit2, amount) per USDC sulla chain di destinazione. Metodo CLI:
Metodo programmatico:
Questo helper è idempotente. Se l’allowance è già sufficiente, restituirà {"skipped": true} e non invierà ripetutamente transazioni on-chain.

Firma di basso livello

Se non si utilizza l’SDK, è anche possibile chiamare direttamente la funzione di firma di basso livello:
Le funzioni di basso livello sono adatte per test, livelli proxy, integrazioni gateway o SDK non ufficiali. Per il codice di business ordinario, utilizzare preferibilmente create_x402_payment_handler.