SeaChat Developer Docs

Agent-native API documentation

SeaChat Developer Docs

Build with SeaChat's agent-native APIs: models, threads, tools, files, Play apps, usage, and capability discovery.

Quick Start

Get an API key

Create a project-scoped key from SeaChat, then keep it in an environment variable. Keys carry explicit scopes; use the narrowest scope that fits the job.

export SEACHAT_API_KEY="sk-seaverse-..."

Call the Responses API

SeaRouter exposes an OpenAI-style Responses endpoint through SeaGate. Provider credentials stay server-side; clients send only the SeaChat key.

curl https://seachat.ai/api/searouter/llm/v1/responses \
  -H "Authorization: Bearer $SEACHAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "Write a concise launch checklist for an agent API."
  }'

Discover available capabilities

Agents should read the gateway capability catalog before choosing routes. It returns scope, stability, runtime-safety, and example metadata for the current credential.

curl "https://seachat.ai/api/seagate/v1/capabilities?runtime=true&includeDenied=true" \
  -H "Authorization: Bearer $SEACHAT_API_KEY"

Inspect model-specific contracts

For image, video, audio, embedding, and rerank work, query model help before sending provider-shaped parameters.

curl "https://seachat.ai/api/searouter/v1/help/models/search?modality=image&q=seedream" \
  -H "Authorization: Bearer $SEACHAT_API_KEY"

Capability-first APIs

SeaChat publishes a gateway capability catalog so agents can reason from declared capability ids, scopes, stability, and runtime safety before choosing a route.

GET

List SeaGate capabilities

/api/seagate/v1/capabilities?runtime=true
seagate catalog stable runtime safe
GET

Read Skill Hub catalog

/api/seaplane/v1/public/skill-catalog/catalog.json
seaplane skills stable runtime safe
POST

Publish Skill Hub catalog

/api/seaplane/v1/admin/skill-catalog/sync
seaplane skills stable runtime safe
GET

Download Skill Hub package

/api/seaplane/v1/public/skill-catalog/releases/{path}
seaplane skills stable runtime safe
GET

SeaRouter help

/api/searouter/v1/help
searouter models stable runtime safe
POST

Generate image

/api/searouter/v1/invoke/image/{model}/{version}
searouter models stable runtime safe
POST

Invoke LLM Responses API

/api/searouter/llm/v1/responses
searouter models stable runtime safe
GET

Search model catalog

/api/searouter/v1/help/models/search?q={query}
searouter models stable runtime safe
GET

Read usage summary

/api/searouter/v1/usage/summary
searouter usage stable runtime safe
GET

List tool catalog

/api/seatool/v1/catalog
seatool tools stable runtime safe