Seisoai

Seisoai

Generate AI images, videos, music, audio, 3D models, and run LLM inference. Pay per request with USDC on Base — no account needed.

Base URL: https://seisoai.com

Quick Start (Recommended for Agents)

The fastest way to use Seisoai is through the Gateway API. One endpoint for everything.

1. Discover Available Tools

GET /api/gateway/tools

Returns all tools with pricing and input schemas.

2. Invoke Any Tool

POST /api/gateway/invoke/{toolId}
Content-Type: application/json

{
  "prompt": "a sunset over mountains",
  ...tool-specific params
}

3. Handle x402 Payment

First request returns HTTP 402. Decode PAYMENT-REQUIRED header, sign payment, retry with PAYMENT-SIGNATURE header.

Common Tool IDs

When to Use Which Tool

User wants an image?
├─ Photorealistic / text in image → flux-2
├─ Fast general purpose → flux-pro-kontext  
├─ 360° panorama → nano-banana-pro
└─ Edit existing image → flux-pro-kontext-edit

User wants a video?
├─ High quality / complex scene → veo3
├─ Fast / simple scene → ltx-text
├─ Animate an image → veo3-image-to-video or ltx-image
└─ First + last frame → veo3-first-last-frame

User wants audio?
├─ Music from description → music.generate
├─ Sound effect → audio.sfx
├─ Clone voice / TTS → audio.tts
├─ Transcribe speech → audio.transcribe
└─ Separate stems → audio.stem-separation

User wants to edit an image?
├─ Swap faces → image.face-swap
├─ Fill in area → image.inpaint
├─ Extend image → image.outpaint
├─ Remove background → image.extract-layer
└─ Upscale → image.upscale

User wants 3D?
└─ Image to GLB model → 3d.image-to-3d

User wants multi-step workflow?
└─ Use /api/gateway/orchestrate with goal description

x402 Payment Flow

All endpoints support x402 pay-per-request. No account needed.

1. POST /api/gateway/invoke/image.generate.flux-2
   → 402 Payment Required + PAYMENT-REQUIRED header

2. Decode header (base64 JSON):
   {
     "accepts": [{
       "scheme": "exact",
       "network": "eip155:8453",
       "maxAmountRequired": "32500",
       "asset": "USDC",
       "payTo": "0x..."
     }]
   }

3. Sign USDC payment with wallet

4. Retry with header:
   PAYMENT-SIGNATURE: <signed payload>

5. Success response includes:
   { "x402": { "settled": true, "transactionHash": "0x..." } }

User Confirmation Required

Before signing any payment, agents MUST:

• Show amount (e.g., "$0.065 USDC")
• Show what's being purchased
• Get explicit user approval

Agent: Generate image of sunset? Cost: $0.065 USDC on Base. [Confirm/Cancel]
User: Confirm
Agent: [signs, generates, returns image]

Core Endpoints

Image Generation

POST /api/generate/image

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

Response:

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

Video Generation

POST /api/generate/video

{
  "prompt": "a cat walking through a garden",
  "model": "veo",
  "duration": "6s",
  "generate_audio": true
}

Response:

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

Music Generation

POST /api/generate/music

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

Voice Clone / TTS

POST /api/audio/voice-clone

{
  "text": "Hello, this is a test of voice cloning.",
  "voice_url": "https://example.com/reference-voice.wav",
  "language": "en"
}

Speech-to-Text

POST /api/audio/transcribe

{
  "audio_url": "https://example.com/speech.mp3",
  "task": "transcribe"
}

Sound Effects

POST /api/audio/sfx

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

Image to 3D

POST /api/model3d/generate

{
  "image_url": "https://example.com/object.jpg",
  "generate_type": "Normal"
}

Image Tools

Face Swap

POST /api/image-tools/face-swap
{ "source_image_url": "...", "target_image_url": "..." }
Price: $0.026

Inpainting

POST /api/image-tools/inpaint
{ "image_url": "...", "mask_url": "...", "prompt": "a red sports car" }
Price: $0.026

Outpainting

POST /api/image-tools/outpaint
{ "image_url": "...", "prompt": "extend the landscape", "direction": "all" }
Price: $0.026

Background Removal

POST /api/extract/layers
{ "image_url": "..." }
Price: $0.039

Upscale

POST /api/generate/upscale
{ "image_url": "..." }
Price: $0.039

Describe Image

POST /api/image-tools/describe
{ "image_url": "...", "detail_level": "detailed" }
Price: $0.013

Multi-Step Orchestration

Let Seisoai plan and execute complex workflows automatically.

POST /api/gateway/orchestrate

{
  "goal": "Create a music video: generate an image of a sunset, animate it to video, add jazz music",
  "planOnly": false
}

The orchestrator will:

1. Generate the sunset image
2. Convert to video with Veo
3. Generate jazz music
4. Combine audio + video

Response includes step-by-step results with all generated assets.

Pre-built Workflows

LLM Chat

POST /api/chat-assistant/message

{
  "message": "Help me create a prompt for a fantasy landscape",
  "model": "claude-sonnet-4-5"
}

Pricing Summary

All prices are final (include 30% markup over API costs).

Error Handling

For Agent Developers

Minimal Integration

import requests
import base64
import json

BASE = "https://seisoai.com"

def generate_image(prompt, wallet_sign_fn):
    # First request gets 402
    r = requests.post(f"{BASE}/api/gateway/invoke/image.generate.flux-2", 
                      json={"prompt": prompt})
    
    if r.status_code == 402:
        # Decode payment requirements
        payment_req = json.loads(base64.b64decode(r.headers["PAYMENT-REQUIRED"]))
        amount = payment_req["accepts"][0]["maxAmountRequired"]
        
        # Get user confirmation
        if not confirm_with_user(f"Generate image for ${int(amount)/1e6:.4f} USDC?"):
            return None
        
        # Sign and retry
        signature = wallet_sign_fn(payment_req)
        r = requests.post(f"{BASE}/api/gateway/invoke/image.generate.flux-2",
                          json={"prompt": prompt},
                          headers={"PAYMENT-SIGNATURE": signature})
    
    return r.json()["images"][0] if r.ok else None

Best Practices

1. Use Gateway API - One interface for all tools
2. Cache tool list - GET /api/gateway/tools doesn't change often
3. Handle 402 gracefully - It's expected, not an error
4. Always confirm payments - Never auto-sign without user approval
5. Use orchestrate for complex tasks - Let Seisoai plan multi-step workflows

Config

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