Seisoai

Base 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).

Agent-First Workflow (Do This Every Session)

1. 1. Discover live tools:

1. 2. For selected tools, fetch exact schema:

1. 3. Optionally pre-price inputs:

1. 4. Invoke with API key or x402.
2. If queue tool, poll job status/result URLs from response.

Do not rely on static tool lists when a live registry is available.

Auth Strategy

Use this decision order:

1. 1. If you have a project API key, use X-API-Key.
2. If you do not have a key, use x402 pay-per-request.
3. Do not send browser CSRF tokens for machine clients.

API Key Example

CODEBLOCK0

x402 Example (2-step)

1. 1. Call without payment header.
2. Receive 402 with payment requirements.
3. Sign/pay on Base.
4. Retry same request with one of:

High-Value Endpoints

• - Discovery:

• - Invoke:

• - Jobs:

• - Agent-scoped:

Agent-Scoped Safety Controls (Mandatory)

For 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:

1. 1. Explicit task requirement

1. 2. Exact agent binding

1. 3. Authorization boundary

1. 4. Single-agent scope

1. 5. Tool allowlist enforcement

1. 6. No recursive orchestration

1. 7. No broad discovery exfiltration

1. 8. Audit trail requirement

1. 9. On mismatch or ambiguity: stop

Tool Selection Cheatsheet (Verified IDs)

Images

• - Fast text->image: INLINECODE36
• Premium cinematic: INLINECODE37
• Premium consistency: INLINECODE38
• 360/panorama: INLINECODE39
• Prompted edit: INLINECODE40
• Face swap: INLINECODE41
• Inpaint/outpaint: image.inpaint, INLINECODE43
• Background removal/layer: INLINECODE44
• Upscale: INLINECODE45

Video

• - Text->video (Veo): INLINECODE46
• Image->video (Veo): INLINECODE47
• First/last frame: INLINECODE48
• Kling text: video.generate.kling-3-pro-text, INLINECODE50
• Kling image: video.generate.kling-3-pro-image, INLINECODE52
• Motion transfer: INLINECODE53

Audio / Speech / Music

• - Voice clone TTS: INLINECODE54
• TTS quality tiers: audio.tts.minimax-hd, INLINECODE56
• Lip sync: INLINECODE57
• Transcription: INLINECODE58
• Music: INLINECODE59
• Sound FX: INLINECODE60
• Stem separation: INLINECODE61

3D

• - Image->3D standard: INLINECODE62
• Image->3D pro: INLINECODE63
• Text->3D pro: INLINECODE64
• Fast image->3D: INLINECODE65
• Mesh post-processing: 3d.smart-topology, INLINECODE67

Minimal Payload Patterns

Text->image:
CODEBLOCK1

Image edit:
CODEBLOCK2

Text->video:
CODEBLOCK3

DreamActor motion transfer:
CODEBLOCK4

Voice clone TTS:
CODEBLOCK5

3D image->mesh:
CODEBLOCK6

Queue Handling Contract

If executionMode is queue, response includes job metadata. Use:

1. 1. statusUrl until completed/failed.
2. INLINECODE71 when completed.

Treat queue submit success as billable success (x402 settlement/API-key credit deduction already handled server-side).

Error Policy

• - 400: Schema/input mismatch. Re-fetch tool schema and correct fields.
• INLINECODE73: Missing/invalid payment or insufficient API key credits.
• INLINECODE74: Tool/agent not found. Refresh registry.
• INLINECODE75: Tool disabled. Select fallback in same category.
• INLINECODE76: Retry with backoff; then switch model/tool.

Reliability Rules for Agents

1. 1. Always discover live tools before planning multi-step flows.
2. Use exact schema from GET /tools/{toolId} for required fields.
3. Keep one tool call per request; chain in your agent.
4. Prefer explicit model/tool IDs over natural-language routing assumptions.
5. For retries, do not reuse stale x402 signatures.
6. Treat /api/gateway/agent/* as privileged routes and apply the mandatory safety controls above.

Self-Maintenance

When this file is updated:

• - Keep IDs aligned with backend/services/toolRegistry.ts.
• Update last_synced and version.
• Keep examples minimal and executable.

Changelog

• - [2026-02-09] v1.1.1 - Added mandatory safety controls for agent-scoped endpoints (deny-by-default, agent/tool scoping, anti-recursion, and audit requirements).
• [2026-02-09] v1.1.0 - Rewrote for agent discovery-first flow, corrected stale tool IDs/params, tightened auth/x402 guidance, and added queue/error reliability policy.
• [2026-02-08] v1.0.0 - Initial self-improvement protocol added.