ginskill-init 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: pat_lJ8bAVjHn2_moLH1zxdTm9NnU8rvUcw8HyiQtuHg' \
+  -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/generate-credit-assets.mjs

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+
+/**
+ * Credit Feature Asset Generator
+ *
+ * Generates hero illustrations for the Earn Credits screen
+ * using the KIE AI API (nano-banana-pro).
+ *
+ * Assets:
+ *   1. earn-hero.png   - Main hero background for the earn credits screen
+ *   2. coin-reward.png - Sty coin/reward illustration (transparent bg)
+ *   3. streak-fire.png - Daily streak fire illustration (transparent bg)
+ *
+ * Brand palette:
+ *   Rose #EC4899 primary, #FFF1F3 → #FFE4E9 → #FECDD6 → #FDA4B8 gradient
+ *   Task colors: Blue #3B82F6, Green #22C55E, Purple #8B5CF6, Amber #F59E0B
+ *
+ * Usage:
+ *   node tools/generate-credit-assets.mjs
+ */
+
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { loadEnv } from "./lib/env.mjs";
+import { createTask, pollUntilDone, downloadFile, log } from "./lib/kie-client.mjs";
+import { removeBackground } from "./lib/bg-remove.mjs";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const OUTPUT_DIR = join(__dirname, "..", "styai-mobile", "src", "assets", "images", "credits");
+
+// ─── Asset Definitions ──────────────────────────────────────
+const IMAGE_ASSETS = [
+  {
+    name: "earn-hero",
+    filename: "earn-hero.png",
+    aspect_ratio: "16:9",
+    resolution: "2K",
+    removeBg: false,
+    prompt: [
+      "Abstract soft blurred background banner for a mobile app card header.",
+      "Smooth dreamy gradient from blush pink (#FFF1F3) on left to rose (#FECDD6) center to mauve pink (#FDA4B8) on right.",
+      "Scattered soft bokeh circles in light rose and white, gentle and out of focus.",
+      "A few tiny sparkle dots in rose-gold tones, very subtle and sparse.",
+      "Soft diagonal light streak from top-left, warm and diffused.",
+      "The overall feel is premium, feminine, airy, like a luxury fashion brand background.",
+      "No objects, no coins, no icons, no shapes in focus. Just an abstract atmospheric background.",
+      "Very clean and minimal, suitable for overlaying text and icons on top.",
+      "Ultra smooth gradients, no harsh edges, dreamlike soft-focus photography style.",
+      "No text, no typography, no logos, no people, no watermarks, no UI elements.",
+    ].join(" "),
+  },
+  {
+    name: "coin-reward",
+    filename: "coin-reward.png",
+    aspect_ratio: "1:1",
+    resolution: "1K",
+    removeBg: true,
+    prompt: [
+      "Premium 3D render of a single stylish reward coin, centered on pure white background.",
+      "The coin is polished rose-gold (#EC4899) with luxurious metallic sheen and soft reflections.",
+      "On the coin face: a clean minimalist 5-pointed star, embossed with soft beveled edges.",
+      "The coin has a refined thin rim with subtle ridge detailing, like a luxury medallion.",
+      "Slight 15-degree tilt showing the coin's thickness and 3D depth.",
+      "Warm ambient glow radiating behind: rose-pink (#FDA4B8) halo with soft falloff.",
+      "4-5 tiny sparkle particles floating around the coin in blush and champagne gold.",
+      "One small light streak crossing the coin surface for premium shine effect.",
+      "Clean white background, professional studio three-point lighting, razor sharp focus.",
+      "Photorealistic 3D render, luxury product photography, fashion accessory aesthetic.",
+      "No text, no typography, no logos, no people, no watermarks.",
+    ].join(" "),
+  },
+  {
+    name: "streak-fire",
+    filename: "streak-fire.png",
+    aspect_ratio: "1:1",
+    resolution: "1K",
+    removeBg: true,
+    prompt: [
+      "Premium 3D render of a stylized flame icon, centered on pure white background.",
+      "The flame is elegant and fashion-forward, made of gradient from rose (#EC4899)",
+      "at base to coral (#F87198) mid to warm pink (#FDA4B8) at tip.",
+      "Smooth glossy surface with a gentle metallic sheen, like a luxury enamel brooch.",
+      "The flame shape is clean, stylized, and slightly abstract — not realistic fire.",
+      "Two inner flicker shapes inside the flame in lighter rose tones for depth.",
+      "Subtle warm glow at the base, blush (#FFE4E9) ambient light spreading outward.",
+      "3-4 tiny sparkle particles in rose and gold tones floating near the tip.",
+      "Clean white background, professional studio lighting, ultra sharp focus.",
+      "Photorealistic 3D render, luxury product photography style.",
+      "No text, no typography, no logos, no people, no watermarks.",
+      "Fashion-forward, premium gamification aesthetic, celebratory feel.",
+    ].join(" "),
+  },
+];
+
+// ─── Main ───────────────────────────────────────────────────
+async function main() {
+  await loadEnv();
+
+  if (!process.env.KIE_AI_API_KEY) {
+    console.error("Error: KIE_AI_API_KEY not found. Check .env");
+    process.exit(1);
+  }
+
+  console.log("\n========================================");
+  console.log("  Credit Feature Asset Generator");
+  console.log("  Brand: Rose #EC4899 | Sty AI");
+  console.log("========================================\n");
+
+  // Phase 1: Submit all tasks
+  log("--- Phase 1: Submitting image tasks ---\n");
+
+  const jobs = await Promise.all(
+    IMAGE_ASSETS.map(async (asset) => {
+      log(`  [submit] ${asset.name}  (${asset.aspect_ratio} ${asset.resolution})`);
+      const taskId = await createTask({
+        model: "nano-banana-pro",
+        input: {
+          prompt: asset.prompt,
+          aspect_ratio: asset.aspect_ratio,
+          resolution: asset.resolution,
+          output_format: "png",
+        },
+      });
+      log(`  [queued] ${asset.name}  taskId=${taskId}`);
+      return { ...asset, taskId };
+    })
+  );
+
+  // Phase 2: Poll all tasks
+  log(`\n--- Phase 2: Polling ${jobs.length} image tasks ---\n`);
+
+  const results = await Promise.all(
+    jobs.map(async (job) => {
+      const url = await pollUntilDone(job.taskId, job.name);
+      return { ...job, resultUrl: url };
+    })
+  );
+
+  // Phase 3: Download images
+  log("\n--- Phase 3: Downloading images ---\n");
+
+  for (const r of results) {
+    const dest = join(OUTPUT_DIR, r.filename);
+    await downloadFile(r.resultUrl, dest);
+  }
+
+  // Phase 4: Remove backgrounds where needed
+  const bgRemoveJobs = results.filter((r) => r.removeBg);
+  if (bgRemoveJobs.length > 0) {
+    log("\n--- Phase 4: Removing backgrounds ---\n");
+    for (const r of bgRemoveJobs) {
+      const src = join(OUTPUT_DIR, r.filename);
+      const noBgName = r.filename.replace(".png", "-nobg.png");
+      const dest = join(OUTPUT_DIR, noBgName);
+      try {
+        await removeBackground(src, dest);
+      } catch (err) {
+        log(`  [warn] Background removal failed for ${r.name}: ${err.message}`);
+        log(`  [skip] Keeping original ${r.filename}`);
+      }
+    }
+  }
+
+  console.log("\n========================================");
+  console.log("  All done!");
+  console.log("========================================");
+  console.log(`\nGenerated assets in ${OUTPUT_DIR}:`);
+  for (const r of results) {
+    console.log(`  - ${r.filename}  (${r.name})`);
+    if (r.removeBg) {
+      console.log(`  - ${r.filename.replace(".png", "-nobg.png")}  (${r.name} no bg)`);
+    }
+  }
+  console.log("");
+}
+
+main().catch((err) => {
+  console.error(`\nFatal: ${err.message}`);
+  process.exit(1);
+});