gin-skills 1.0.0

package/skills/ai-asset-generator/docs/genvideo.md

@@ -0,0 +1,341 @@
+POST
+/api/v1/jobs/createTask
+Create Task
+Create a new generation task
+
+Request Parameters
+The API accepts a JSON payload with the following structure:
+
+Request Body Structure
+{
+  "model": "string",
+  "callBackUrl": "string (optional)",
+  "input": {
+    // Input parameters based on form configuration
+  }
+}
+Root Level Parameters
+model
+Required
+string
+The model name to use for generation
+
+Example:
+
+"bytedance/v1-pro-image-to-video"
+callBackUrl
+Optional
+string
+Callback URL for task completion notifications. Optional parameter. If provided, the system will send POST requests to this URL when the task completes (success or failure). If not provided, no callback notifications will be sent.
+
+Example:
+
+"https://your-domain.com/api/callback"
+Input Object Parameters
+The input object contains the following parameters based on the form configuration:
+
+input.prompt
+Required
+string
+The text prompt used to generate the video
+
+Max length: 10000 characters
+Example:
+
+"A golden retriever dashing through shallow surf at the beach, back angle camera low near waterline, splashes frozen in time, blur trails in waves and paws, afternoon sun glinting off wet fur, overcast day, dramatic clouds"
+input.image_url
+Required
+string(URL)
+The URL of the image used to generate video
+
+Please provide the URL of the uploaded file; Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB
+Example:
+
+"https://file.aiquickdraw.com/custom-page/akr/section-images/1755179021328w1nhip18.webp"
+input.resolution
+Optional
+string
+Video resolution - 480p for faster generation, 720p for balance, 1080p for higher quality
+
+Available options:
+
+480p
+-
+480p
+720p
+-
+720p
+1080p
+-
+1080p
+Example:
+
+"720p"
+input.duration
+Optional
+string
+Duration of the video in seconds
+
+Available options:
+
+5
+-
+5s
+10
+-
+10s
+Example:
+
+"5"
+input.camera_fixed
+Optional
+boolean
+Whether to fix the camera position
+
+Boolean value (true/false)
+Example:
+
+false
+input.seed
+Optional
+number
+Random seed to control video generation. Use -1 for random.
+
+Min: -1, Max: 2147483647, Step: 1
+Example:
+
+-1
+input.enable_safety_checker
+Optional
+boolean
+The safety checker is always enabled in Playground. It can only be disabled by setting false through the API.
+
+Boolean value (true/false)
+Example:
+
+true
+Request Example
+
+cURL
+
+JavaScript
+
+Python
+curl -X POST "https://api.kie.ai/api/v1/jobs/createTask" \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer YOUR_API_KEY" \
+  -d '{
+    "model": "bytedance/v1-pro-image-to-video",
+    "callBackUrl": "https://your-domain.com/api/callback",
+    "input": {
+      "prompt": "A golden retriever dashing through shallow surf at the beach, back angle camera low near waterline, splashes frozen in time, blur trails in waves and paws, afternoon sun glinting off wet fur, overcast day, dramatic clouds",
+      "image_url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1755179021328w1nhip18.webp",
+      "resolution": "720p",
+      "duration": "5",
+      "camera_fixed": false,
+      "seed": -1,
+      "enable_safety_checker": true
+    }
+}'
+Response Example
+{
+  "code": 200,
+  "message": "success",
+  "data": {
+    "taskId": "task_12345678"
+  }
+}
+Response Fields
+code
+Status code, 200 for success, others for failure
+message
+Response message, error description when failed
+data.taskId
+Task ID for querying task status
+Callback Notifications
+When you provide the callBackUrl parameter when creating a task, the system will send POST requests to the specified URL upon task completion (success or failure).
+
+Success Callback Example
+{
+    "code": 200,
+    "data": {
+        "completeTime": 1755599644000,
+        "costTime": 8,
+        "createTime": 1755599634000,
+        "model": "bytedance/v1-pro-image-to-video",
+        "param": "{\"callBackUrl\":\"https://your-domain.com/api/callback\",\"model\":\"bytedance/v1-pro-image-to-video\",\"input\":{\"prompt\":\"A golden retriever dashing through shallow surf at the beach, back angle camera low near waterline, splashes frozen in time, blur trails in waves and paws, afternoon sun glinting off wet fur, overcast day, dramatic clouds\",\"image_url\":\"https://file.aiquickdraw.com/custom-page/akr/section-images/1755179021328w1nhip18.webp\",\"resolution\":\"720p\",\"duration\":\"5\",\"camera_fixed\":false,\"seed\":-1,\"enable_safety_checker\":true}}",
+        "resultJson": "{\"resultUrls\":[\"https://example.com/generated-image.jpg\"]}",
+        "state": "success",
+        "taskId": "e989621f54392584b05867f87b160672",
+        "failCode": null,
+        "failMsg": null,
+    },
+    "msg": "Playground task completed successfully."
+}
+Failure Callback Example
+{
+    "code": 501,
+    "data": {
+        "completeTime": 1755597081000,
+        "costTime": 0,
+        "createTime": 1755596341000,
+        "failCode": "500",
+        "failMsg": "Internal server error",
+        "model": "bytedance/v1-pro-image-to-video",
+        "param": "{\"callBackUrl\":\"https://your-domain.com/api/callback\",\"model\":\"bytedance/v1-pro-image-to-video\",\"input\":{\"prompt\":\"A golden retriever dashing through shallow surf at the beach, back angle camera low near waterline, splashes frozen in time, blur trails in waves and paws, afternoon sun glinting off wet fur, overcast day, dramatic clouds\",\"image_url\":\"https://file.aiquickdraw.com/custom-page/akr/section-images/1755179021328w1nhip18.webp\",\"resolution\":\"720p\",\"duration\":\"5\",\"camera_fixed\":false,\"seed\":-1,\"enable_safety_checker\":true}}",
+        "state": "fail",
+        "taskId": "bd3a37c523149e4adf45a3ddb5faf1a8",
+        "resultJson": null,
+    },
+    "msg": "Playground task failed."
+}
+Important Notes
+The callback content structure is identical to the Query Task API response
+The param field contains the complete Create Task request parameters, not just the input section
+If callBackUrl is not provided, no callback notifications will be sent
+
+GET
+/api/v1/jobs/recordInfo
+Query Task
+Query task status and results by task ID
+
+Request Example
+
+cURL
+
+JavaScript
+
+Python
+curl -X GET "https://api.kie.ai/api/v1/jobs/recordInfo?taskId=task_12345678" \
+  -H "Authorization: Bearer YOUR_API_KEY"
+Response Example
+{
+  "code": 200,
+  "message": "success",
+  "data": {
+    "taskId": "task_12345678",
+    "model": "bytedance/v1-pro-image-to-video",
+    "state": "success",
+    "param": "{\"model\":\"bytedance/v1-pro-image-to-video\",\"callBackUrl\":\"https://your-domain.com/api/callback\",\"input\":{\"prompt\":\"A golden retriever dashing through shallow surf at the beach, back angle camera low near waterline, splashes frozen in time, blur trails in waves and paws, afternoon sun glinting off wet fur, overcast day, dramatic clouds\",\"image_url\":\"https://file.aiquickdraw.com/custom-page/akr/section-images/1755179021328w1nhip18.webp\",\"resolution\":\"720p\",\"duration\":\"5\",\"camera_fixed\":false,\"seed\":-1,\"enable_safety_checker\":true}}",
+    "resultJson": "{\"resultUrls\":[\"https://example.com/generated-image.jpg\"]}",
+    "failCode": "",
+    "failMsg": "",
+    "costTime": 0,
+    "completeTime": 1698765432000,
+    "createTime": 1698765400000
+  }
+}
+Response Fields
+code
+Status code, 200 for success, others for failure
+message
+Response message, error description when failed
+data.taskId
+Task ID
+data.model
+Model used for generation
+data.state
+Generation state
+data.param
+Complete Create Task request parameters as JSON string (includes model, callBackUrl, input and all other parameters)
+data.resultJson
+Result JSON string containing generated media URLs
+data.failCode
+Error code (when generation failed)
+data.failMsg
+Error message (when generation failed)
+data.completeTime
+Completion timestamp
+data.createTime
+Creation timestamp
+data.costTime
+Cost time in milliseconds
+State Values
+waiting
+Waiting for generation
+queuing
+In queue
+generating
+Generating
+success
+Generation successful
+fail
+Generation failed
+
+
+example input 
+GET
+/api/v1/jobs/recordInfo
+Query Task
+Query task status and results by task ID
+
+Request Example
+
+cURL
+
+JavaScript
+
+Python
+curl -X GET "https://api.kie.ai/api/v1/jobs/recordInfo?taskId=task_12345678" \
+  -H "Authorization: Bearer YOUR_API_KEY"
+Response Example
+{
+  "code": 200,
+  "message": "success",
+  "data": {
+    "taskId": "task_12345678",
+    "model": "bytedance/v1-pro-image-to-video",
+    "state": "success",
+    "param": "{\"model\":\"bytedance/v1-pro-image-to-video\",\"callBackUrl\":\"https://your-domain.com/api/callback\",\"input\":{\"prompt\":\"A golden retriever dashing through shallow surf at the beach, back angle camera low near waterline, splashes frozen in time, blur trails in waves and paws, afternoon sun glinting off wet fur, overcast day, dramatic clouds\",\"image_url\":\"https://file.aiquickdraw.com/custom-page/akr/section-images/1755179021328w1nhip18.webp\",\"resolution\":\"720p\",\"duration\":\"5\",\"camera_fixed\":false,\"seed\":-1,\"enable_safety_checker\":true}}",
+    "resultJson": "{\"resultUrls\":[\"https://example.com/generated-image.jpg\"]}",
+    "failCode": "",
+    "failMsg": "",
+    "costTime": 0,
+    "completeTime": 1698765432000,
+    "createTime": 1698765400000
+  }
+}
+Response Fields
+code
+Status code, 200 for success, others for failure
+message
+Response message, error description when failed
+data.taskId
+Task ID
+data.model
+Model used for generation
+data.state
+Generation state
+data.param
+Complete Create Task request parameters as JSON string (includes model, callBackUrl, input and all other parameters)
+data.resultJson
+Result JSON string containing generated media URLs
+data.failCode
+Error code (when generation failed)
+data.failMsg
+Error message (when generation failed)
+data.completeTime
+Completion timestamp
+data.createTime
+Creation timestamp
+data.costTime
+Cost time in milliseconds
+State Values
+waiting
+Waiting for generation
+queuing
+In queue
+generating
+Generating
+success
+Generation successful
+fail
+Generation failed
+
+
+ouput
+{
+  "resultUrls": [
+    "https://file.aiquickdraw.com/custom-page/akr/section-images/17551796948046brblmi1.mp4"
+  ]
+}

package/skills/ai-asset-generator/docs/remove-background.md

@@ -0,0 +1,19 @@
+curl -X 'POST' \
+  'https://api.styai.app/api/v1/media/remove-background' \
+  -H 'accept: application/json' \
+  -H 'X-API-Key: YOUR_STY_AI_API_KEY' \
+  -H 'Content-Type: multipart/form-data' \
+  -F 'file=@intro-step1.png;type=image/png' \
+  -F 'cropToForeground=false' \
+  -F 'targetSize=1024 768' \
+  -F 'outputFormat=png'
+
+
+  output
+  {
+    buffer: "base64",
+    contentType: "image/png",
+    size: 300000,
+    processingTime: 1000,
+    sucess: true
+  }

package/skills/ai-asset-generator/lib/bg-remove.mjs

@@ -0,0 +1,54 @@
+/**
+ * Shared background removal via Sty AI API.
+ */
+
+import { writeFile, readFile } from "fs/promises";
+import { resolve, dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { log } from "./kie-client.mjs";
+
+const __lib = dirname(fileURLToPath(import.meta.url));
+const OUTPUT_BASE = resolve(join(__lib, "..", "output"));
+
+function assertSafePath(p, base) {
+  const resolved = resolve(p);
+  if (!resolved.startsWith(base)) {
+    throw new Error(`Path traversal blocked: ${p} escapes ${base}`);
+  }
+  return resolved;
+}
+
+export async function removeBackground(inputPath, outputPath) {
+  const safeOutput = assertSafePath(outputPath, OUTPUT_BASE);
+
+  const apiKey = process.env.STY_AI_API_KEY;
+  if (!apiKey) {
+    throw new Error("STY_AI_API_KEY environment variable is not set");
+  }
+
+  const fileBuffer = await readFile(inputPath);
+  const blob = new Blob([fileBuffer], { type: "image/png" });
+
+  const formData = new FormData();
+  formData.append("file", blob, "image.png");
+  formData.append("cropToForeground", "true");
+  formData.append("outputFormat", "png");
+
+  const res = await fetch("https://api.styai.app/api/v1/media/remove-background", {
+    method: "POST",
+    headers: {
+      accept: "application/json",
+      "X-API-Key": apiKey,
+    },
+    body: formData,
+  });
+
+  const json = await res.json();
+  if (!json.sucess && !json.success) {
+    throw new Error("Background removal failed");
+  }
+
+  const buffer = Buffer.from(json.buffer, "base64");
+  await writeFile(safeOutput, buffer);
+  log(`  [bg-removed] ${safeOutput}`);
+}

package/skills/ai-asset-generator/lib/env.mjs

@@ -0,0 +1,48 @@
+/**
+ * Shared .env loader for ai-asset-generator scripts.
+ *
+ * Search order:
+ *   1. Project root (skills/)         — the single source of truth for all env vars
+ *   2. ai-asset-generator/ dir        — legacy fallback
+ *   3. Monorepo root (skills/../../)  — fallback for monorepo setups
+ *
+ * Files checked: .env, .env.local (values from earlier files win).
+ */
+
+import { readFile } from "fs/promises";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const GENERATOR_DIR = join(__dirname, "..");
+const PROJECT_ROOT = join(__dirname, "..", "..", "..");    // skills/
+const MONOREPO_ROOT = join(__dirname, "..", "..", "..", ".."); // one above skills/
+
+export async function loadEnv() {
+  const searchPaths = [PROJECT_ROOT, GENERATOR_DIR, MONOREPO_ROOT];
+  const envFiles = [".env", ".env.local"];
+
+  for (const dir of searchPaths) {
+    for (const envFile of envFiles) {
+      try {
+        const raw = await readFile(join(dir, envFile), "utf8");
+        let loaded = 0;
+        for (const line of raw.split("\n")) {
+          const trimmed = line.trim();
+          if (!trimmed || trimmed.startsWith("#")) continue;
+          const eq = trimmed.indexOf("=");
+          if (eq === -1) continue;
+          const key = trimmed.slice(0, eq).trim();
+          const val = trimmed.slice(eq + 1).trim();
+          if (!process.env[key]) {
+            process.env[key] = val;
+            loaded++;
+          }
+        }
+        if (loaded > 0) console.log(`  [env] Loaded ${loaded} vars from ${dir}/${envFile}`);
+      } catch {
+        // File doesn't exist, continue
+      }
+    }
+  }
+}

package/skills/ai-asset-generator/lib/kie-client.mjs

@@ -0,0 +1,111 @@
+/**
+ * Shared KIE AI API client.
+ *
+ * Provides: createTask, queryTask, pollUntilDone, downloadFile
+ * All scripts use the same API base and auth pattern.
+ */
+
+import { writeFile, mkdir } from "fs/promises";
+import { existsSync } from "fs";
+import { dirname, join, resolve } from "path";
+import { fileURLToPath } from "url";
+
+const __lib = dirname(fileURLToPath(import.meta.url));
+const SKILL_DIR = join(__lib, "..");
+
+// ─── Helpers ────────────────────────────────────────────────
+export const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+export const log = (msg) => console.log(msg);
+
+/**
+ * Default output directory: ai-asset-generator/output/<name>/
+ * Each generator gets its own subfolder under the skill's output/ dir.
+ */
+export function outputDir(name) {
+  return join(SKILL_DIR, "output", name);
+}
+
+// ─── API Client ─────────────────────────────────────────────
+const API = "https://api.kie.ai/api/v1/jobs";
+
+function headers() {
+  return {
+    "Content-Type": "application/json",
+    Authorization: `Bearer ${process.env.KIE_AI_API_KEY}`,
+  };
+}
+
+export async function createTask(payload) {
+  const res = await fetch(`${API}/createTask`, {
+    method: "POST",
+    headers: headers(),
+    body: JSON.stringify(payload),
+  });
+  const json = await res.json();
+  if (json.code !== 200) {
+    throw new Error(`createTask failed (${json.code}): ${json.message}`);
+  }
+  return json.data.taskId;
+}
+
+export async function queryTask(taskId) {
+  const res = await fetch(`${API}/recordInfo?taskId=${taskId}`, {
+    headers: { Authorization: `Bearer ${process.env.KIE_AI_API_KEY}` },
+  });
+  const json = await res.json();
+  if (json.code !== 200) {
+    throw new Error(`queryTask failed (${json.code}): ${json.message}`);
+  }
+  return json.data;
+}
+
+/**
+ * Poll a task until it reaches success/fail.
+ * Uses increasing delay: 5s → 8s → 12s → … capped at 30s.
+ */
+export async function pollUntilDone(taskId, label, timeoutMs = 300_000) {
+  const t0 = Date.now();
+  let delay = 5_000;
+
+  while (Date.now() - t0 < timeoutMs) {
+    const task = await queryTask(taskId);
+
+    if (task.state === "success") {
+      const urls = JSON.parse(task.resultJson).resultUrls;
+      log(`  [done] ${label}`);
+      return urls[0];
+    }
+
+    if (task.state === "fail") {
+      throw new Error(`${label} failed: ${task.failMsg || "unknown"}`);
+    }
+
+    const elapsed = Math.round((Date.now() - t0) / 1000);
+    log(`  [${task.state}] ${label}  (${elapsed}s, next poll in ${Math.round(delay / 1000)}s)`);
+    await sleep(delay);
+    delay = Math.min(Math.round(delay * 1.5), 30_000);
+  }
+
+  throw new Error(`${label} timed out after ${timeoutMs / 1000}s`);
+}
+
+export async function downloadFile(url, dest) {
+  const parsed = new URL(url);
+  if (!['https:'].includes(parsed.protocol)) {
+    throw new Error(`Disallowed URL scheme: ${parsed.protocol}`);
+  }
+
+  const safeDest = resolve(dest);
+  const safeBase = resolve(join(SKILL_DIR, "output"));
+  if (!safeDest.startsWith(safeBase)) {
+    throw new Error(`Path traversal blocked: ${dest} escapes output directory`);
+  }
+
+  const dir = dirname(safeDest);
+  if (!existsSync(dir)) await mkdir(dir, { recursive: true });
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`Download failed: ${res.status} ${url}`);
+  const buf = Buffer.from(await res.arrayBuffer());
+  await writeFile(safeDest, buf);
+  log(`  [saved] ${safeDest}`);
+}