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 | Task | Tool ID | Price | |------|---------|-------| | Image (fast) | `image.generate.flux-pro-kontext` | $0.065 | | Image (photorealistic) | `image.generate.flux-2` | $0.0325 | | Image (premium) | `image.generate.nano-banana-pro` | $0.325 | | Video (quality) | `video.generate.veo3` | $0.13/sec | | Video (fast) | `video.generate.ltx-text` | $0.052/sec | | Music | `music.generate` | $0.026/min | | Voice clone | `audio.tts` | $0.026 | | Transcribe | `audio.transcribe` | $0.013 | | Image to 3D | `3d.image-to-3d` | $0.195 | --- ## 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** ```json { "prompt": "a sunset over mountains, oil painting style", "model": "flux-pro", "aspect_ratio": "16:9", "num_images": 1 } ``` | Param | Type | Default | Description | |-------|------|---------|-------------| | `prompt` | string | required | Image description | | `model` | string | `flux-pro` | `flux-pro`, `flux-2`, `nano-banana-pro` | | `aspect_ratio` | string | `1:1` | `1:1`, `16:9`, `9:16`, `4:3`, `3:4` | | `num_images` | int | 1 | 1-4 | | `image_url` | string | - | Reference image for editing | | `seed` | int | - | Reproducibility seed | **Response:** ```json { "success": true, "images": ["https://fal.media/files/..."], "x402": { "settled": true, "transactionHash": "0x..." } } ``` --- ### Video Generation **POST /api/generate/video** ```json { "prompt": "a cat walking through a garden", "model": "veo", "duration": "6s", "generate_audio": true } ``` | Param | Type | Default | Description | |-------|------|---------|-------------| | `prompt` | string | required | Video description | | `model` | string | `veo` | `veo` (quality) or `ltx` (fast) | | `duration` | string | `6s` | `4s`, `6s`, `8s` for Veo; 1-10s for LTX | | `generate_audio` | bool | true | Generate synchronized audio | | `first_frame_url` | string | - | Starting frame image | | `last_frame_url` | string | - | Ending frame image | **Response:** ```json { "success": true, "video": { "url": "https://fal.media/files/...", "content_type": "video/mp4" }, "x402": { "settled": true, "transactionHash": "0x..." } } ``` --- ### Music Generation **POST /api/generate/music** ```json { "prompt": "upbeat jazz with piano and drums, 120 BPM", "duration": 60, "selectedGenre": "jazz" } ``` | Param | Type | Default | Description | |-------|------|---------|-------------| | `prompt` | string | required | Music description (include genre, instruments, mood, tempo) | | `duration` | int | 60 | Duration in seconds (10-180) | | `selectedGenre` | string | - | `lo-fi`, `electronic`, `orchestral`, `rock`, `jazz` | --- ### Voice Clone / TTS **POST /api/audio/voice-clone** ```json { "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** ```json { "audio_url": "https://example.com/speech.mp3", "task": "transcribe" } ``` | Param | Type | Default | Description | |-------|------|---------|-------------| | `audio_url` | string | required | Audio/video URL | | `task` | string | `transcribe` | `transcribe` or `translate` (to English) | | `chunk_level` | string | `segment` | `segment` or `word` for timestamps | --- ### Sound Effects **POST /api/audio/sfx** ```json { "prompt": "thunder rumbling in the distance", "duration": 5 } ``` --- ### Image to 3D **POST /api/model3d/generate** ```json { "image_url": "https://example.com/object.jpg", "generate_type": "Normal" } ``` | Type | Price | Output | |------|-------|--------| | `Normal` | $0.195 | Full textured GLB | | `Geometry` | $0.13 | Geometry only | | `LowPoly` | $0.104 | Low-poly mesh | --- ## 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** ```json { "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 | Workflow | Endpoint | Description | Est. Cost | |----------|----------|-------------|-----------| | AI Influencer | `POST /api/workflows/ai-influencer` | Portrait → Voice → Lip Sync | ~$0.15 |