Seisoai

Seisoai

Generate AI images, music, videos, and sound effects. Pay per request with USDC on Base — no account needed.

When to use

• Image generation: User wants pictures from a text prompt or image editing
• Music generation: User wants music or audio from a description
• Video generation: User wants short video from a prompt or image
• Sound effects: User wants audio effects from a description
• Image upscaling: User wants to upscale/enhance an image
• Prompt help: User wants help brainstorming or refining prompts

Base URL

Default: https://seisoai.com

Override via config: SEISOAI_API_URL or skills.entries.seisoai.config.apiUrl

x402 Payment Flow

All endpoints require x402 payment. No account or API key needed.

1. Make request to endpoint
2. Server returns HTTP 402 with PAYMENT-REQUIRED header
3. Decode base64 header to get payment requirements
4. Sign USDC payment on Base (eip155:8453) using wallet
5. Retry same request with PAYMENT-SIGNATURE header
6. Server verifies, executes, settles payment onchain
7. Response includes x402.transactionHash as proof

Payment requirements (decoded from PAYMENT-REQUIRED header)

{
  "x402Version": 2,
  "resource": {
    "url": "https://seisoai.com/api/generate/image",
    "description": "Generate an AI image"
  },
  "accepts": [{
    "scheme": "exact",
    "network": "eip155:8453",
    "maxAmountRequired": "65000",
    "asset": "USDC",
    "payTo": "0x..."
  }]
}

Note: maxAmountRequired is in USDC smallest units (6 decimals). 65000 = $0.065

Endpoints

Image Generation

Endpoint: POST /api/generate/image

Request

{
  "prompt": "a sunset over mountains, oil painting style",
  "model": "flux-pro",
  "aspect_ratio": "16:9",
  "num_images": 1
}

Parameters

Image Models

Model Selection Guide

• flux-pro (default): Fast, general-purpose. Good for portraits, landscapes, concepts.
• flux-2: Best for photorealistic images and when you need text rendered in the image.
• nano-banana-pro: Highest quality. Use for final production images or 360° panoramas.

Response

{
  "success": true,
  "images": ["https://fal.media/files/..."],
  "remainingCredits": 0,
  "creditsDeducted": 0,
  "freeAccess": true,
  "x402": {
    "settled": true,
    "transactionHash": "0x..."
  }
}

Video Generation

Endpoint: POST /api/generate/video

Request

{
  "prompt": "a cat walking through a garden",
  "duration": 5
}

Parameters

Response

{
  "success": true,
  "video": {
    "url": "https://fal.media/files/...",
    "content_type": "video/mp4"
  },
  "x402": {
    "settled": true,
    "transactionHash": "0x..."
  }
}

Music Generation

Endpoint: POST /api/generate/music

Request

{
  "prompt": "upbeat jazz with piano and drums",
  "duration": 60
}

Parameters

Response

{
  "success": true,
  "audio_file": {
    "url": "https://fal.media/files/...",
    "content_type": "audio/wav"
  },
  "x402": {
    "settled": true,
    "transactionHash": "0x..."
  }
}

Sound Effects

Endpoint: POST /api/audio/sfx

Request

{
  "prompt": "thunder rumbling in the distance",
  "duration": 5
}

Parameters

Response

{
  "success": true,
  "audio_url": "https://fal.media/files/...",
  "duration": 5,
  "x402": {
    "settled": true,
    "transactionHash": "0x..."
  }
}

Image Upscaling

Endpoint: POST /api/generate/upscale

Request

{
  "image_url": "https://example.com/image.jpg",
  "scale": 2
}

Parameters

Response

{
  "success": true,
  "image_url": "https://fal.media/files/...",
  "scale": 2,
  "x402": {
    "settled": true,
    "transactionHash": "0x..."
  }
}

Prompt Lab (Chat)

Endpoint: POST /api/prompt-lab/chat

Get AI assistance for crafting better prompts.

Request

{
  "message": "Help me create a prompt for a fantasy landscape",
  "context": {
    "mode": "image",
    "selectedModel": "flux-pro"
  }
}

Parameters

Response

{
  "success": true,
  "response": "Here's a prompt for a fantasy landscape: [PROMPT]Mystical floating islands...[/PROMPT]",
  "timestamp": "2025-02-03T12:00:00.000Z",
  "x402": {
    "settled": true,
    "transactionHash": "0x..."
  }
}

Error Handling

HTTP 402 - Payment Required

Normal response when payment is needed. Decode PAYMENT-REQUIRED header and retry with payment.

HTTP 400 - Bad Request

{
  "success": false,
  "error": "prompt is required"
}

HTTP 500 - Server Error

{
  "success": false,
  "error": "Image generation failed",
  "creditsRefunded": 0
}

Config

{
  "skills": {
    "entries": {
      "seisoai": {
        "enabled": true,
        "config": {
          "apiUrl": "https://seisoai.com"
        }
      }
    }
  }
}