seisoUnified media generation gateway for agents. Discover tools dynamically, choose API key or x402 auth, invoke image/video/audio/music/3D/training tools, and h...
Install via ClawdBot CLI:
clawdbot install Legendarylibr/seisoBase URL: https://seisoai.com
Primary endpoint: POST /api/gateway/invoke/{toolId} or POST /api/gateway/invoke with toolId in body.
Auth: X-API-Key or x402 payment (USDC on Base).
GET /api/gateway/toolsGET /api/gateway/tools/{toolId}GET /api/gateway/price/{toolId}Do not rely on static tool lists when a live registry is available.
Use this decision order:
X-API-Key.POST /api/gateway/invoke/image.generate.flux-2
X-API-Key: sk_live_xxx
Content-Type: application/json
{"prompt":"a sunset over mountains"}402 with payment requirements.payment-signaturex-paymentpaymentGET /api/gateway/toolsGET /api/gateway/tools/{toolId}GET /api/gateway/price/{toolId}GET /api/gateway/mcp-manifestPOST /api/gateway/invoke/{toolId}POST /api/gateway/invokeGET /api/gateway/jobs/{jobId}?model=...GET /api/gateway/jobs/{jobId}/result?model=...GET /api/gateway/agentsGET /api/gateway/agent/{agentId}POST /api/gateway/agent/{agentId}/invoke/{toolId?}POST /api/gateway/agent/{agentId}/orchestrateFor normal media generation (images, video, audio, 3D), use /api/gateway/invoke and the discovery endpoints above; no extra checks. The rules below apply only when the user explicitly asks to run or orchestrate a specific agent (e.g. a named bot or workflow).
Default posture: deny by default for agent-scoped routes (/api/gateway/agent/*). Use agent-scoped endpoints only when all checks pass:
/agent/* routes unless the current task explicitly requires operating a specific agent.agentId from a trusted source (GET /api/gateway/agents or user-provided exact ID).agentId unless the user explicitly requests multi-agent execution.GET /api/gateway/agent/{agentId} and only use tool IDs declared for that agent.agentId is known.agentId, route, tool ID, and reason for each agent-scoped call in agent run notes./agent/*; fall back to /api/gateway/invoke.image.generate.flux-2image.generate.kling-image-v3image.generate.kling-image-o3image.generate.nano-banana-proimage.generate.flux-pro-kontext-editimage.face-swapimage.inpaint, image.outpaintimage.extract-layerimage.upscalevideo.generate.veo3video.generate.veo3-image-to-videovideo.generate.veo3-first-last-framevideo.generate.kling-3-pro-text, video.generate.kling-3-std-textvideo.generate.kling-3-pro-image, video.generate.kling-3-std-imagevideo.generate.dreamactor-v2audio.ttsaudio.tts.minimax-hd, audio.tts.minimax-turboaudio.lip-syncaudio.transcribemusic.generateaudio.sfxaudio.stem-separation3d.image-to-3d3d.image-to-3d.hunyuan-pro3d.text-to-3d.hunyuan-pro3d.image-to-3d.hunyuan-rapid3d.smart-topology, 3d.part-splitterText->image:
{"prompt":"..."}Image edit:
{"prompt":"...","image_url":"https://..."}Text->video:
{"prompt":"...","duration":"6s"}DreamActor motion transfer:
{"source_image_url":"https://...","driving_video_url":"https://..."}Voice clone TTS:
{"text":"...","audio_url":"https://..."}3D image->mesh:
{"image_url":"https://...","output_format":"glb"}If executionMode is queue, response includes job metadata. Use:
statusUrl until completed/failed.resultUrl when completed.Treat queue submit success as billable success (x402 settlement/API-key credit deduction already handled server-side).
400: Schema/input mismatch. Re-fetch tool schema and correct fields.402: Missing/invalid payment or insufficient API key credits.404: Tool/agent not found. Refresh registry.503: Tool disabled. Select fallback in same category.500: Retry with backoff; then switch model/tool.GET /tools/{toolId} for required fields./api/gateway/agent/* as privileged routes and apply the mandatory safety controls above.When this file is updated:
backend/services/toolRegistry.ts.last_synced and version.Generated Feb 23, 2026
Agencies can dynamically discover and invoke tools to generate branded images, videos, and audio for campaigns. By using live tool discovery, they adapt to new models like Kling or Veo for premium content, ensuring up-to-date quality. Queue handling allows batch processing of assets without blocking workflows.
Online retailers generate 3D models from product images for interactive shopping experiences. They use tools like image-to-3D for standard models and Hunyuan-pro for high-fidelity renders, with mesh post-processing for optimization. API key auth enables scalable, automated asset generation across product catalogs.
Studios create video content from text or images using tools like Veo for cinematic quality and DreamActor for motion transfer. They leverage queue jobs for rendering long videos and x402 pay-per-request for flexible, cost-effective usage. Audio tools add voice cloning and sound effects for complete productions.
Edtech platforms generate instructional videos, 3D models for STEM subjects, and audio narrations with voice cloning. They use agent-scoped safety controls to restrict tool access for specific educational bots, ensuring compliance. Live discovery helps integrate the latest AI models for engaging learning materials.
Social media managers automate creation of images, short videos, and audio clips for posts. They rely on fast tools like flux-2 for images and Kling for videos, with background removal for branding. Pay-per-request via x402 suits variable posting schedules without upfront costs.
Offer tiered subscriptions with API keys for businesses needing high-volume media generation. Revenue comes from monthly fees based on usage limits and premium tool access. This model ensures predictable income and supports enterprise clients with dedicated support.
Enable developers and individuals to pay per request via x402 payment on Base, using USDC. Revenue is generated from transaction fees on each tool invocation. This model attracts casual users and startups with low upfront costs and flexible scaling.
Provide customized agent workflows for specific industries, using agent-scoped endpoints with safety controls. Revenue comes from licensing fees and setup costs for tailored integrations. This model targets large organizations needing secure, branded AI media generation.
💬 Integration Tip
Always start sessions with live tool discovery to ensure compatibility with the latest models, and implement queue polling for reliable job handling in production environments.
Use the @steipete/oracle CLI to bundle a prompt plus the right files and get a second-model review (API or browser) for debugging, refactors, design checks, or cross-validation.
Manage Things 3 via the `things` CLI on macOS (add/update projects+todos via URL scheme; read/search/list from the local Things database). Use when a user asks Clawdbot to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags.
Local search/indexing CLI (BM25 + vectors + rerank) with MCP mode.
Use when designing database schemas, writing migrations, optimizing SQL queries, fixing N+1 problems, creating indexes, setting up PostgreSQL, configuring EF Core, implementing caching, partitioning tables, or any database performance question.
Connect to Supabase for database operations, vector search, and storage. Use for storing data, running SQL queries, similarity search with pgvector, and managing tables. Triggers on requests involving databases, vector stores, embeddings, or Supabase specifically.
Query, design, migrate, and optimize SQL databases. Use when working with SQLite, PostgreSQL, or MySQL — schema design, writing queries, creating migrations, indexing, backup/restore, and debugging slow queries. No ORMs required.