# seacloudai-sdk

Python SDK for SeaCloud AI generation APIs.

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

Install:

```bash
pip install seacloudai-sdk
```

Minimal usage:

```python
from seacloud_sdk import SeaCloud, getSeaCloudDocs

docs = getSeaCloudDocs()
client = SeaCloud(api_key="sk-...")

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

Main methods:

- `getSeaCloudDocs(options)`: offline package guide for AI agents and tools.
- `SeaCloud(api_key, timeout, fetch)`: create the SDK client.
- `client.chat.send(model, messages, options)`: send chat requests.
- `client.run(model_id, params, options)`: create a contract-aware async queue task.
- `client.run_sync(model_id, params, options)`: create a contract-aware task and wait for the final response.
- `client.tasks.get(task_id, options)`: read queue task status.
- `client.tasks.get_response(task_id, options)`: read final queue response.
- `client.models.list(options)` and `client.models.get_spec(model_id)`: inspect models.
- `client.skills.find(query, options)` and `client.skills.list(options)`: inspect SkillHub.
