# @seacloudai/sdk

TypeScript SDK for SeaCloud AI generation APIs.

Use this package from trusted server-side JavaScript or TypeScript code. Do not
put a SeaCloud API key in browser code.

Install:

```bash
pnpm add @seacloudai/sdk
```

Minimal usage:

```ts
import { SeaCloud, getSeaCloudDocs } from "@seacloudai/sdk";

const docs = getSeaCloudDocs();
const client = new SeaCloud({ apiKey: process.env.SEACLOUD_API_KEY! });

const task = await client.run("gpt_image_2", {
  prompt: "a photorealistic orange tabby cat by a sunny window",
  n: 1,
});
```

Main methods:

- `getSeaCloudDocs(options?)`: offline package guide for AI agents and tools.
- `new SeaCloud({ apiKey, timeout?, fetch? })`: create the SDK client.
- `client.chat.send(model, messages, options?)`: send chat requests.
- `client.run(modelId, params, options?)`: create an async queue task.
- `client.runSync(modelId, params, options?)`: create a task and wait for the final response.
- `client.tasks.get(taskId, options?)`: read queue task status.
- `client.tasks.getResponse(taskId, options?)`: read final queue response.
- `client.models.list(options?)` and `client.models.getSpec(modelId)`: inspect models and generation parameter contracts. `models.list` supports `page`, `pageSize`, `type`, `keywords`, and `provider`; responses keep SDK camelCase fields plus service-compatible snake_case aliases such as `page_size`, `total_pages`, and `input_modalities`.
- `client.skills.find(query, options?)` and `client.skills.list(options?)`: inspect SkillHub.