@acedatacloud/skills 2026.504.2 → 2026.504.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acedatacloud/skills",
-  "version": "2026.504.2",
+  "version": "2026.504.4",
   "description": "Agent Skills for AceDataCloud AI services — music, image, video generation, LLM chat, web search. Compatible with Claude Code, GitHub Copilot, Gemini CLI, OpenAI Codex, and 30+ AI coding agents.",
   "keywords": [
     "agent-skills",

package/skills/kling-video/SKILL.md

@@ -44,6 +44,7 @@ curl -X POST https://api.acedata.cloud/kling/videos \
 |------|-------|------|---------|
 | `std` (Standard) | Slower | Lower | Draft/preview |
 | `pro` (Professional) | Faster | Higher | Final output |
+| `4k` (Native 4K) | — | Premium | Native 4K output — only `kling-v3` and `kling-v3-omni`; incompatible with `camera_control` |
 
 ## Workflows
 
@@ -109,7 +110,7 @@ POST /kling/motion
 |-----------|--------|-------------|
 | `action` | `"text2video"`, `"image2video"`, `"extend"` | Generation mode |
 | `model` | See models table | Model to use |
-| `mode` | `"std"`, `"pro"` | Quality mode |
+| `mode` | `"std"`, `"pro"`, `"4k"` | Quality mode (`4k` only for `kling-v3` / `kling-v3-omni`, incompatible with `camera_control`) |
 | `duration` | `5`, `10` (v3/v3-omni: `3`–`15`) | Duration in seconds |
 | `generate_audio` | `true`, `false` | Generate audio with video (v3, v3-omni, v2-6 pro only) |
 | `aspect_ratio` | `"16:9"`, `"9:16"`, `"1:1"` | Video aspect ratio |
@@ -123,6 +124,7 @@ POST /kling/motion
 ## Gotchas
 
 - `duration` supports `5` or `10` seconds for most models; `kling-v3` and `kling-v3-omni` support flexible `3`–`15` seconds
+- `mode=4k` is only available for `kling-v3` and `kling-v3-omni` and is incompatible with `camera_control`
 - `generate_audio` enables synchronized audio generation (supported by `kling-v3`, `kling-v3-omni`, and `kling-v2-6` in pro mode)
 - `end_image_url` is only for `image2video` action — it defines the last frame
 - Motion control (`/kling/motion`) is a separate endpoint from video generation

package/skills/midjourney-image/SKILL.md

@@ -153,7 +153,7 @@ These top-level fields on `POST /midjourney/imagine` affect billing and are sepa
 |-----------|------|-------------|
 | `version` | string | Midjourney version (`"8"`, `"7"`, `"6.1"`, etc.) — used for billing calculation |
 | `hd` | boolean | Enable HD 2K resolution (V8 only) — costs 4× GPU time |
-| `quality` | string | Quality level: `".25"`, `".5"`, `"1"`, `"2"`, `"4"` — quality `"4"` is V8 only and costs 16× GPU time |
+| `quality` | string | Quality level: `".25"`, `".5"`, `"1"`, `"2"`, `"4"` — quality `"4"` is V8 only and costs 4× GPU time |
 | `style_reference` | boolean | Whether prompt uses `--sref` style references (V8: costs 4× GPU time) |
 | `moodboard` | boolean | Whether prompt uses moodboard image references (V8: costs 4× GPU time) |
 

package/skills/veo-video/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: veo-video
-description: Generate AI videos with Google Veo via AceDataCloud API. Use when creating videos from text descriptions, animating still images into video, or upscaling to 1080p. Supports Veo 2, Veo 3, and Veo 3.1 models including fast variants.
+description: Generate AI videos with Google Veo via AceDataCloud API. Use when creating videos from text descriptions, animating still images into video, upscaling/extending videos, re-shooting with new camera motion, or inserting/removing objects. Supports Veo 2, Veo 3, and Veo 3.1 models including fast variants.
 license: Apache-2.0
 metadata:
   author: acedatacloud
@@ -74,7 +74,23 @@ POST /veo/videos
 }
 ```
 
-### 3. Upscale to 1080p
+### 3. Ingredients-to-Video (Multi-Image Blend)
+
+Blend 1–3 reference images into a video (only `veo31-fast-ingredients`).
+
+```json
+POST /veo/videos
+{
+  "action": "ingredients2video",
+  "image_urls": [
+    "https://example.com/img1.jpg",
+    "https://example.com/img2.jpg"
+  ],
+  "model": "veo31-fast-ingredients"
+}
+```
+
+### 4. Upscale to 1080p
 
 Convert a previously generated video to full 1080p resolution.
 
@@ -91,22 +107,113 @@ POST /veo/videos
 
 | Parameter | Values | Description |
 |-----------|--------|-------------|
-| `action` | `"text2video"`, `"image2video"`, `"get1080p"` | Generation mode |
+| `action` | `"text2video"`, `"image2video"`, `"ingredients2video"`, `"get1080p"` | Generation mode |
 | `model` | see Models table | Model to use (default: `veo2-fast`) |
 | `resolution` | `"4k"`, `"1080p"`, `"gif"` | Output resolution (default: 720p) |
 | `aspect_ratio` | `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, `"3:4"` | Aspect ratio — only valid for `image2video` |
-| `image_urls` | array of strings | Reference image URLs — only for `image2video` |
+| `image_urls` | array of strings | Reference image URLs — for `image2video` (up to 2) or `ingredients2video` (up to 3) |
 | `video_id` | string | Video to upscale — only for `get1080p` |
 | `translation` | `true` / `false` | Auto-translate prompt to English (default: false) |
 
+## Post-Generation Endpoints
+
+After generating a video, use these endpoints to further process it:
+
+### Upsample (`POST /veo/upsample`)
+
+Upscale a generated video to 1080p, 4K, or convert to GIF.
+
+```json
+POST /veo/upsample
+{
+  "video_id": "your-video-id",
+  "action": "4k"
+}
+```
+
+| Parameter | Values | Description |
+|-----------|--------|-------------|
+| `video_id` | string | Task ID from `/veo/videos`, `/veo/extend`, `/veo/reshoot`, or `/veo/objects` |
+| `action` | `"1080p"`, `"4k"`, `"gif"` | Upsample target |
+
+### Extend (`POST /veo/extend`)
+
+Continue an existing video — AI auto-generates the next segment.
+
+```json
+POST /veo/extend
+{
+  "video_id": "your-video-id",
+  "model": "veo31-fast",
+  "prompt": "the camera slowly zooms out"
+}
+```
+
+| Parameter | Values | Description |
+|-----------|--------|-------------|
+| `video_id` | string | Task ID from `/veo/videos` or a prior `/veo/extend` |
+| `model` | `"veo31-fast"`, `"veo31"` | Only Veo 3.1 series is supported |
+| `prompt` | string | Optional: guides the extended segment |
+
+### Reshoot (`POST /veo/reshoot`)
+
+Re-render a video keeping the same content but applying new camera motion.
+
+```json
+POST /veo/reshoot
+{
+  "video_id": "your-video-id",
+  "motion_type": "LEFT_TO_RIGHT"
+}
+```
+
+| Parameter | Values | Description |
+|-----------|--------|-------------|
+| `video_id` | string | Task ID from `/veo/videos` (cannot use `/veo/extend` output) |
+| `motion_type` | see table below | Camera motion to apply |
+
+**`motion_type` values:**
+`STATIONARY`, `STATIONARY_UP`, `STATIONARY_DOWN`, `STATIONARY_LEFT`, `STATIONARY_RIGHT`, `STATIONARY_DOLLY_IN_ZOOM_OUT`, `STATIONARY_DOLLY_OUT_ZOOM_IN`, `UP`, `DOWN`, `LEFT_TO_RIGHT`, `RIGHT_TO_LEFT`, `FORWARD`, `BACKWARD`, `DOLLY_IN_ZOOM_OUT`, `DOLLY_OUT_ZOOM_IN`
+
+### Objects (`POST /veo/objects`)
+
+Insert or remove objects in a video using mask-based inpainting.
+
+```json
+POST /veo/objects
+{
+  "video_id": "your-video-id",
+  "action": "insert",
+  "prompt": "add a flying bird"
+}
+```
+
+```json
+POST /veo/objects
+{
+  "video_id": "your-video-id",
+  "action": "remove",
+  "image_mask": "https://example.com/mask.jpg"
+}
+```
+
+| Parameter | Values | Description |
+|-----------|--------|-------------|
+| `video_id` | string | Task ID (cannot use `/veo/extend` output) |
+| `action` | `"insert"`, `"remove"` | Operation type |
+| `prompt` | string | Required for `insert`; optional for `remove` |
+| `image_mask` | string | URL or base64 JPEG — white pixels = target region. Required for `remove`; optional for `insert` |
+
 ## Gotchas
 
 - Veo 3 and 3.1 models generate **native audio** — `veo2`/`veo2-fast` do NOT support audio
 - The `get1080p` action uses `video_id` (from a prior generation), not a URL
 - `aspect_ratio` is **only valid** for the `image2video` action
-- `image_urls` accepts an array — pass one or more image URLs for image-to-video
+- `image_urls` accepts an array — up to 2 images for `image2video`, up to 3 for `ingredients2video`
+- `veo31-fast-ingredients` **requires** image input — it cannot do text-only generation
 - `translation: true` auto-translates Chinese or other non-English prompts before sending to Veo
 - Task polling uses `id` (not `task_id`) in the `/veo/tasks` request body
 - Task states use `"succeeded"` (not "completed") — check for this value when polling
+- `/veo/extend` output **cannot** be used as input for `/veo/reshoot` or `/veo/objects`
 
 > **MCP:** `pip install mcp-veo` | Hosted: `https://veo.mcp.acedata.cloud/mcp` | See [all MCP servers](../_shared/mcp-servers.md)