@unityclaw/skills 1.0.5 → 1.0.8

package/unityclaw-video-generation-other/SKILL.md

@@ -1,324 +0,0 @@
----
-name: unityclaw-video-generation-other
-description: Generate videos using Doubao, Wan (Alibaba), MiniMax, and JiMeng models
-version: 1.0.1
-metadata:
-  openclaw:
-    requires:
-      env:
-        - UNITYCLAW_API_KEY
-      bins:
-        - node
-        - npm
-    primaryEnv: UNITYCLAW_API_KEY
-    emoji: "🎞️"
-    homepage: https://unityclaw.com
-    install:
-      - kind: node
-        package: "@unityclaw/sdk"
-        bins: []
----
-
-# UnityClaw Video Generation - Other Models
-
-Generate videos using multiple AI models: Doubao, Wan (Alibaba), MiniMax, and JiMeng.
-
-## Installation
-
-```bash
-npm install @unityclaw/sdk
-```
-
-## Configuration
-
-Set your API key using one of these methods:
-
-```bash
-# Method 1: Use SDK CLI (recommended - persists across sessions)
-npx @unityclaw/sdk config set apiKey your-api-key
-
-# Method 2: Environment variable
-export UNITYCLAW_API_KEY=your-api-key
-```
-
-## Response Structure
-
-> **IMPORTANT:** The result has a nested structure. Use `result.success` to check overall success, and access data via `result.response.data`.
-
-```typescript
-interface UnityClawResult {
-  success: boolean;        // ✅ Use this to check if SDK call succeeded
-  taskId: string;          // Task identifier
-  taskFolder: string;      // Path to task folder with logs
-  duration: number;        // Request duration in ms
-  response: {              // API response object
-    code: number;          // 0 = success
-    data: Array<{          // ✅ Result data here
-      name: string;
-      contentType: string;
-      content: string;     // URL to generated video
-    }> | null;
-  };
-  logs: Array<{ timestamp; level; message }>;
-  attachments: any[];
-}
-```
-
-## Quick Start
-
-```typescript
-import { UnityClawClient } from '@unityclaw/sdk';
-
-const client = new UnityClawClient();
-
-// Using Doubao
-const result = await client.video.doubao({
-  prompt: 'A cinematic drone shot of mountains',
-  resolution: { value: '1080p', label: '1080p' },
-  ratio: { value: '16:9', label: '16:9' }
-});
-
-// ✅ Correct: Check result.success, access data via result.response.data
-if (result.success && result.response?.data) {
-  console.log('Generated video:', result.response.data);
-}
-```
-
-## Available APIs
-
-### 1. Doubao Video
-
-```typescript
-const result = await client.video.doubao({
-  prompt: 'A cinematic drone shot of mountains at golden hour',
-  resolution: { value: '1080p', label: '1080p' },
-  ratio: { value: '16:9', label: '16:9' },
-  duration: { value: '5', label: '5s' }
-});
-```
-
-**Parameters:**
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `prompt` | `string \| TextFieldItem[]` | No | Text description |
-| `attachment` | `AttachmentFieldItem[]` | No | Reference image |
-| `action` | `LabelFieldItem \| string` | No | Action type |
-| `resolution` | `LabelFieldItem \| string` | Yes | Video resolution |
-| `ratio` | `LabelFieldItem \| string` | Yes | Aspect ratio |
-| `duration` | `LabelFieldItem \| string` | No | Video duration |
-
-### 2. Wan Video (Alibaba)
-
-```typescript
-const result = await client.video.wan({
-  prompt: 'A futuristic city at night with neon lights',
-  size: { value: '1280*720', label: '720p' },
-  duration: { value: '5', label: '5s' },
-  model: { value: 'wan2.6-t2v', label: 'Wan 2.6' }
-});
-```
-
-**Parameters:**
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `prompt` | `string \| TextFieldItem[]` | No | Text description |
-| `attachment` | `AttachmentFieldItem[]` | No | Reference image |
-| `size` | `LabelFieldItem \| string` | No | Video size (e.g., '1280*720') |
-| `duration` | `LabelFieldItem \| string` | No | Video duration |
-| `model` | `LabelFieldItem \| string` | No | Model version |
-| `shot_type` | `LabelFieldItem \| string` | No | Camera shot type |
-
-### 3. MiniMax Video
-
-```typescript
-const result = await client.video.minimax({
-  prompt: 'A person walking through a serene forest',
-  size: { value: '1360*768', label: '768p' },
-  model: { value: 'MiniMax-Hailuo-2.3', label: 'Hailuo 2.3' }
-});
-```
-
-**Parameters:**
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `prompt` | `string \| TextFieldItem[]` | No | Text description |
-| `attachment` | `AttachmentFieldItem[]` | No | Reference image |
-| `size` | `LabelFieldItem \| string` | No | Video size |
-| `duration` | `LabelFieldItem \| string` | No | Video duration |
-| `model` | `LabelFieldItem \| string` | No | Model version |
-
-### 4. JiMeng Video
-
-```typescript
-const result = await client.video.jimeng({
-  action: { value: 't2v', label: 'Text to Video' },
-  prompt: 'A beautiful landscape with flowing river',
-  aspect_ratio: { value: '16:9', label: '16:9' }
-});
-```
-
-**Parameters:**
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `action` | `LabelFieldItem \| string` | Yes | Action type ('t2v' for text-to-video) |
-| `prompt` | `string \| TextFieldItem[]` | No | Text description |
-| `attachment` | `AttachmentFieldItem[]` | No | Reference image |
-| `aspect_ratio` | `LabelFieldItem \| string` | Yes | Aspect ratio |
-
-## Examples
-
-### Doubao - Text-to-Video
-
-```typescript
-const client = new UnityClawClient();
-
-const result = await client.video.doubao({
-  prompt: 'A luxury car driving along a coastal road at sunset',
-  resolution: { value: '1080p', label: '1080p' },
-  ratio: { value: '16:9', label: '16:9' },
-  duration: { value: '5', label: '5s' }
-});
-```
-
-### Doubao - Image-to-Video
-
-```typescript
-const result = await client.video.doubao({
-  action: { value: 'i2v', label: 'Image to Video' },
-  attachment: [
-    { tmp_url: 'https://example.com/image.jpg', name: 'image.jpg' }
-  ],
-  prompt: 'Animate this image with gentle movement',
-  resolution: { value: '1080p', label: '1080p' },
-  ratio: { value: '16:9', label: '16:9' }
-});
-```
-
-### Wan - High Quality
-
-```typescript
-const result = await client.video.wan({
-  prompt: 'A samurai walking through cherry blossom petals falling',
-  size: { value: '1920*1080', label: '1080p' },
-  duration: { value: '5', label: '5s' },
-  model: { value: 'wan2.6-t2v', label: 'Wan 2.6' },
-  shot_type: { value: 'cinematic', label: 'Cinematic' }
-});
-```
-
-### MiniMax - Portrait Video
-
-```typescript
-const result = await client.video.minimax({
-  prompt: 'A dancer performing an elegant routine',
-  size: { value: '768*1360', label: 'Portrait 768p' },
-  model: { value: 'MiniMax-Hailuo-2.3', label: 'Hailuo 2.3' }
-});
-```
-
-### JiMeng - Chinese Prompt
-
-```typescript
-const result = await client.video.jimeng({
-  action: { value: 't2v', label: 'Text to Video' },
-  prompt: '一只可爱的熊猫在竹林里吃竹子',
-  aspect_ratio: { value: '16:9', label: '16:9' }
-});
-```
-
-### Compare Multiple Models
-
-```typescript
-const prompt = 'A serene mountain lake at sunrise';
-
-const results = await Promise.all([
-  client.video.doubao({
-    prompt,
-    resolution: '1080p',
-    ratio: '16:9'
-  }),
-  client.video.wan({
-    prompt,
-    size: '1280*720'
-  }),
-  client.video.minimax({
-    prompt,
-    size: '1360*768'
-  })
-]);
-
-results.forEach((result, i) => {
-  const model = ['Doubao', 'Wan', 'MiniMax'][i];
-  if (result.success && result.response?.data) {
-    console.log(`${model}: ${result.response.data?.[0]?.content}`);
-  }
-});
-```
-
-## Model Comparison
-
-| Model | Strengths | Best For |
-|-------|-----------|----------|
-| Doubao | High quality, Chinese prompts | General purpose, Chinese content |
-| Wan | Multiple shot types | Cinematic videos |
-| MiniMax | Fast generation | Quick iterations |
-| JiMeng | Chinese language | Chinese content |
-
-## Response Format
-
-```typescript
-interface AttachmentResult {
-  name: string;
-  contentType: 'attachment/url';
-  content: string;  // URL to generated video
-}
-```
-
-## Error Handling
-
-```typescript
-const result = await client.video.doubao({
-  prompt: 'test',
-  resolution: '1080p',
-  ratio: '16:9'
-});
-
-if (!result.success) {
-  console.error('Request failed');
-  console.log('Check logs:', result.logs);
-  return;
-}
-
-if (result.response?.code !== 0) {
-  console.error('API error:', result.response);
-  return;
-}
-
-// Success
-console.log('Success:', result.response.data);
-```
-
-## Task Folders
-
-Each execution creates a task folder:
-
-```typescript
-const result = await client.video.wan({
-  prompt: 'test',
-  size: '1280*720'
-});
-
-console.log('Task ID:', result.taskId);
-console.log('Task Folder:', result.taskFolder);
-console.log('Videos:', result.attachments);
-```
-
-## Related Skills
-
-- [unityclaw-video-generation-sora](../unityclaw-video-generation-sora/SKILL.md) - OpenAI Sora
-- [unityclaw-video-generation-veo](../unityclaw-video-generation-veo/SKILL.md) - Google Veo
-- [unityclaw-video-generation-kling](../unityclaw-video-generation-kling/SKILL.md) - Kling

package/unityclaw-video-generation-sora/SKILL.md

@@ -1,286 +0,0 @@
----
-name: unityclaw-video-generation-sora
-description: Generate cinematic videos using OpenAI Sora AI model
-version: 1.0.1
-metadata:
-  openclaw:
-    requires:
-      env:
-        - UNITYCLAW_API_KEY
-      bins:
-        - node
-        - npm
-    primaryEnv: UNITYCLAW_API_KEY
-    emoji: "🎬"
-    homepage: https://unityclaw.com
-    install:
-      - kind: node
-        package: "@unityclaw/sdk"
-        bins: []
----
-
-# UnityClaw Video Generation - Sora
-
-Generate cinematic videos using OpenAI's Sora AI model.
-
-## Installation
-
-```bash
-npm install @unityclaw/sdk
-```
-
-## Configuration
-
-Set your API key using one of these methods:
-
-```bash
-# Method 1: Use SDK CLI (recommended - persists across sessions)
-npx @unityclaw/sdk config set apiKey your-api-key
-
-# Method 2: Environment variable
-export UNITYCLAW_API_KEY=your-api-key
-```
-
-## Response Structure
-
-> **IMPORTANT:** The result has a nested structure. Use `result.success` to check overall success, and access data via `result.response.data`.
-
-```typescript
-interface UnityClawResult {
-  success: boolean;        // ✅ Use this to check if SDK call succeeded
-  taskId: string;          // Task identifier
-  taskFolder: string;      // Path to task folder with logs
-  duration: number;        // Request duration in ms
-  response: {              // API response object
-    code: number;          // 0 = success
-    data: Array<{          // ✅ Result data here
-      name: string;
-      contentType: string;
-      content: string;     // URL to generated video
-    }> | null;
-  };
-  logs: Array<{ timestamp; level; message }>;
-  attachments: any[];
-}
-```
-
-## Quick Start
-
-```typescript
-import { UnityClawClient } from '@unityclaw/sdk';
-
-const client = new UnityClawClient();
-
-const result = await client.video.sora({
-  prompt: 'A cat playing piano in a cozy living room',
-  orientation: { value: 'landscape', label: 'Landscape' }
-});
-
-// ✅ Correct: Check result.success, access data via result.response.data
-if (result.success && result.response?.data) {
-  console.log('Generated video:', result.response.data);
-}
-```
-
-## Available APIs
-
-### Sora Video Generation
-
-```typescript
-// Basic usage
-const result = await client.video.sora({
-  prompt: 'A drone shot flying over snowy mountains',
-  orientation: { value: 'landscape', label: 'Landscape' }
-});
-
-// With reference image
-const result = await client.video.sora({
-  prompt: 'Animate this scene with gentle movement',
-  attachment: [{ tmp_url: 'https://...', name: 'scene.jpg' }],
-  orientation: { value: 'portrait', label: 'Portrait' }
-});
-```
-
-### Sora Stable Video Generation
-
-```typescript
-// With duration and size control
-const result = await client.video.soraStable({
-  prompt: 'A peaceful ocean wave at sunset',
-  size: { value: '1920x1080', label: '1080p' },
-  seconds: { value: '10', label: '10s' }
-});
-
-// Image-to-video
-const result = await client.video.soraStable({
-  attachment: [{ tmp_url: 'https://...', name: 'image.jpg' }],
-  prompt: 'Bring this image to life',
-  size: { value: '1280x720', label: '720p' },
-  seconds: { value: '5', label: '5s' }
-});
-```
-
-## Parameter Types
-
-### SoraVideoParams
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `prompt` | `string \| TextFieldItem[]` | No | Text description of the video |
-| `attachment` | `AttachmentFieldItem[]` | No | Reference image for image-to-video |
-| `orientation` | `LabelFieldItem` | Yes | Video orientation |
-
-### SoraStableParams
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `prompt` | `string \| TextFieldItem[]` | No | Text description |
-| `attachment` | `AttachmentFieldItem[]` | No | Reference image |
-| `size` | `LabelFieldItem` | No | Video resolution |
-| `seconds` | `LabelFieldItem` | No | Video duration |
-
-## Examples
-
-### Text-to-Video
-
-```typescript
-const client = new UnityClawClient();
-
-const result = await client.video.sora({
-  prompt: 'A cinematic drone shot flying through a futuristic neon-lit city at night, with flying cars and holographic billboards',
-  orientation: { value: 'landscape', label: 'Landscape' }
-});
-
-if (result.success && result.response?.data) {
-  console.log('Video URL:', result.response.data[0].content);
-}
-```
-
-### Image-to-Video
-
-```typescript
-const result = await client.video.sora({
-  prompt: 'Animate this image with subtle camera movement and parallax effect',
-  attachment: [
-    { tmp_url: 'https://example.com/landscape.jpg', name: 'landscape.jpg' }
-  ],
-  orientation: { value: 'landscape', label: 'Landscape' }
-});
-```
-
-### Long Duration Video
-
-```typescript
-const result = await client.video.soraStable({
-  prompt: 'A time-lapse of a flower blooming in a garden',
-  size: { value: '1920x1080', label: '1080p Landscape' },
-  seconds: { value: '15', label: '15s' }
-});
-```
-
-### Portrait Video for Social Media
-
-```typescript
-const result = await client.video.sora({
-  prompt: 'A person walking through a misty forest with sunlight filtering through the trees',
-  orientation: { value: 'portrait', label: 'Portrait' }
-});
-```
-
-### Batch Generation
-
-```typescript
-const prompts = [
-  'A serene beach at golden hour with waves gently rolling',
-  'A busy Tokyo street crossing at night with neon signs',
-  'An astronaut floating in space with Earth in the background'
-];
-
-const results = await Promise.all(
-  prompts.map(prompt => client.video.sora({
-    prompt,
-    orientation: { value: 'landscape', label: 'Landscape' }
-  }))
-);
-
-results.forEach((result, i) => {
-  if (result.success && result.response?.data) {
-    console.log(`Video ${i + 1}: ${result.response.data?.[0]?.content}`);
-  }
-});
-```
-
-## Orientation Options
-
-| Value | Label | Aspect Ratio | Use Case |
-|-------|-------|--------------|----------|
-| `landscape` | Landscape | 16:9 | YouTube, presentations |
-| `portrait` | Portrait | 9:16 | TikTok, Instagram Reels |
-| `square` | Square | 1:1 | Instagram feed |
-
-## Response Format
-
-```typescript
-interface AttachmentResult {
-  name: string;
-  contentType: 'attachment/url';
-  content: string;  // URL to generated video
-}
-
-interface APIResponse<AttachmentResult[]> {
-  code: number;
-  msg?: string;
-  data?: AttachmentResult[];
-}
-```
-
-## Error Handling
-
-```typescript
-const result = await client.video.sora({
-  prompt: 'A test video',
-  orientation: { value: 'landscape', label: 'Landscape' }
-});
-
-if (!result.success) {
-  console.error('Request failed');
-  console.log('Check logs:', result.logs);
-  return;
-}
-
-if (result.response?.code !== 0) {
-  console.error('API error:', result.response);
-  return;
-}
-
-// Success
-console.log('Success:', result.response.data);
-```
-
-## Task Folders
-
-Each execution creates a task folder:
-
-```typescript
-const result = await client.video.sora({
-  prompt: 'test',
-  orientation: { value: 'landscape', label: 'Landscape' }
-});
-
-console.log('Task ID:', result.taskId);
-console.log('Task Folder:', result.taskFolder);
-console.log('Downloaded Videos:', result.attachments);
-```
-
-## Best Practices
-
-1. **Detailed Prompts**: Include camera angles, lighting, and movement descriptions
-2. **Reference Images**: Use high-quality images for image-to-video
-3. **Orientation**: Match orientation to target platform
-4. **Duration**: Use `soraStable` for precise duration control
-
-## Related Skills
-
-- [unityclaw-video-generation-veo](../unityclaw-video-generation-veo/SKILL.md) - Google Veo video generation
-- [unityclaw-video-generation-kling](../unityclaw-video-generation-kling/SKILL.md) - Kling video generation
-- [unityclaw-image-generation](../unityclaw-image-generation/SKILL.md) - Generate reference images