Genbase - AI Video Generator with x402

This guide will help you understand Genbase, an AI video generation platform powered by x402 open payment standard for programmatic payments.

This application showcases x402, the open payment standard that enables services to charge for access to their APIs directly over HTTP. It uses the HTTP 402 Payment Required status code to allow clients to programmatically pay for video generation without accounts, sessions, or credential management.

Why Use x402?

This application demonstrates how x402 addresses key limitations of existing payment systems:

Who is this for?

What Can You Build?

This application showcases one use case, but x402 enables many more:

• ✅ API services paid per request (demonstrated here with video generation)
• ✅ AI agents that autonomously pay for API access
• ✅ Paywalls for digital content
• ✅ Microservices monetized via microtransactions
• ✅ Proxy services that aggregate and resell API capabilities

How Does It Work?

High-Level Flow

Creating a Video (Paid - $0.2 USDC)

// Frontend makes request
const response = await payingFetch("/api/video/create", {
  method: "POST",
  body: JSON.stringify({ prompt, model, aspect_ratio })
});

// Server middleware intercepts
// Returns: 402 Payment Required + payment info

// payingFetch automatically:
// - Signs payment with wallet
// - Retries with Authorization header
// - Returns final response

How to Use Genbase

All your generated videos are automatically saved to your browser's local storage, so you can easily re-query them later from the History panel.

API Reference

POST /api/video/create

Create a new AI video (requires payment: $0.2 USDC)

Request Body:

{
  "prompt": "A golden retriever playing in a park",
  "model": "veo3-fast-frames",
  "aspect_ratio": "16:9",
  "enable_upsample": true,
  "enhance_prompt": true
}

Response (200 OK):

{
  "success": true,
  "data": {
    "id": "veo3-fast-frames:1234567890-AbCdEfGh",
    "status": "pending",
    "detail": {
      "req": {
        "prompt": "A golden retriever playing in a park",
        "model": "veo3-fast-frames",
        "aspect_ratio": "16:9"
      }
    }
  }
}

GET /api/video/query

Query video generation status (FREE - no payment required)

Request Parameters:

?id=veo3-fast-frames:1234567890-AbCdEfGh

Status Values:

• • pending - Waiting to process (Progress: 20%)
• • processing - Generating video (Progress: 50%)
• • video_upsampling - Enhancing quality (Progress: 80%)
• • completed - Ready to watch (Progress: 100%)
• • failed - Generation failed

Features

FAQ