@unityclaw/skills 1.0.0

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

@@ -0,0 +1,284 @@
+---
+name: unityclaw-video-generation-other
+description: Generate videos using Doubao, Wan (Alibaba), MiniMax, and JiMeng models
+version: 1.0.0
+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 as environment variable:
+
+```bash
+export UNITYCLAW_API_KEY=your-api-key
+```
+
+## 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' }
+});
+```
+
+## 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.code === 0) {
+    console.log(`${model}: ${result.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.code !== 0) {
+  console.error('Failed:', result.msg);
+} else {
+  console.log('Success:', result.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

@@ -0,0 +1,250 @@
+---
+name: unityclaw-video-generation-sora
+description: Generate cinematic videos using OpenAI Sora AI model
+version: 1.0.0
+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 as environment variable:
+
+```bash
+export UNITYCLAW_API_KEY=your-api-key
+```
+
+## 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' }
+});
+
+if (result.code === 0) {
+  console.log('Generated video:', result.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.code === 0 && result.data) {
+  console.log('Video URL:', result.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.code === 0) {
+    console.log(`Video ${i + 1}: ${result.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.code !== 0) {
+  console.error('Video generation failed:', result.msg);
+} else {
+  console.log('Success:', result.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