Saltar al contenido principal
El SDK de Python es adecuado para servicios de backend, tareas de datos, Agent de automatización y scripts de procesamiento por lotes. 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:

Instalar dependencias

Si se desea utilizar upto, también es necesario llamar una vez al CLI de approve de Permit2, y este CLI depende de web3:
Salida de la comprobación de instalación e importación en un Python venv limpio:
Explicación de los resultados:
  • Tanto acedatacloud como acedatacloud-x402 se pueden instalar e importar desde PyPI.
  • pip install 'acedatacloud-x402[cli]' incluirá el CLI approve-permit2, utilizado para la autorización previa de upto.

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.
Actualmente, el SDK de Python devuelve un 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:
La ruta de Solana construirá y enviará una transacción SPL USDC 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 para AsyncAceDataCloud:

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:
Resultado de ejecución del programa upto de Base:
Confirmación en cadena:
Explicación de los resultados:
  • content ADC_BASE_UPTO_OK indica que la solicitud realmente entró en la API del modelo.
  • settled value 3 atomic USDC indica que upto se liquida según el uso real, en lugar de cobrar el límite máximo completo.
  • settlement tx puede 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:
Método programático:
Este helper es idempotente. Si el allowance ya es suficiente, devolverá {"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:
Las funciones de bajo nivel son adecuadas para pruebas, capas de proxy, integración de gateways o SDK no oficiales. El código de negocio común debe priorizar el uso de create_x402_payment_handler.