seacloud-sdk 0.2.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "seacloud-sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "SeaCloud SDK for JavaScript/TypeScript",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,6 +18,13 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
   "keywords": [
     "seacloud",
     "sdk",
@@ -33,11 +40,5 @@
     "tsup": "^8.0.1",
     "typescript": "^5.3.3",
     "vitest": "^1.0.4"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "test": "vitest",
-    "clean": "rm -rf dist"
   }
-}
+}

package/README.md

@@ -1,327 +0,0 @@
-# SeaCloud SDK
-
-JavaScript/TypeScript SDK for SeaCloud AI Platform
-
-## 特性
-
-✨ **简单易用**：简洁的 API 设计，快速上手
-🔒 **类型安全**：完整的 TypeScript 类型定义
-🌐 **跨平台**：支持 Node.js 和浏览器环境
-⚡ **现代化**：基于 ESM 模块，支持 tree-shaking
-📦 **零依赖**：核心模块无外部依赖
-
-## 安装
-
-```bash
-npm install seacloud-sdk
-```
-
-## 快速开始
-
-### 1. 设置环境变量
-
-```bash
-export API_SERVICE_TOKEN=your-api-token-here
-```
-
-### 2. 使用方式一：直接使用 API 函数（推荐）
-
-```typescript
-import { SeacloudClient, alibabaWanx3Turbo } from 'seacloud-sdk';
-
-// 创建客户端（API Key 自动从环境变量 API_SERVICE_TOKEN 读取）
-const client = new SeacloudClient({
-  baseUrl: 'http://localhost:8080', // 代理服务器地址
-});
-
-// 调用图片生成 API
-const images = await alibabaWanx3Turbo(
-  client,
-  { prompt: 'A beautiful sunset over the ocean' },
-  {
-    onProgress: (attempt, status) => {
-      console.log(`轮询第 ${attempt} 次，状态: ${status}`);
-    },
-  },
-);
-
-console.log('生成的图片 URL:', images[0].url);
-```
-
-### 3. 使用方式二：使用底层 API
-
-```typescript
-import { SeacloudClient, createAndWaitTask } from 'seacloud-sdk';
-
-const client = new SeacloudClient();
-
-const result = await createAndWaitTask(
-  client,
-  '/model/tasks',
-  {
-    model: 'alibaba_wanx_3_turbo',
-    input: {
-      prompt: 'A beautiful sunset over the ocean',
-    },
-  },
-);
-
-console.log('任务结果:', result.output);
-```
-
-## 目录结构
-
-```
-seacloud-sdk/
-├── src/
-│   ├── core/             # 核心模块
-│   │   ├── client.ts     # HTTP 客户端
-│   │   ├── config.ts     # 配置管理
-│   │   ├── poller.ts     # 任务轮询
-│   │   ├── types.ts      # 类型定义
-│   │   └── index.ts
-│   ├── api/              # API 模型（即将添加）
-│   │   └── index.ts
-│   ├── utils/            # 工具函数
-│   │   └── index.ts
-│   └── index.ts          # 主入口
-├── examples/             # 使用示例
-│   ├── basic.ts
-│   └── manual-polling.ts
-└── dist/                 # 构建输出
-```
-
-此结构完全参考 Rust 版本的 [seacloud-cli](https://github.com/seaverse/seacloud-cli)，便于理解和维护。
-
-## 可用的 API 模型
-
-SDK 包含 **195 个** AI 模型 API，覆盖以下类别：
-
-### 图片生成
-- **Alibaba Wanx**: `alibabaWanx3Turbo`, `alibabaWanx21`, `alibabaWanxV2Turbo` 等 26 个模型
-- **Flux**: `blackforestlabsFlux11Pro`, `blackforestlabsFluxDev`, `blackforestlabsFluxPro` 等 9 个模型
-- **Google**: `googleImagen30`, `googleImagen30Fast`
-- **Stability AI**: `stabilityaiSd35Large`, `stabilityaiStableImageUltra` 等 5 个模型
-- **SeaArt**: `seaartFlux11Pro`, `seaartSdXl`, `seaartWan` 等 10 个模型
-- **其他**: `openaiDallE3`, `falRecraftV3`, `falKolors` 等
-
-### 视频生成
-- **Kling**: `klingV1`, `klingV15`, `klingV16`, `klingV21Master`, `klingV25Turbo`, `klingV26` 等 25 个模型
-- **Vidu**: `vidu15`, `vidu20I2v`, `viduQ1`, `viduQ2`, `viduQ2Pro` 等 18 个模型
-- **Minimax**: `minimaxHailuo02`, `minimaxHailuo23I2v`, `minimaxT2v01` 等 7 个模型
-- **Pixverse**: `pixverseV2`, `pixverseV25`, `pixverseV3` 等 7 个模型
-- **Youchuan**: `youchuanDiffusion`, `youchuanVideoDiffusion`, `youchuanExtendVideo` 等 15 个模型
-- **Volces**: `volcesSeedance30`, `volcesSeedancePro` 等 21 个模型
-- **其他**: `runwayGen3aTurboI2v`, `googleVeo2`
-
-### 音频生成
-- **Minimax**: `minimaxT2a`
-- **Mureka**: `murekaSongGenerator`, `murekaInstrumentalGenerator`, `murekaLyricsGenerator` 等 5 个模型
-- **ElevenLabs**: `elevenlabsTtsGenerator`
-
-### 3D 模型
-- **Tencent Hunyuan**: `tencentHunyuan3d`, `tencentHunyuan3dPro`, `tencentHunyuan3dRapid`
-- **Tripo3D**: `tripo3dTextToModel`, `tripo3dImageToModel` 等 4 个模型
-- **Volces**: `volcesSeed3d`
-
-### LLM 对话模型
-- **Google Gemini**: `googleGemini20FlashExp`, `googleGemini15Pro`, `googleGemini10Pro` 等 8 个模型
-- **Claude**: `googleClaude35Haiku`, `googleClaude35SonnetV2`
-- **Microsoft Phi**: `microsoftPhi4`, `microsoftPhi35MiniInstruct`, `microsoftPhi35MoeInstruct`
-- **SeaArt**: `seaartQwen2Vl72bInstruct`, `seaartKontext`
-
-### 图片编辑
-- **Alibaba Wanx**: 背景生成、人像修复、图片上色、高清增强、智能抠图等 10+ 个功能
-- **SeaArt**: `seaartImageEdit`, `seaartSeededit20`
-- **Volces**: `volcesSeededit30`, `volcesSeededitPortrait` 等 9 个模型
-- **Youchuan**: 修图、扩图、去背景、变体等 8 个功能
-
-完整的模型列表请查看 `src/api/index.ts`。
-
-### 使用示例
-
-```typescript
-import {
-  SeacloudClient,
-  alibabaWanx3Turbo,    // 图片生成
-  klingV26,              // 视频生成
-  googleGemini20FlashExp, // LLM 对话
-  minimaxT2a,            // 音频生成
-  tencentHunyuan3d,      // 3D 模型
-} from 'seacloud-sdk';
-
-const client = new SeacloudClient();
-
-// 生成图片
-const images = await alibabaWanx3Turbo(client, {
-  prompt: 'A cat'
-});
-
-// 生成视频
-const videos = await klingV26(client, {
-  prompt: 'A cat running'
-});
-
-// LLM 对话
-const response = await googleGemini20FlashExp(client, {
-  prompt: 'Hello, how are you?'
-});
-```
-
-## API 文档
-
-### SeacloudClient
-
-HTTP 客户端，用于与 SeaCloud 代理服务器通信。
-
-#### 构造函数
-
-```typescript
-new SeacloudClient(config?: SeacloudConfig)
-```
-
-**配置选项：**
-- `apiKey?: string` - API Token（默认从环境变量 `API_SERVICE_TOKEN` 读取）
-- `baseUrl?: string` - 代理服务器地址（默认 `http://localhost:8080`）
-- `fetch?: typeof fetch` - 自定义 fetch 实现（可选）
-- `timeout?: number` - 请求超时时间（毫秒，默认 30000）
-
-#### 方法
-
-**createTask(endpoint, body)**
-
-创建新任务。
-
-```typescript
-const task = await client.createTask('/model/tasks', {
-  model: 'alibaba_wanx_3_turbo',
-  input: { prompt: 'A sunset' },
-});
-```
-
-**getTaskStatus(endpoint, taskId)**
-
-查询任务状态。
-
-```typescript
-const status = await client.getTaskStatus('/model/tasks', taskId);
-```
-
-### 轮询函数
-
-**pollTaskUntilComplete(client, endpoint, taskId, options?)**
-
-轮询任务直到完成或失败。
-
-```typescript
-const result = await pollTaskUntilComplete(
-  client,
-  '/model/tasks',
-  taskId,
-  {
-    intervalMs: 3000,      // 轮询间隔（毫秒）
-    maxAttempts: 120,      // 最大尝试次数
-    onProgress: (attempt, status) => {
-      console.log(`尝试 ${attempt}: ${status}`);
-    },
-  },
-);
-```
-
-**createAndWaitTask(client, endpoint, body, options?)**
-
-创建任务并自动轮询直到完成。
-
-```typescript
-const result = await createAndWaitTask(
-  client,
-  '/model/tasks',
-  { model: 'alibaba_wanx_3_turbo', input: { prompt: 'A sunset' } },
-  { intervalMs: 2000 },
-);
-```
-
-## 类型定义
-
-### TaskResult
-
-```typescript
-interface TaskResult {
-  id: string;
-  created_at: number;
-  status: 'pending' | 'processing' | 'in_progress' | 'completed' | 'failed';
-  error?: TaskError | null;
-  model: string;
-  output?: Array<{
-    content?: Array<{
-      type?: string;
-      url?: string;
-      size?: number;
-      jobId?: string;
-    }>;
-  }>;
-}
-```
-
-### SeacloudError
-
-自定义错误类，包含状态码和响应信息。
-
-```typescript
-class SeacloudError extends Error {
-  statusCode?: number;
-  response?: any;
-}
-```
-
-## 使用示例
-
-查看 `examples/` 目录获取更多使用示例：
-
-- **basic.ts** - 基本使用示例，演示 `createAndWaitTask`
-- **manual-polling.ts** - 手动轮询示例，演示任务创建和状态查询
-
-运行示例：
-
-```bash
-# 设置环境变量
-export API_SERVICE_TOKEN=your-token
-
-# 运行示例（需要先启动代理服务器）
-node examples/basic.js
-```
-
-## 开发
-
-```bash
-# 安装依赖
-npm install
-
-# 构建
-npm run build
-
-# 开发模式（监听文件变化）
-npm run dev
-
-# 清理构建
-npm run clean
-```
-
-## 路线图
-
-- [x] 核心 HTTP 客户端
-- [x] 任务轮询机制
-- [x] TypeScript 类型定义
-- [x] API 模型转换（195 个模型）✅
-- [ ] 浏览器环境测试
-- [ ] 单元测试
-- [ ] API 文档生成
-
-## 相关项目
-
-- [seacloud-cli](https://github.com/seaverse/seacloud-cli) - Rust 版本的命令行工具
-- [seacloud-proxy](https://github.com/seaverse/seacloud-proxy) - Go 代理服务器
-
-## License
-
-MIT