Быстрый старт SDK

1. Установка

Сначала проверьте локальный runtime: TypeScript SDK требует Node.js 18.17+, а Python SDK требует Python 3.10+. После установки импортируйте Python package как seacloud_sdk.

TypeScript

pnpm add @seacloudai/sdk

Python

pip install seacloudai-sdk

2. Создание клиента

Вызывающий код должен явно передать API key. Ваше приложение может сначала прочитать его из environment variable, но SDK не делает это автоматически.

TypeScript

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

const docs = getSeaCloudDocs();

const client = new SeaCloud({
  apiKey: process.env.SEACLOUD_API_KEY!,
  timeout: 600_000,
});

console.table(docs.methods);

Python

import os

from seacloud_sdk import SeaCloud, getSeaCloudDocs

docs = getSeaCloudDocs()

client = SeaCloud(
    api_key=os.environ["SEACLOUD_API_KEY"],
    timeout=600_000,
)

print(docs["methods"])

3. Chat-запрос

TypeScript

const text = await client.chat.send(
  "gpt-5.5",
  [{ role: "user", content: "Introduce SeaCloud SDK in one sentence." }],
  { temperature: 0.2, maxTokens: 128 },
);

console.log(text);

Python

text = await client.chat.send(
    "gpt-5.5",
    [{"role": "user", "content": "Introduce SeaCloud SDK in one sentence."}],
    {"temperature": 0.2, "maxTokens": 128},
)

print(text)

4. Generation task

run создает queue task и сразу возвращает task handle. runSync и run_sync создают task, опрашивают status, читают final response и возвращают normalized result. Generation params должны быть JavaScript objects или Python dicts; SDK не разбирает shell-style flags и не загружает local files автоматически.

TypeScript

const result = await client.runSync("gpt_image_2", {
  prompt: "Generate cute cats programming",
  n: 1,
  size: "1024x1024",
  output_format: "png",
  quality: "auto",
  moderation: "auto",
});

console.log(result.output?.urls);

Python

result = await client.run_sync("gpt_image_2", {
    "prompt": "Generate cute cats programming",
    "n": 1,
    "size": "1024x1024",
    "output_format": "png",
    "quality": "auto",
    "moderation": "auto",
})

print(result.get("output", {}).get("urls"))

Дальше

• Для dryRun, polling, model contracts, service endpoints и errors смотрите руководство по работе.