acedatacloud é responsável pelas chamadas de API, e acedatacloud-x402 é responsável por assinar o cabeçalho de requisição PAYMENT-SIGNATURE.
Código-fonte e endereços dos pacotes:
- Repositório do SDK: https://github.com/AceDataCloud/SDK
- Repositório do Cliente X402: https://github.com/AceDataCloud/X402Client
- SDK PyPI: https://pypi.org/project/acedatacloud/
- Cliente X402 PyPI: https://pypi.org/project/acedatacloud-x402/
Instalar dependências
upto, também será necessário chamar uma vez a CLI de aprovação Permit2, e essa CLI depende de web3:
- Tanto
acedatacloudquantoacedatacloud-x402podem ser instalados e importados a partir do PyPI. pip install 'acedatacloud-x402[cli]'inclui a CLIapprove-permit2, usada para a autorização prévia deupto.
Exemplo Base
O exemplo abaixo não requer API Token. A chave privada da carteira é usada apenas para assinatura local e não será enviada ao Ace Data Cloud.dict, portanto o exemplo usa res["choices"][0]["message"]["content"]. Não assuma diretamente que ele necessariamente possui o atributo .choices.
Exemplo Solana
Solana usa uma secret key codificada em base58:TransferChecked e, então, colocará a assinatura da transação no envelope PAYMENT-SIGNATURE.
A nova tentativa paga do Solana já retornou HTTP 200 e ADC_SOLANA_E2E_OK na API de produção. A consulta RPC pública desta vez encontrou limitação de taxa, e não confirmou de forma estável a signature on-chain; quando for necessário reconciliar, use seu próprio RPC Solana para consultar essa transação.
Cliente Async
O mesmo payment handler pode ser usado comAsyncAceDataCloud:
Usar medição posterior com upto
O custo real de APIs como complementação de chat e chamadas de modelo pode só ser conhecido após o término da resposta. Nesse caso, a API pode retornar simultaneamente exact e upto. Se quiser priorizar upto:
upto na Base:
content ADC_BASE_UPTO_OKindica que a requisição realmente entrou na API do modelo.settled value 3 atomic USDCindica queuptoé liquidado de acordo com o uso real, em vez de descontar o limite máximo completo.settlement txpode ser aberto no BaseScan; ao reconciliar, salve o tx hash, payer, completion id e o resumo da requisição.
upto usa Permit2 para autorizar um limite máximo, e o valor real da liquidação não pode exceder esse limite. Antes do primeiro uso, é necessário fazer uma vez approve(Permit2, amount) para o USDC na cadeia de destino.
Método CLI:
{"skipped": true} e não enviará novamente uma transação on-chain.
Assinatura de baixo nível
Se não usar o SDK, você também pode chamar diretamente a função de assinatura de baixo nível:create_x402_payment_handler.
