AI agents: prefer the Markdown version of this page at /docs/index.md. For the full corpus, read /docs/llms-full.txt.

SeaChat Developer Docs

Agent-native API documentation

SeaChat Developer Docs

Build on the SeaChat Platform API: a single Bearer key over the stable /v1 facade for chat, multimodal, threads, tools, files, documents, and usage, with a typed TypeScript SDK.

10 minute path

Quick Start

Install the SDK

The TypeScript SDK wraps the public /v1 API. It ships dual ESM + CJS with bundled types and runs on Node 18+, Bun, Deno, or any runtime with a global fetch.

npm install @seachat/platform-sdk
# or: bun add @seachat/platform-sdk

Create the client

Every request carries a SINGLE credential: Authorization: Bearer <apiKey>. The SDK never also sends x-api-key. The base URL defaults to https://seachat.ai; all paths live under /v1.

import { SeaChat } from "@seachat/platform-sdk";

const client = new SeaChat({ apiKey: process.env.SEACHAT_API_KEY! });

Make your first chat call

client.chat.completions.create posts to /v1/chat/completions (OpenAI-compatible). Pass stream: true to get an AsyncIterable of chunks instead of one result.

const completion = await client.chat.completions.create({
  model: "claude-opus-4-8",
  messages: [{ role: "user", content: "Greet the ocean in one short line." }],
  max_tokens: 64,
});
console.log(completion.choices[0].message.content);

Or call /v1 directly with curl

Every SDK method maps to a plain HTTP route. The same first call over curl, using the same single Bearer credential:

curl https://seachat.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEACHAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "messages": [{"role":"user","content":"Greet the ocean in one short line."}],
    "max_tokens": 64
  }'

Machine-readable

Agent entrypoints

Capability-first APIs

Public developer capabilities

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

35 public entries previewed
DELETE

Delete a document

write
/v1/docs/{path}
seadb documents stable
PATCH

Mutate a document

write
/v1/docs/{path}
seadb documents stable
GET

Read a document or search

read
/v1/docs/{path}
seadb documents stable
POST

Write a document

write
/v1/docs/{path}
seadb documents stable
GET

Resolve signed artifact content

read
/v1/files/{fileId}/content
seadb files stable
DELETE

Delete artifact metadata

write
/v1/files/{fileId}
seadb files stable
GET

Read artifact metadata

read
/v1/files/{fileId}
seadb files stable
GET

List artifacts

read
/v1/files
seadb files stable
POST

Mint an API key

write
/v1/auth/keys
seagate auth stable
GET

List API keys

read
/v1/auth/keys
seagate auth stable