diff --git a/skills/yys2024/creaa-ai/SKILL.md b/skills/yys2024/creaa-ai/SKILL.md new file mode 100644 index 00000000000..66edcaa53db --- /dev/null +++ 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": "", + "model": "", + "aspect_ratio": "", + "n": + }' +``` + +**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/" \ + -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": "", + "model": "", + "mode": "", + "duration": , + "aspect_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/" \ + -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/" \ + -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