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 GPT Image (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

Creating a Video with xAI Imagine (Paid - $0.01 USDC/second)

// Frontend makes request
const response = await payingFetch("/api/video/create-xai", {
  method: "POST",
  body: JSON.stringify({
    prompt: "A cat walking on a beach at sunset",
    duration: 5,              // 1-15 seconds
    aspectRatio: "16:9",      // 16:9, 9:16, 1:1, 4:3, 3:4
    resolution: "720p",       // 480p or 720p
    mode: "text-to-video"     // text-to-video, image-to-video, video-to-video
  })
});

// Payment: $0.05 USDC (5 seconds × $0.01)
// Flexible duration - pay only for what you need!

// 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), xAI Imagine (video), and GPT Image (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 cat walking on a beach at sunset",
  "duration": 5,                   // 1-15 seconds
  "aspectRatio": "16:9",           // "16:9", "9:16", "1:1", "4:3", "3:4"
  "resolution": "720p",            // "480p" or "720p"
  "mode": "text-to-video",         // "text-to-video", "image-to-video", "video-to-video"
  "referenceImage": "https://..."  // Optional: for image-to-video mode
}

{
  "success": true,
  "data": {
    "id": "xai_request_123",
    "status": "pending",
    "provider": "xai",
    "duration": 5,
    "message": "Video generation started. Use the query endpoint to check status."
  }
}

{
  "prompt": "A cute cat wearing sunglasses, digital art",
  "referenceImage": "data:image/png;base64,..."  // Optional: for image-to-image
}

{
  "success": true,
  "data": {
    "id": "img_abc123",
    "url": "https://example.com/generated-image.png",
    "status": "completed"
  }
}

?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=xai_request_123

{
  "success": true,
  "data": {
    "id": "xai_request_123",
    "status": "completed",
    "video_url": "https://vidgen.x.ai/video.mp4",
    "url": "https://vidgen.x.ai/video.mp4",
    "provider": "xai",
    "duration": 5,
    "model": "grok-imagine-video"
  }
}

?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