SeaCloud SDK 概览

SeaCloud SDK 是面向应用服务、自动化脚本和 Agent 的纯代码开发包。当前公开文档覆盖已经发布的 TypeScript 和 Python SDK，用同一套 SeaCloud API Key 调用 LLM、多模态生成、模型规格、异步任务和 SkillHub 能力。

SDK 不负责 UI、命令行交互、配置文件发现或凭据存储。调用方必须在创建客户端时显式传入 API Key；SDK 内部不会从环境变量读取或推断凭据。

文档导航

快速开始 按语言安装 SDK、初始化客户端，并完成第一段对话或生成任务。

操作手册 查看生成任务、dry run、任务查询、模型规格、SkillHub 和错误处理。

已发布 SDK

语言	包名 / module	当前定位
TypeScript	@seacloudai/sdk	面向 Node.js、浏览器代理和 TypeScript 应用，支持 ESM 与 CommonJS。
Python	seacloudai-sdk，导入名 seacloud_sdk	面向 Python 服务、脚本和异步应用，基于 httpx。

共同能力

能力	TypeScript	Python
初始化客户端	new SeaCloud({ apiKey })	SeaCloud(api_key=...)
离线读取 SDK 文档	getSeaCloudDocs()	getSeaCloudDocs()
对话	client.chat.send()	client.chat.send()
创建异步生成任务	client.run()	client.run()
创建任务并等待结果	client.runSync()	client.run_sync()
查询任务状态	client.tasks.get()	client.tasks.get()
读取任务结果	client.tasks.getResponse()	client.tasks.get_response()
模型列表	client.models.list()	client.models.list()
模型规格	client.models.getSpec()	client.models.get_spec()
搜索 SkillHub	client.skills.find()	client.skills.find()
列出 SkillHub	client.skills.list()	client.skills.list()

什么时候用 SDK

• 应用需要长期集成 SeaCloud 模型调用，而不是临时 curl 调试。
• 需要统一处理 API Key、超时、错误映射、异步任务轮询和结果归一化。
• 需要让 Agent 通过 getSeaCloudDocs() 离线理解 SDK 的方法、参数和操作手册。
• 需要在生成前用 dryRun 预览将要发送的 queue 请求。

如果只是终端登录、查看模型或临时执行模型，可以优先使用 SeaCloud CLI；如果要直接接入 HTTP 协议，可以查看 Model API 文档。