Pay for AI Image Generation with Web3

Seamlessly integrate cryptocurrency payments into your AI workflows using Coinbase's x402 protocol

## What is x402? X402 is a revolutionary payment protocol developed by Coinbase that enables **programmatic payments over HTTP** using Web3 technologies. It allows applications to request payments for resources in a simple, stateless manner using standard HTTP status codes and headers. Our integration brings x402 payments to AI image generation, making it possible to pay for premium AI services using cryptocurrency directly through HTTP requests.

Uses standard HTTP 402 status codes and headers for seamless payment integration into existing web infrastructure. Perfect for autonomous AI systems that need to make payments programmatically without human intervention. No sessions or complex authentication required. Each payment is self-contained and verifiable. Simple integration with standard HTTP libraries and familiar request-response patterns.

## How X402 Works with Our AI Mystic Endpoint Our **Mystic** model now supports x402 payments, enabling you to pay for AI image generation using cryptocurrency. Here's how the payment flow works: ### Payment Flow ```mermaid theme={null} sequenceDiagram participant Client participant API participant Facilitator participant Blockchain Client->>API: POST /v1/x402/ai/mystic (initial request) API-->>Client: HTTP 402 Payment Required + requirements Client->>API: POST with X-PAYMENT header API->>Facilitator: Verify payment Facilitator->>Blockchain: Check on-chain Blockchain-->>Facilitator: Payment confirmed Facilitator-->>API: Valid payment receipt API-->>Client: HTTP 200 + content + X-PAYMENT-RESPONSE ``` Send a standard HTTP POST request to `/v1/x402/ai/mystic` with your prompt and model parameters. Server responds with `HTTP 402 Payment Required` status and payment details including amount, recipient, and network. Your configured wallet automatically creates and signs a payment payload based on the requirements. The SDK automatically resubmits your request with the `X-PAYMENT` header containing the signed payment. Server verifies the payment with the facilitator and processes it on-chain for transparent settlement. Get your AI-generated image along with settlement details in the `X-PAYMENT-RESPONSE` header. ## Integration Benefits No waiting for traditional payment processing. Cryptocurrency payments are verified and settled quickly on-chain. Accept payments from anywhere in the world without traditional banking restrictions or currency conversions. Reduced transaction costs compared to traditional payment processors, especially for micro-payments. All payments are verifiable on-chain, providing complete transparency and audit trails. ## Getting Started Create or connect a Web3 wallet and fund it with USDC on the supported network. Ensure you have enough balance for both payments and gas fees. New to Web3 wallets? Check out the Coinbase guide for creating a wallet. Add the x402 client library for your programming language. The SDK handles all payment complexity automatically. ```bash npm theme={null} npm install x402-fetch x402-axios viem ``` ```bash pip theme={null} pip install x402 eth-account ``` Initialize your wallet and wrap your HTTP client with the x402 adapter: ```javascript theme={null} const account = privateKeyToAccount("0xYourPrivateKey"); const fetchWithPayment = wrapFetchWithPayment(fetch, account); ``` Send a request to `/v1/x402/ai/mystic` - the SDK handles payment automatically: ```javascript theme={null} const response = await fetchWithPayment( "https://api.freepik.com/v1/x402/ai/mystic", { method: "POST", body: JSON.stringify({...}) } ); ``` ## Implementation Examples Using the x402 SDKs, payment handling is completely automatic. Just set up your wallet and make requests: ```javascript fetch theme={null} // Using x402-fetch (Node.js) import { wrapFetchWithPayment, decodeXPaymentResponse } from "x402-fetch"; import { privateKeyToAccount } from "viem/accounts"; // Set up your wallet const account = privateKeyToAccount("0xYourPrivateKey"); // Use env variable // Create fetch with automatic payment handling const fetchWithPayment = wrapFetchWithPayment(fetch, account); // Make request to AI endpoint - payment is automatic! const response = await fetchWithPayment("https://api.freepik.com/v1/x402/ai/mystic", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ prompt: "A futuristic city at sunset", model: "realism" }) }); // Get your generated image const result = await response.json(); console.log("Generated image:", result); // Optional: Get payment details const paymentInfo = decodeXPaymentResponse( response.headers.get("x-payment-response") ); console.log("Payment settled:", paymentInfo); ``` ```javascript axios theme={null} // Using x402-axios (Node.js) import axios from "axios"; import { withPaymentInterceptor } from "x402-axios"; import { privateKeyToAccount } from "viem/accounts"; // Set up your wallet const account = privateKeyToAccount("0xYourPrivateKey"); // Use env variable // Create axios instance with automatic payment handling const api = withPaymentInterceptor( axios.create({ baseURL: "https://api.freepik.com" }), account ); // Make request - payment is automatic! const response = await api.post("/v1/x402/ai/mystic", { prompt: "A futuristic city at sunset", model: "realism" }); console.log("Generated image:", response.data); ``` ```python requests theme={null} # Using x402 with requests (Python) import requests from eth_account import Account from x402.clients.requests import x402_http_adapter # Set up your wallet account = Account.from_key("your_private_key") # Use env variable # Create session with automatic payment handling session = requests.Session() adapter = x402_http_adapter(account) session.mount("https://", adapter) # Make request - payment is automatic! response = session.post( "https://api.freepik.com/v1/x402/ai/mystic", json={ "prompt": "A futuristic city at sunset", "model": "realism" } ) print("Generated image:", response.json()) # Optional: Get payment details from header payment_info = response.headers.get("X-PAYMENT-RESPONSE") print("Payment settled:", payment_info) ``` ```python httpx theme={null} # Using x402 with HTTPX (async Python) import httpx from eth_account import Account from x402.clients.httpx import x402_payment_hooks # Set up your wallet account = Account.from_key("your_private_key") # Use env variable # Create async client with automatic payment handling async with httpx.AsyncClient() as client: # Add x402 payment hooks client.event_hooks = x402_payment_hooks(account) # Make request - payment is automatic! response = await client.post( "https://api.freepik.com/v1/x402/ai/mystic", json={ "prompt": "A futuristic city at sunset", "model": "realism" } ) result = await response.json() print("Generated image:", result) ``` ### Installation ```bash npm theme={null} # For Node.js/JavaScript npm install x402-fetch x402-axios viem # or yarn add x402-fetch x402-axios viem ``` ```bash pip theme={null} # For Python pip install x402 eth-account httpx ``` ### Learn More For complete setup guides including wallet configuration and advanced options, check out the official documentation:

📦 Node.js Guide 🐍 Python Guide

## Key Advantages **For Developers:** * Simple HTTP-based payment integration * No complex payment gateway setups * Standard REST API patterns * Built-in payment verification **For Users:** * Direct cryptocurrency payments * No account creation required * Global accessibility * Transparent, on-chain settlements **For Businesses:** * Reduced payment processing costs * Instant settlement capabilities * Global market reach * Programmable payment logic ## Support and Resources

Seller Quickstart

Buyer Quickstart

Network Support

Ready to integrate Web3 payments into your AI workflows? Start by making your first request to `/v1/x402/ai/mystic` and experience the future of programmable payments!

Start Building Today

Integrate Freepik into your AI workflows

Pay for AI Image Generation with Web3