Обзор SeaCloud SDK

SeaCloud SDK - это pure-code пакеты для приложений, автоматизаций и агентов. Публичная документация покрывает выпущенные TypeScript и Python SDK для LLM chat, queue-based мультимодальной генерации, model contracts, async tasks и SkillHub.

С одним SeaCloud API key используйте chat.send для LLM-диалогов, а run / runSync или run_sync - для image, video, audio, 3D и других queue generation tasks. SDK поставляются с production service endpoints, но вызывающий код обязан явно передать API key при создании клиента; SDK не читают credentials из environment variables самостоятельно.

SDK не предоставляют UI, CLI prompts, config-file discovery, credential storage, local file upload или shell-style flag parsing. Generation params передаются как обычные JavaScript objects или Python dicts.

Навигация

Быстрый старт Установить SDK, создать клиент и выполнить первый chat или generation вызов.

Руководство по работе Использовать generation tasks, dry run, task polling, model contracts, SkillHub и ошибки.

Выпущенные SDK

Язык	Package / module	Когда использовать
TypeScript	@seacloudai/sdk	Node.js, browser-proxy и TypeScript приложения с поддержкой ESM и CommonJS.
Python	seacloudai-sdk, импортируется как seacloud_sdk	Python services, scripts и async applications на базе httpx.

Карта общих возможностей

Возможность	TypeScript	Python
Создать клиент	new SeaCloud({ apiKey })	SeaCloud(api_key=...)
Офлайн-документация SDK	getSeaCloudDocs()	getSeaCloudDocs()
Chat	client.chat.send()	client.chat.send()
Создать async task	client.run()	client.run()
Дождаться результата	client.runSync()	client.run_sync()
Прочитать task status	client.tasks.get()	client.tasks.get()
Прочитать task response	client.tasks.getResponse()	client.tasks.get_response()
Список моделей	client.models.list()	client.models.list()
Прочитать model contract	client.models.getSpec()	client.models.get_spec()
Поиск в SkillHub	client.skills.find()	client.skills.find()
Список SkillHub	client.skills.list()	client.skills.list()

Когда использовать SDK

• Нужна долгоживущая интеграция вместо разовых curl вызовов.
• Нужна единая обработка API key, timeouts, errors, task polling и normalized outputs.
• Нужно, чтобы агенты могли читать локальное описание SDK через getSeaCloudDocs().
• Нужен dryRun, чтобы посмотреть queue request до отправки generation task.
• Нужна управляемая SDK загрузка model contract с режимами auto, strict или off.

Для terminal sign-in, просмотра моделей или временного запуска модели используйте SeaCloud CLI. Для прямой HTTP-интеграции используйте Model API.