@talesofai/neta-skills 0.6.0

package/bin/commands/community/subscribe_user.cmd.js

@@ -0,0 +1,33 @@
+import { Type } from "@sinclair/typebox";
+import { parseMeta } from "../../utils/parse_meta.js";
+import { createCommand } from "../factory.js";
+const meta = parseMeta(Type.Object({
+    name: Type.String(),
+    title: Type.String(),
+    description: Type.String(),
+}), import.meta);
+export const subscribeUserCmd = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: Type.Object({
+        user_uuid: Type.String(),
+        is_cancel: Type.Boolean({
+            default: false,
+        }),
+    }),
+}, async ({ user_uuid, is_cancel }, { apis }) => {
+    const action = is_cancel ? "unsubscribe" : "subscribe";
+    const result = await apis.user.subscribeUser({
+        user_uuid,
+        is_cancel,
+    });
+    if (!result.success) {
+        throw new Error(`${action} fail`);
+    }
+    return {
+        success: true,
+        subscribe_status: result.subscribe_status,
+        message: `${action} success`,
+    };
+});

package/bin/commands/community/subscribe_user.cmd.zh_cn.yml

@@ -0,0 +1,3 @@
+name: subscribe_user
+title: 关注用户&取消关注
+description: 对用户进行关注或取消关注操作

package/bin/commands/community/suggest_categories.cmd.en_us.yml

@@ -0,0 +1,4 @@
+name: suggest_categories
+title: 📂 Suggest Category Hierarchy
+description: Return navigation suggestions for the requested level in the content category hierarchy (category navigation suggestions).
+

package/bin/commands/community/suggest_categories.cmd.js

@@ -0,0 +1,26 @@
+import { Type } from "@sinclair/typebox";
+import { parseMeta } from "../../utils/parse_meta.js";
+import { createCommand } from "../factory.js";
+const meta = parseMeta(Type.Object({
+    name: Type.String(),
+    title: Type.String(),
+    description: Type.String(),
+}), import.meta);
+const suggestCategoriesV1Parameters = Type.Object({
+    level: Type.Integer({ minimum: 1, maximum: 5, default: 1 }),
+    parent_path: Type.Optional(Type.String()),
+});
+export const suggestCategories = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: suggestCategoriesV1Parameters,
+}, async ({ level, parent_path }, { apis }) => {
+    const result = await apis.recsys.suggestCategories({
+        level,
+        parent_path,
+    });
+    return {
+        suggestions: result.suggestions || [],
+    };
+});

package/bin/commands/community/suggest_categories.cmd.zh_cn.yml

@@ -0,0 +1,3 @@
+name: suggest_categories
+title: 📂 获取玩法分类层级的导航建议
+description: 获取指定层级的分类导航建议（Category Navigation Suggestions）

package/bin/commands/community/suggest_content.cmd.en_us.yml

@@ -0,0 +1,5 @@
+name: suggest_content
+title: 🧠 Content Suggestion Engine (Recommend/Search/Exact Modes)
+description: |
+  Return a personalized content feed according to the specified intent and filters (content feed suggestion).
+

package/bin/commands/community/suggest_content.cmd.js

@@ -0,0 +1,59 @@
+import { Type } from "@sinclair/typebox";
+import { parseMeta } from "../../utils/parse_meta.js";
+import { createCommand } from "../factory.js";
+const meta = parseMeta(Type.Object({
+    name: Type.String(),
+    title: Type.String(),
+    description: Type.String(),
+}), import.meta);
+// 创建扁平化的输入 schema（所有数组改为字符串，手动分割）
+export const suggestContentInputSchema = Type.Object({
+    page_index: Type.Integer({ minimum: 0, default: 0 }),
+    page_size: Type.Integer({ minimum: 1, maximum: 40, default: 20 }),
+    scene: Type.String({ default: "agent_intent" }),
+    biz_trace_id: Type.Optional(Type.String()),
+    // 业务数据扁平化（使用逗号分隔的字符串）
+    intent: Type.Union([Type.Literal("recommend"), Type.Literal("search"), Type.Literal("exact")], { default: "recommend" }),
+    search_keywords: Type.String({ default: "" }),
+    tax_paths: Type.String({ default: "" }),
+    tax_primaries: Type.String({ default: "" }),
+    tax_secondaries: Type.String({ default: "" }),
+    tax_tertiaries: Type.String({ default: "" }),
+    exclude_keywords: Type.String({ default: "" }),
+    exclude_tax_paths: Type.String({ default: "" }),
+});
+export const suggestContent = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: suggestContentInputSchema,
+}, async (params, { apis }) => {
+    // 将逗号分隔的字符串转换为数组
+    const parseArray = (str) => str
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    // 将扁平化参数转换为嵌套的 business_data 结构
+    const requestPayload = {
+        page_index: params.page_index,
+        page_size: params.page_size,
+        scene: params.scene,
+        biz_trace_id: params.biz_trace_id,
+        business_data: {
+            intent: params.intent,
+            search_keywords: parseArray(params.search_keywords),
+            tax_paths: parseArray(params.tax_paths),
+            tax_primaries: parseArray(params.tax_primaries),
+            tax_secondaries: parseArray(params.tax_secondaries),
+            tax_tertiaries: parseArray(params.tax_tertiaries),
+            exclude_keywords: parseArray(params.exclude_keywords),
+            exclude_tax_paths: parseArray(params.exclude_tax_paths),
+        },
+    };
+    const result = await apis.recsys.suggestContent(requestPayload);
+    // 将 API 返回结果转换为新结构
+    return {
+        module_list: result.module_list,
+        page_data: result.page_data,
+    };
+});

package/bin/commands/community/suggest_content.cmd.zh_cn.yml

@@ -0,0 +1,4 @@
+name: suggest_content
+title: 🧠 智能内容流引擎（支持推荐/搜索/精确筛选三模式）
+description: |
+  根据指定模式返回个性化的内容流（Content Feed Suggestion）

package/bin/commands/community/suggest_keywords.cmd.en_us.yml

@@ -0,0 +1,4 @@
+name: suggest_keywords
+title: 🔍 Suggest Search Keywords
+description: Return suggested search keywords based on a user‑provided prefix (search keyword autocomplete).
+

package/bin/commands/community/suggest_keywords.cmd.js

@@ -0,0 +1,26 @@
+import { Type } from "@sinclair/typebox";
+import { parseMeta } from "../../utils/parse_meta.js";
+import { createCommand } from "../factory.js";
+const meta = parseMeta(Type.Object({
+    name: Type.String(),
+    title: Type.String(),
+    description: Type.String(),
+}), import.meta);
+const suggestKeywordsV1Parameters = Type.Object({
+    prefix: Type.String({ minLength: 1 }),
+    size: Type.Integer({ minimum: 1, maximum: 50, default: 10 }),
+});
+export const suggestKeywords = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: suggestKeywordsV1Parameters,
+}, async ({ prefix, size }, { apis }) => {
+    const result = await apis.recsys.suggestKeywords({
+        prefix,
+        size,
+    });
+    return {
+        suggestions: result.suggestions || [],
+    };
+});

package/bin/commands/community/suggest_keywords.cmd.zh_cn.yml

@@ -0,0 +1,3 @@
+name: suggest_keywords
+title: 🔍 获取搜索关键词的自动补全建议
+description: 基于用户输入的前缀，返回相关的搜索关键词建议（Search Keyword Autocomplete）

package/bin/commands/community/suggest_tags.cmd.en_us.yml

@@ -0,0 +1,4 @@
+name: suggest_tags
+title: 🏷️ Suggest Related Tags
+description: Return related tag suggestions based on a full search keyword (tag matching suggestions).
+

package/bin/commands/community/suggest_tags.cmd.js

@@ -0,0 +1,26 @@
+import { Type } from "@sinclair/typebox";
+import { parseMeta } from "../../utils/parse_meta.js";
+import { createCommand } from "../factory.js";
+const meta = parseMeta(Type.Object({
+    name: Type.String(),
+    title: Type.String(),
+    description: Type.String(),
+}), import.meta);
+const suggestTagsV1Parameters = Type.Object({
+    keyword: Type.String({ minLength: 1 }),
+    size: Type.Integer({ minimum: 1, maximum: 50, default: 10 }),
+});
+export const suggestTags = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: suggestTagsV1Parameters,
+}, async ({ keyword, size }, { apis }) => {
+    const result = await apis.recsys.suggestTags({
+        keyword,
+        size,
+    });
+    return {
+        suggestions: result.suggestions || [],
+    };
+});

package/bin/commands/community/suggest_tags.cmd.zh_cn.yml

@@ -0,0 +1,3 @@
+name: suggest_tags
+title: 🏷️ 基于完整关键词获取相关标签建议
+description: 基于完整的搜索关键词，返回相关的标签建议（Tag Matching Suggestions）

package/bin/commands/community/validate_tax_path.cmd.en_us.yml

@@ -0,0 +1,4 @@
+name: validate_tax_path
+title: ✅ Validate Taxonomy Path
+description: Validate whether a given taxonomy path string is valid (validate taxonomy path).
+

package/bin/commands/community/validate_tax_path.cmd.js

@@ -0,0 +1,24 @@
+import { Type } from "@sinclair/typebox";
+import { parseMeta } from "../../utils/parse_meta.js";
+import { createCommand } from "../factory.js";
+const meta = parseMeta(Type.Object({
+    name: Type.String(),
+    title: Type.String(),
+    description: Type.String(),
+}), import.meta);
+const validateTaxPathV1Parameters = Type.Object({
+    tax_path: Type.String({ minLength: 1 }),
+});
+export const validateTaxPath = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: validateTaxPathV1Parameters,
+}, async ({ tax_path }, { apis }) => {
+    const result = await apis.recsys.validateTaxPath({
+        tax_path,
+    });
+    return {
+        valid: result.valid || false,
+    };
+});

package/bin/commands/community/validate_tax_path.cmd.zh_cn.yml

@@ -0,0 +1,3 @@
+name: validate_tax_path
+title: ✅ 验证玩法标签路径是否有效
+description: 验证指定的分类路径字符串是否有效（Validate Taxonomy Path）

package/bin/commands/creative/edit_colleciton.cmd.en_us.yml

@@ -0,0 +1,11 @@
+name: edit_collection
+title: Edit Collection
+description: Edit an existing collection.
+parameters:
+  uuid: Collection UUID.
+  name: Collection title.
+  description: Short description of the collection.
+  status: Publish status of the collection, either PRIVATE or PUBLISHED.
+  artifacts: List of collection assets, minimum 1 and maximum 12 items. Example picture_uuid,picture_uuid
+  hashtags: List of collection hashtags. Example hashtag_name,hashtag_name
+

package/bin/commands/creative/edit_colleciton.cmd.js

@@ -0,0 +1,140 @@
+import { Type } from "@sinclair/typebox";
+import { parseMeta } from "../../utils/parse_meta.js";
+import { createCommand } from "../factory.js";
+const meta = parseMeta(Type.Object({
+    name: Type.String(),
+    title: Type.String(),
+    description: Type.String(),
+    parameters: Type.Object({
+        uuid: Type.String(),
+        name: Type.String(),
+        description: Type.String(),
+        status: Type.String(),
+        artifacts: Type.String(),
+        hashtags: Type.String(),
+    }),
+}), import.meta);
+export const editCollection = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: Type.Object({
+        uuid: Type.String({ description: meta.parameters.uuid }),
+        name: Type.Optional(Type.String({ description: meta.parameters.name })),
+        description: Type.Optional(Type.String({ description: meta.parameters.description })),
+        status: Type.Optional(Type.Union([Type.Literal("PRIVATE"), Type.Literal("PUBLISHED")], {
+            description: meta.parameters.status,
+        })),
+        artifacts: Type.Optional(Type.String({ description: meta.parameters.artifacts })),
+        hashtags: Type.Optional(Type.String({ description: meta.parameters.hashtags })),
+        remix_instruct: Type.Optional(Type.String()),
+    }),
+}, async ({ uuid, name, description, status, hashtags, artifacts, remix_instruct }, { apis }) => {
+    const [collection] = await apis.collection.collectionDetails([uuid]);
+    if (!collection) {
+        throw new Error(`collection ${uuid} not found`);
+    }
+    const payload = {
+        uuid,
+        name: collection.name,
+        description: collection.description ?? "",
+        status: collection.status,
+        hashtags: collection.hashtags,
+        displayData: collection.displayData,
+        editorData: collection.editorData,
+        picCount: collection.picCount,
+        coverUrl: collection.coverUrl,
+        shareUrl: collection.shareUrl,
+        aspect: collection.aspect,
+        activity: collection.activity,
+        extra_data: collection.extra_data,
+        bgm_uuid: collection.bgm_uuid,
+        video_uuid: collection.video_uuid,
+        is_interactive: collection.is_interactive,
+    };
+    if (name) {
+        payload.name = name;
+    }
+    if (description) {
+        payload.description = description;
+    }
+    if (status) {
+        payload.status = status;
+    }
+    if (hashtags) {
+        const tags = await Promise.all(hashtags?.split(",")?.map((tag) => apis.hashtag.createHashtag(tag)) ??
+            []);
+        const tagDetails = await Promise.all(tags.map((tag) => apis.hashtag.fetchHashtag(tag.name)));
+        const activity = tagDetails.find((tag) => tag?.activity_detail?.uuid) ?? null;
+        payload.hashtags = tagDetails.map((tag) => tag.name);
+        payload.activity = activity?.activity_detail?.uuid ?? null;
+    }
+    if (artifacts) {
+        const artifactDetails = await apis.artifact.artifactDetail(artifacts?.split(",") ?? []);
+        if (artifactDetails.length < 1 || artifactDetails.length > 12) {
+            throw new Error("artifacts must be between 1 and 12");
+        }
+        artifactDetails.forEach((artifact, index) => {
+            if (!artifact) {
+                throw new Error(`artifact ${artifacts[index]} not found`);
+            }
+            if (artifact.status !== "SUCCESS") {
+                throw new Error(`artifact ${artifacts[index]} status is not success`);
+            }
+        });
+        const coverArtifact = artifactDetails.find((artifact) => artifact.url) ?? null;
+        const aspect = (() => {
+            if (!coverArtifact)
+                return "3:4";
+            if (coverArtifact.modality === "PICTURE" &&
+                coverArtifact.image_detail) {
+                return `${coverArtifact.image_detail.width}:${coverArtifact.image_detail.height}`;
+            }
+            if (coverArtifact.modality === "VIDEO" && coverArtifact.video_detail) {
+                return `${coverArtifact.video_detail.width}:${coverArtifact.video_detail.height}`;
+            }
+            return "3:4";
+        })();
+        const data = {
+            pages: [
+                {
+                    images: artifactDetails,
+                },
+            ],
+        };
+        const characters = new Map();
+        artifactDetails.forEach((artifact) => {
+            artifact.input?.rawPrompt?.forEach((p) => {
+                if (p?.type === "official_character_vtoken_adaptor" ||
+                    p?.type === "oc_vtoken_adaptor") {
+                    characters.set(p.value, {
+                        type: "character",
+                        name: p.name,
+                        weight: p.weight,
+                        value: p.value,
+                    });
+                }
+            });
+        });
+        payload.displayData = data;
+        payload.editorData = data;
+        payload.picCount = artifactDetails.length;
+        payload.coverUrl = coverArtifact?.url ?? null;
+        payload.shareUrl = coverArtifact?.url ?? null;
+        payload.aspect = aspect;
+        payload.refCharacterTokens = Array.from(characters.values());
+    }
+    if (remix_instruct) {
+        if (payload.extra_data) {
+            payload.extra_data.remix_instruct = remix_instruct;
+        }
+        else {
+            payload.extra_data = {
+                remix_instruct,
+            };
+        }
+    }
+    const updated = await apis.collection.saveCollection(payload);
+    await apis.collection.publishCollection(uuid);
+    return updated;
+});

package/bin/commands/creative/edit_colleciton.cmd.zh_cn.yml

@@ -0,0 +1,10 @@
+name: edit_collection
+title: 编辑作品
+description: 编辑一个作品
+parameters:
+  uuid: 作品 uuid
+  name: 作品标题
+  description: 作品简介
+  status: 作品发布状态 PRIVATE(私密) 或 PUBLISHED(公开)
+  artifacts: 作品素材列表, 最少1张, 最多12张, 示例, picture_uuid,picture_uuid
+  hashtags: 作品标签列表, 示例, hashtag_name,hashtag_name

package/bin/commands/creative/make_image.cmd.en_us.yml

@@ -0,0 +1,20 @@
+name: make_image
+title: Generate Image
+description: Generate images from text prompts and/or reference images.
+parameters:
+  prompt: |
+    The prompt for image generation.
+      - It can include:
+        - Characters: reference characters with @character_name; this includes the full character definition.
+        - Visual elements: reference style elements with /element_name, for example /MangaStyle.
+        - Reference images: reference existing images with the pattern ref_img-uuid, e.g. "ref_img-1234567890". At most 14 images are supported.
+        - Natural language phrases: describe the desired scene in detail. If you do not reference a character, you should describe the character’s appearance here.
+      - Notes:
+        - Provide as much context and intent as possible. Narrative descriptions of the scene almost always produce better and more coherent images than a flat list of disconnected keywords.
+        - Character references must appear in the form @character_name, e.g. @Neta.
+        - Element references must appear in the form /elementum_name, e.g. /MangaStyle.
+        - When referencing characters or elements, separate them with spaces or commas, for example: "@character_name, /elementum_name, walking on campus".
+        - For image editing or image‑to‑image tasks, always include the proper reference image variables.
+      - Example (character + element): @character_name, /elementum_name, ref_img-1234567890, ref_img-1234567891, keyword1, keyword2…
+  aspect: Image aspect ratio
+

package/bin/commands/creative/make_image.cmd.js

@@ -0,0 +1,58 @@
+import { Type } from "@sinclair/typebox";
+import { buildMakeImagePayload } from "../../apis/types.js";
+import { parseMeta } from "../../utils/parse_meta.js";
+import { polling } from "../../utils/polling.js";
+import { createCommand } from "../factory.js";
+const meta = parseMeta(Type.Object({
+    name: Type.String(),
+    title: Type.String(),
+    description: Type.String(),
+    parameters: Type.Object({
+        prompt: Type.String(),
+        aspect: Type.String(),
+    }),
+}), import.meta);
+const makeImageV1Parameters = Type.Object({
+    prompt: Type.String({ description: meta.parameters.prompt }),
+    aspect: Type.Union([
+        Type.Literal("3:4"),
+        Type.Literal("16:9"),
+        Type.Literal("4:3"),
+        Type.Literal("9:16"),
+        Type.Literal("1:1"),
+    ], {
+        default: "3:4",
+        description: meta.parameters.aspect,
+    }),
+});
+export const makeImage = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: makeImageV1Parameters,
+}, async ({ prompt, aspect }, { log, apis }) => {
+    const createTask = async () => {
+        const vtokens = (await apis.prompt.parseVtokens(prompt)) ?? [];
+        const payload = buildMakeImagePayload(vtokens ?? [], {
+            make_image_aspect: aspect ?? "3:4",
+            context_model_series: "8_image_edit",
+        });
+        return await apis.artifact.makeImage(payload);
+    };
+    const task_uuid = await createTask();
+    log.debug("task: %s", task_uuid);
+    const timeout = 60 * 1000 * 10;
+    const res = await polling(() => apis.artifact.task(task_uuid), async (result) => {
+        log.debug("polling: %o", result);
+        return (result.task_status !== "PENDING" &&
+            result.task_status !== "MODERATION");
+    }, 2000, timeout);
+    if (res.isTimeout) {
+        return {
+            task_uuid,
+            task_status: "TIMEOUT",
+            artifacts: [],
+        };
+    }
+    return res.result;
+});

package/bin/commands/creative/make_image.cmd.zh_cn.yml

@@ -0,0 +1,19 @@
+name: make_image
+title: 生成图片
+description: 基于文本提示词或图片生成图片的工具
+parameters:
+  prompt: |
+    生图提示词。
+      - 可包括:
+        - 角色:通过 @character_name 来引用角色,这个引用会包含角色的完整形象信息;
+        - 画面元素:通过 /元素名称 格式引用风格元素,如 /漫画风格;
+        - 参考图:通过 参考图-uuid 格式引用已存在的图片作为参考图,如"参考图-1234567890"。最多能有 14 张图片;
+        - 中文词组:描述具体画面生成要求,如果没有引用角色,则需要在自然语言词组中描述角色形象;
+      - 注意:
+        - 提示词要多提供上下文和意图。详细描述场景,而不仅仅是列出关键字。与一连串不相关的字词相比,叙述性描述段落几乎总是能生成更好、更连贯的图片；
+        - 角色引用必须以 @角色名称 形式出现,如 @奈塔#996;
+        - 元素引用必须以 /元素名称 形式出现,如 /漫画风格;
+        - 引用角色或者元素的时候,前后要添加空格或逗号分隔,如："@奈塔#996, /漫画风格, 在校园里散步"
+        - 对于修改图片等跟原图参考相关的生成,请一定引用上参考图变量
+      - 示例(引用角色和元素)：@奈塔#996, /漫画风格, 参考图-1234567890, 参考图-1234567891, 词组1, 词组2…
+  aspect: 图片比例

package/bin/commands/creative/make_song.cmd.en_us.yml

@@ -0,0 +1,8 @@
+name: make_song
+title: Generate Song
+description: Generate a song from lyrics and a high-level musical description.
+parameters:
+  prompt: A description of the music, used to specify style, mood, and scenario. For example "Pop music, sad, suitable for a rainy night."
+  lyrics: |
+    The lyrics of the song. Use \n to separate each line. You can add structure tags such as [Intro], [Verse], [Pre Chorus], [Chorus], [Interlude], [Bridge], [Outro], [Post Chorus], [Transition], [Break], [Hook], [Build Up], [Inst], [Solo] to guide the musical structure.
+

package/bin/commands/creative/make_song.cmd.js

@@ -0,0 +1,53 @@
+import { Type } from "@sinclair/typebox";
+import { parseMeta } from "../../utils/parse_meta.js";
+import { polling } from "../../utils/polling.js";
+import { createCommand } from "../factory.js";
+const meta = parseMeta(Type.Object({
+    name: Type.String(),
+    title: Type.String(),
+    description: Type.String(),
+    parameters: Type.Object({
+        prompt: Type.String(),
+        lyrics: Type.String(),
+    }),
+}), import.meta);
+const makeSongV1Parameters = Type.Object({
+    prompt: Type.String({
+        minLength: 10,
+        maxLength: 2000,
+        description: meta.parameters.prompt,
+    }),
+    lyrics: Type.String({
+        minLength: 10,
+        maxLength: 3500,
+        description: meta.parameters.lyrics,
+    }),
+});
+export const makeSong = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: makeSongV1Parameters,
+}, async ({ prompt, lyrics }, { apis, log }) => {
+    const createTask = async () => {
+        return apis.artifact.makeSong(prompt, lyrics, {
+            entrance: "SONG,VERSE",
+        });
+    };
+    const task_uuid = await createTask();
+    log.debug("task: %s", task_uuid);
+    const timeout = 60 * 1000 * 5;
+    const res = await polling(() => apis.artifact.task(task_uuid), async (result) => {
+        log.debug("polling: %o", result);
+        return (result.task_status !== "PENDING" &&
+            result.task_status !== "MODERATION");
+    }, 2000, timeout);
+    if (res.isTimeout) {
+        return {
+            task_uuid,
+            task_status: "TIMEOUT",
+            artifacts: [],
+        };
+    }
+    return res.result;
+});

package/bin/commands/creative/make_song.cmd.zh_cn.yml

@@ -0,0 +1,7 @@
+name: make_song
+title: 生成歌曲
+description: 输入歌词和歌曲描述，进行歌曲生成
+parameters:
+  prompt: 音乐的描述,用于指定风格、情绪和场景。例如"流行音乐, 难过, 适合在下雨的晚上"。
+  lyrics: |
+    歌曲的歌词。使用 \n 分隔每行。你可以在歌词中加入 [Intro], [Verse], [Pre Chorus], [Chorus], [Interlude], [Bridge], [Outro], [Post Chorus], [Transition], [Break], [Hook], [Build Up], [Inst], [Solo] 等结构标签来优化生成的音乐结构。

package/bin/commands/creative/make_video.cmd.en_us.yml

@@ -0,0 +1,17 @@
+name: make_video
+title: Generate Video
+description: Generate a video based on a single reference image and a detailed prompt.
+parameters:
+  image_source: |
+    The image URL to use as the first frame of the video.
+    Only one image can be referenced. For multi‑character or multi‑shot scenarios, first use make_image to create a composite image and then use it as the video reference image.
+  prompt: |
+    A full natural language prompt that drives video generation.
+    Single‑shot scenes: include scene, characters, actions, style, camera movement, lighting, atmosphere, etc. Make sure character motion is natural and smooth.
+    Multi‑shot scenes: prompt structure = overall description + shot index + timestamp + shot content + aesthetic control + stylization + audio description (voice / sound effects / background music).
+      - Overall description: briefly summarize the whole video, including story theme, narrative style, main emotion or key events.
+      - Shot index: assign an index to each shot to distinguish different segments of the video.
+      - Timestamp: specify the time range of each shot in the video timeline to keep content aligned with time.
+      - Shot content: describe what key characters or objects are doing in each shot, including actions, dialogue, expressions, poses, etc.
+  model: Video generation model. Use model_w to generate 10‑second multi‑shot videos with audio, and model_s to generate 5‑second single‑shot videos without audio.
+