polymerdao/polymer-pay-genbase

Genbase AI Video Generation

Generate AI videos and images via Genbase's x402-enabled platform. Supports multiple generation models including OpenAI Sora 2 for high-quality video, xAI Grok Imagine for fast and flexible video, and GPT Image for AI image generation. Through the Polymer Pay proxy, each generation is paid individually — no Genbase account or API key required.

Authentication

All requests route through the Polymer Pay proxy. Include your Polymer Pay API key in every request:

{
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Base URL: https://pay.polymerlabs.org/proxy/https/www.genbase.fun

To get an Polymer Pay API key, sign up at https://my.pay.polymerlabs.org/dashboard/api-keys.

Common Operations

Generate Video with Sora 2

Generate high-quality AI video using OpenAI's Sora 2 model. Supports multiple durations and resolutions including landscape, portrait, wide, and tall formats. Generation takes 3-15 minutes depending on the model tier.

Pricing: $0.20

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/www.genbase.fun/api/video/create-sora2",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "prompt": "A drone shot flying over a misty mountain valley at sunrise, cinematic lighting",
    "model": "sora-2",
    "seconds": "10",
    "size": "1280x720"
  }
}

Parameters:

| Parameter | Type | Required | Options | Description | |-----------|--------|----------|-----------------------------------------------------------|------------------------------------| | prompt | string | yes | — | Video description | | model | string | no | sora-2, sora-2-pro | Model tier (pro supports 25s) | | seconds | string | no | 10, 15, 25 (pro only) | Video duration | | size | string | no | 1280x720, 720x1280, 1792x1024, 1024x1792 | Output resolution |

Response:

{
  "video_id": "task-uuid",
  "status": "pending",
  "model": "sora-2",
  "seconds": "10",
  "size": "1280x720"
}

Generate Video with xAI Grok Imagine

Generate AI video using xAI's Grok Imagine model. Supports text-to-video, image-to-video, and video-to-video modes with flexible duration (1-15 seconds) and multiple aspect ratios. Generation takes 2-5 minutes.

Pricing: $0.01 per second of video (1-15 seconds)

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/www.genbase.fun/api/video/create-xai",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "prompt": "A cat playing piano in a jazz club, warm ambient lighting",
    "duration": 10,
    "aspectRatio": "16:9",
    "resolution": "720p",
    "mode": "text-to-video"
  }
}

Parameters:

| Parameter | Type | Required | Options | Description | |------------------|---------|----------|----------------------------------------------------------------|--------------------------------------| | prompt | string | yes | — | Video description | | duration | integer | no | 1-15 | Video length in seconds | | aspectRatio | string | no | 16:9, 9:16, 1:1, 4:3, 3:4 | Output aspect ratio | | resolution | string | no | 480p, 720p | Output resolution | | mode | string | no | text-to-video, image-to-video, video-to-video | Generation mode | | referenceImage | string | no | — | URL for image/video reference modes |

Response:

{
  "request_id": "req-uuid",
  "status": "pending",
  "provider": "xai",
  "duration": 10
}

Generate Image with GPT Image

Generate an AI image using GPT Image. Supports text-to-image and image-to-image with an optional base64-encoded reference image. Generation takes 30-90 seconds.

Pricing: $0.02

{
  "method": "POST",
  "url": "https://pay.polymerlabs.org/proxy/https/www.genbase.fun/api/image/create",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "body": {
    "prompt": "A minimalist logo design for a tech startup, clean lines, blue and white color scheme"
  }
}

Parameters:

| Parameter | Type | Required | Description | |------------------|--------|----------|-----------------------------------------------| | prompt | string | yes | Image description | | referenceImage | string | no | Base64-encoded image for image-to-image mode |

Response:

{
  "image_id": "img-uuid",
  "status": "completed",
  "url": "https://..."
}

Query Video Status (Sora 2)

Poll the status of a Sora 2 video generation task. Free endpoint — no payment required.

Pricing: $0.00

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/www.genbase.fun/api/video/query?id={video_id}",
  "headers": {
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Response:

{
  "video_id": "task-uuid",
  "status": "Ready",
  "progress": 100,
  "url": "https://...video_url..."
}

Status values: pending (20%), processing (50%), video_upsampling (80%), Ready (100%), failed

Query Video Status (xAI)

Poll the status of an xAI Grok Imagine video generation task. Free endpoint — no payment required.

Pricing: $0.00

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/www.genbase.fun/api/video/query-xai?id={request_id}",
  "headers": {
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Response:

{
  "request_id": "req-uuid",
  "status": "completed",
  "url": "https://...video_url..."
}

Status values: pending, completed, failed

When to Use

• High-quality video — Use Sora 2 for cinematic, high-fidelity video generation when quality matters most ($0.20 per video).
• Fast and flexible video — Use xAI Grok Imagine for quicker generation with flexible duration (1-15 seconds) and multiple input modes at $0.01/sec.
• Image-to-video — Use xAI with mode: "image-to-video" and a reference image URL to animate a still image.
• Quick image generation — Use GPT Image for fast, affordable AI image generation at $0.02 per image.
• Budget-conscious video — xAI at $0.01/sec for a 5-second video ($0.05) is significantly cheaper than Sora 2 ($0.20) when maximum quality is not required.

Best Practices

• Poll for completion — Video generation is asynchronous. After submitting a request, poll the corresponding query endpoint every 15-30 seconds until the status is Ready or completed.
• Use Sora 2 for quality, xAI for speed — Sora 2 produces higher-quality output but takes 3-15 minutes. xAI generates in 2-5 minutes and is cheaper for shorter clips.
• Start with short durations — Use 10-second Sora 2 videos or short xAI clips to validate your prompt before generating longer content.
• Write cinematic prompts — Include camera movements (drone shot, tracking shot), lighting (golden hour, cinematic), and specific visual details for the best results.
• Mind content policy — Sora 2 enforces OpenAI's content policy. Prompts with violence or adult content will cause generation failure. Contact [email protected] with video_id and wallet address for refunds on policy failures.
• Choose the right resolution — For Sora 2, use 1280x720 for landscape, 720x1280 for portrait/vertical content, 1792x1024 for widescreen, and 1024x1792 for tall formats.
• For errors — See @skills/polymer-pay-api-errors/SKILL.md for complete error code reference and troubleshooting