libertai-x402

x402 utilities that handle payments automatically for LibertAI services

Install

pip install libertai-x402

Usage with OpenAI SDK

import asyncio
from openai import AsyncOpenAI
from libertai_x402 import create_payment_client

async def main():
    http_client = create_payment_client("0x...")

    client = AsyncOpenAI(
        base_url="https://api.libertai.io/v1",
        api_key="x402",
        http_client=http_client,
    )

    response = await client.chat.completions.create(
        model="qwen3.5-27b",
        messages=[{"role": "user", "content": "Hello!"}],
    )

    print(response.choices[0].message.content)

asyncio.run(main())

Set api_key to "x402" — the wrapper strips this dummy value before sending requests. Real API keys (any other value) are preserved.

Usage with httpx

import asyncio
from libertai_x402 import create_payment_client

async def main():
    async with create_payment_client("0x...") as client:
        resp = await client.post(
            "https://api.libertai.io/v1/chat/completions",
            json={
                "model": "qwen3.5-27b",
                "messages": [{"role": "user", "content": "Hello!"}],
            },
        )
        print(resp.json())

asyncio.run(main())

How it works

1. Makes the request normally
2. If the server responds with 402, reads PaymentRequirements from the response body
3. Signs an EIP-712 typed data message (Permit or TransferWithAuthorization on Base) using the provided private key
4. Retries the request with the signed payment in the X-PAYMENT header

License

MIT