openclaw · yys2024 · Mar 10, 2026
diff --git a/skills/yys2024/creaa-ai/SKILL.md b/skills/yys2024/creaa-ai/SKILL.md
@@ -0,0 +1,215 @@
+---
+name: creaa-ai
+description: Creaa AI - Generate images and videos via Creaa.ai API. Text-to-image, text-to-video, image-to-video with multiple AI models.
+user-invocable: true
+homepage: https://creaa.ai
+---
+metadata: {"openclaw":{"requires":{"env":["CREAA_API_KEY"]},"primaryEnv":"CREAA_API_KEY"}}
+
+# Creaa AI - Image & Video Generation
+
+Generate high-quality AI images and videos directly from your terminal using the Creaa API.
+
+Get your API key at: https://creaa.ai/profile -> API Keys
+
+## Available Models
+
+### Image Models
+
+| Model ID | Name | Credits/Image | Default Ratio | Capabilities |
+|----------|------|--------------|---------------|-------------|
+| `seedream-4.5` | Seedream 4.5 | 4 | 1:1 | text_to_image, image_to_image |
+| `nano-banana-2` | Nano Banana 2 | 10 | auto | text_to_image, image_to_image, multi_image_edit |
+| `nano-banana-pro` | Nano Banana Pro | 20 | auto | text_to_image, image_to_image, multi_image_edit |
+| `gpt-image-1.5` | GPT Image 1.5 | 15 | 1:1 | text_to_image, image_to_image |
+| `z-image-turbo` | Z-Image Turbo | 1 | 1:1 | text_to_image |
+
+**Aspect ratio options per model:**
+- `seedream-4.5`: 1:1, 16:9, 9:16, 4:3, 3:4
+- `nano-banana-2` / `nano-banana-pro`: auto, 1:1, 9:16, 16:9, 3:2, 2:3
+- `gpt-image-1.5`: 1:1, 3:2, 2:3
+- `z-image-turbo`: 1:1, 9:16, 16:9
+
+### Video Models
+
+| Model ID | Name | Credits/sec | Durations (sec) | Default Duration | Capabilities |
+|----------|------|------------|-----------------|-----------------|-------------|
+| `veo-3.1` | Veo 3.1 | 30 | 8 | 8 | text_to_video, image_to_video |
+| `seedance-2.0` | Seedance 2.0 | 25 | 5, 10, 15 | 5 | text_to_video, image_to_video |
+| `sora-2-pro` | Sora 2 Pro | 18 | 4, 8, 12 | 12 | text_to_video, image_to_video |
+| `seedance-1.5-pro` | Seedance 1.5 Pro | 20 | 5, 8, 12 | 5 | text_to_video, image_to_video, first_last_frame |
+| `kling-3.0` | Kling 3.0 | 32 | 5, 10, 15 | 5 | text_to_video, image_to_video |
+| `hailuo-2.3` | Hailuo 2.3 | 25 | 6, 10 | 6 | text_to_video, image_to_video |
+| `runway-gen-4.5` | Runway Gen-4.5 | 30 | 5, 10 | 5 | image_to_video |
+| `sora-2` | Sora 2 | 10 | 10, 15 | 15 | text_to_video, image_to_video |
+
+**Aspect ratio options per model:**
+- `veo-3.1`: 16:9, 9:16
+- `seedance-2.0`: 9:16, 16:9, 1:1, 3:4, 4:3
+- `sora-2-pro`: 9:16, 16:9
+- `seedance-1.5-pro`: 9:16, 16:9, 1:1, 3:4, 4:3
+- `kling-3.0`: 16:9, 9:16
+- `hailuo-2.3`: 9:16, 16:9
+- `runway-gen-4.5`: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9
+- `sora-2`: 9:16, 16:9
+
+## Available Commands
+
+All generation tasks are asynchronous: submit a task, get a task_id, then poll for results.
+
+### Generate Image
+
+**Step 1: Submit task**
+```bash
+curl -s -X POST "https://creaa.ai/api/open/v1/images/generate" \
+  -H "Authorization: Bearer $CREAA_API_KEY" \
+  -H "Content-Type: application/json" \
+  -H "X-Source: openclaw" \
+  -d '{
+    "prompt": "<user prompt here>",
+    "model": "<model_id>",
+    "aspect_ratio": "<ratio>",
+    "n": <count>
+  }'
+```
+
+**Parameters:**
+- `prompt` (required): Image description
+- `model` (optional): Model ID from the image models table above. Default: `seedream-4.5`
+- `aspect_ratio` (optional): Aspect ratio like `1:1`, `16:9`, `9:16`. Must match the model's supported ratios. Default varies by model.
+- `n` (optional): Number of images, 1-4. Default 1
+
+**Response:**
+```json
+{
+  "success": true,
+  "task_id": "abc123-def456",
+  "task_type": "image",
+  "model": "seedream-4.5"
+}
+```
+
+**Step 2: Poll status** (wait 5-10 seconds between polls for images)
+```bash
+curl -s "https://creaa.ai/api/open/v1/tasks/<task_id>" \
+  -H "Authorization: Bearer $CREAA_API_KEY" \
+  -H "X-Source: openclaw"
+```
+
+**Status Response (completed):**
+```json
+{
+  "success": true,
+  "task_id": "abc123-def456",
+  "status": "completed",
+  "progress": 1.0,
+  "result_url": "https://...",
+  "result_urls": ["https://...", "https://..."]
+}
+```
+
+Image generation typically takes 10-60 seconds. Poll every 5 seconds.
+
+### Generate Video
+
+**Step 1: Submit task**
+```bash
+curl -s -X POST "https://creaa.ai/api/open/v1/videos/generate" \
+  -H "Authorization: Bearer $CREAA_API_KEY" \
+  -H "Content-Type: application/json" \
+  -H "X-Source: openclaw" \
+  -d '{
+    "prompt": "<user prompt here>",
+    "model": "<model_id>",
+    "mode": "<text_to_video|image_to_video>",
+    "duration": <seconds>,
+    "aspect_ratio": "<ratio>"
+  }'
+```
+
+**Parameters:**
+- `prompt` (required): Video description
+- `model` (optional): Model ID from the video models table above. Default: `veo-3.1`
+- `mode` (optional): `text_to_video` (default) or `image_to_video`
+- `image_url` (required for image_to_video): URL of the source image
+- `duration` (optional): Duration in seconds, must match the model's supported durations. Default varies by model.
+- `aspect_ratio` (optional): e.g. `16:9`, `9:16`, `1:1`. Must match the model's supported ratios.
+
+**Response:**
+```json
+{
+  "success": true,
+  "task_id": "abc123-def456",
+  "task_type": "video",
+  "model": "veo-3.1"
+}
+```
+
+**Step 2: Poll status** (wait 15 seconds between polls for videos)
+```bash
+curl -s "https://creaa.ai/api/open/v1/tasks/<task_id>" \
+  -H "Authorization: Bearer $CREAA_API_KEY" \
+  -H "X-Source: openclaw"
+```
+
+**Status Response (completed):**
+```json
+{
+  "success": true,
+  "task_id": "abc123-def456",
+  "status": "completed",
+  "progress": 1.0,
+  "result_url": "https://..."
+}
+```
+
+Status values: `pending` -> `processing` -> `completed` or `failed`.
+Video generation typically takes 60-300 seconds. Poll every 15 seconds.
+
+### Unified Task Status Endpoint
+Both image and video tasks use the same status endpoint:
+```bash
+curl -s "https://creaa.ai/api/open/v1/tasks/<task_id>" \
+  -H "Authorization: Bearer $CREAA_API_KEY" \
+  -H "X-Source: openclaw"
+```
+
+Keep polling until `status` is `completed` or `failed`.
+- For images: poll every 5 seconds
+- For videos: poll every 15 seconds
+
+### List Available Models
+```bash
+curl -s "https://creaa.ai/api/open/v1/models" \
+  -H "Authorization: Bearer $CREAA_API_KEY" \
+  -H "X-Source: openclaw"
+```
+
+Returns full model catalog with pricing, supported aspect ratios/durations, and capabilities.
+
+### Check Usage
+```bash
+curl -s "https://creaa.ai/api/open/v1/usage" \
+  -H "Authorization: Bearer $CREAA_API_KEY" \
+  -H "X-Source: openclaw"
+```
+
+## Model Selection Tips
+
+**Image models:**
+- `seedream-4.5` - Best quality, great default choice
+- `nano-banana-2` - Multi-image editing support
+- `z-image-turbo` - Cheapest at 1 credit, fastest generation
+
+**Video models:**
+- `veo-3.1` - Highest quality, 8s fixed duration
+- `sora-2` - Most affordable at 10 credits/sec
+- `sora-2-pro` - Good balance of quality and cost
+- `runway-gen-4.5` - Image-to-video only, high quality
+
+## Error Handling
+
+If any API call returns `"success": false`, display the error message to the user. Common errors:
+- `invalid_api_key`: The API key is missing or wrong. User should check their key at https://creaa.ai/profile
+- `rate_limit_exceeded`: Too many requests per minute. Wait and retry.
+- `Insufficient credits`: Not enough credits. User should top up at https://creaa.ai/pricing