Genbase - AI Video & Image Generator with x402

This guide will help you understand Genbase, an AI video and image 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 with Sora 2 (Paid - $0.2 USDC)

// Frontend makes request
const response = await payingFetch("/api/video/create-sora2", {
  method: "POST",
  body: JSON.stringify({
    prompt: "A cat playing piano in a jazz club",
    model: "sora-2",
    seconds: "10",
    size: "1280x720"
  })
});

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

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

Creating an Image with Flux Pro (Paid - $0.02 USDC)

// Frontend makes request
const response = await payingFetch("/api/image/create", {
  method: "POST",
  body: JSON.stringify({
    prompt: "A cute cat wearing sunglasses, digital art"
  })
});

// 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 and images are automatically saved to your browser's local storage, so you can easily re-query them later from the History panel.

API Reference

Genbase provides three AI generation endpoints: Sora 2 (video), Veo (video), and Flux Pro (image).

{
  "prompt": "A cat playing piano in a jazz club",
  "model": "sora-2",           // or "sora-2-pro"
  "seconds": "10",             // "10", "15", or "25" (pro only)
  "size": "1280x720"           // "1280x720", "720x1280", "1792x1024", "1024x1792"
}

{
  "success": true,
  "data": {
    "id": "sora-2:task_01j9abc123xyz456def789ghi0",
    "status": "pending",           // "pending" | "processing" | "Ready" | "failed"
    "video_url": null,             // Available when status is "Ready"
    "thumbnail_url": null
  }
}

{
  "prompt": "A cute cat wearing sunglasses, digital art"
}

{
  "success": true,
  "data": {
    "id": "abc123xyz456def789ghi012jkl345-mn6op7",
    "status": "pending",           // "pending" | "processing" | "Ready"
    "result": {
      "sample": null               // Image URL when status is "Ready"
    }
  }
}

?id=sora-2:task_01j9abc123xyz456def789ghi0

{
  "success": true,
  "data": {
    "id": "sora-2:task_01j9abc123xyz456def789ghi0",
    "status": "Ready",
    "video_url": "https://...",
    "detail": {
      "input": {
        "prompt": "Original prompt",
        "model": "sora-2",
        "duration": "10",
        "size": "1280x720"
      }
    }
  }
}

?id=abc123xyz456def789ghi012jkl345-mn6op7

{
  "success": true,
  "data": {
    "id": "abc123xyz456def789ghi012jkl345-mn6op7",
    "status": "completed",         // Normalized from "Ready"
    "image_url": "https://...",    // Direct image URL
    "result": {
      "sample": "https://..."
    }
  }
}

Features

FAQ