acedatacloud se encarga de las llamadas a la API, y acedatacloud-x402 se encarga de firmar el encabezado de solicitud PAYMENT-SIGNATURE.
Código fuente y direcciones de los paquetes:
- Repositorio del SDK: https://github.com/AceDataCloud/SDK
- Repositorio de X402 Client: https://github.com/AceDataCloud/X402Client
- SDK en PyPI: https://pypi.org/project/acedatacloud/
- X402 Client en PyPI: https://pypi.org/project/acedatacloud-x402/
Instalar dependencias
upto, también es necesario llamar una vez al CLI de approve de Permit2, y este CLI depende de web3:
- Tanto
acedatacloudcomoacedatacloud-x402se pueden instalar e importar desde PyPI. pip install 'acedatacloud-x402[cli]'incluirá el CLIapprove-permit2, utilizado para la autorización previa deupto.
Ejemplo de Base
El siguiente ejemplo no requiere un API Token. La clave privada de la billetera solo firma localmente y no se enviará a Ace Data Cloud.dict, por lo que el ejemplo utiliza res["choices"][0]["message"]["content"]. No asuma directamente que necesariamente tiene una propiedad .choices.
Ejemplo de Solana
Solana utiliza una secret key codificada en base58:TransferChecked, y luego colocará la firma de la transacción en el envelope PAYMENT-SIGNATURE.
El paid retry de Solana ya devolvió HTTP 200 y ADC_SOLANA_E2E_OK en la API de producción. Esta consulta pública de RPC encontró limitación de tasa y no confirmó de forma estable la signature en cadena; si se necesita conciliar, utilice su propio RPC de Solana para consultar esta transacción.
Cliente Async
El mismo payment handler puede utilizarse paraAsyncAceDataCloud:
Usar la medición posterior upto
El costo real de API como las completions de chat y las llamadas a modelos puede conocerse solo después de que termine la respuesta. En este momento, la API puede devolver simultáneamente exact y upto. Si desea priorizar el uso de upto:
upto de Base:
content ADC_BASE_UPTO_OKindica que la solicitud realmente entró en la API del modelo.settled value 3 atomic USDCindica queuptose liquida según el uso real, en lugar de cobrar el límite máximo completo.settlement txpuede abrirse en BaseScan; al conciliar, guarde el tx hash, payer, completion id y el resumen de la solicitud.
upto utiliza Permit2 para autorizar un límite máximo, y el importe de liquidación real no puede superar dicho límite. Antes del primer uso, es necesario realizar una vez approve(Permit2, amount) para USDC en la cadena de destino.
Método CLI:
{"skipped": true} y no enviará repetidamente transacciones en cadena.
Firma de bajo nivel
Si no utiliza el SDK, también puede llamar directamente a la función de firma de bajo nivel:create_x402_payment_handler.
