acedatacloud è responsabile delle chiamate API, mentre acedatacloud-x402 è responsabile della firma dell’header della richiesta PAYMENT-SIGNATURE.
Codice sorgente e indirizzi dei pacchetti:
- Repository SDK: https://github.com/AceDataCloud/SDK
- Repository X402 Client: https://github.com/AceDataCloud/X402Client
- PyPI SDK: https://pypi.org/project/acedatacloud/
- PyPI X402 Client: https://pypi.org/project/acedatacloud-x402/
Installare le dipendenze
upto, è inoltre necessario chiamare una volta la CLI di approve Permit2, che dipende da web3:
- Sia
acedatacloudsiaacedatacloud-x402possono essere installati e importati da PyPI. pip install 'acedatacloud-x402[cli]'include la CLIapprove-permit2, usata per l’autorizzazione preliminare diupto.
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.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: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 conAsyncAceDataCloud:
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:
upto:
content ADC_BASE_UPTO_OKindica che la richiesta è effettivamente entrata nell’API del modello.settled value 3 atomic USDCindica cheuptoviene regolato in base all’utilizzo effettivo, anziché addebitare l’intero limite massimo.settlement txpuò 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:
{"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:create_x402_payment_handler.
