Used to interact with the Neta API, supporting multimedia content creation and creation-related character queries.
Instructions
- When handling tasks related to "creating or modifying specific works" (images/videos/songs/MVs/background removal), organize the process in the following order:
- Before creation, obtain standard settings throughcharacter queries, then proceed with image/video/song generation;
- When you need to reverse-analyze creative approaches from existing works, use
read_collectioncombined with the breakdown methods in the reference documentation.
- If during the creation process you find that the need is actually more toward "browsing recommendations/taking a casual look/doing subject research", you can combine
neta-communityorneta-suggestcapabilities for use together.
Command Usage
Content Creation
Generate Image
npx -y @talesofai/neta-skills@latest make_image --prompt "@角色名，/风格元素，参考图-素材uuid，描述词，描述词" --aspect "3:4"
（参考图- and ref_img- prefixes are both acceptable, followed by the UUID of the image asset.)
📖 Detailed Guide - prompt structure, aspect ratio selection, use cases
Generate Video
npx -y @talesofai/neta-skills@latest make_video --image_source "图片 URL" --prompt "动作描述" --model "model_s"
📖 Detailed Guide - action description principles, model selection
Generate Song
npx -y @talesofai/neta-skills@latest make_song --prompt "风格描述" --lyrics "歌词内容"
📖 Detailed Guide - style prompts, lyrics format
Create MV
Combine songs and videos to generate a complete MV.
📖 Detailed Guide - complete workflow
Remove Background
npx -y @talesofai/neta-skills@latest remove_background --input_image "image_artifact_uuid"
Upload Local Image or Video
Register files on disk as Neta assets (including upload and review waiting). Based on the uuid / urlin the output, then use it for make_image（参考图-… / ref_img-…）、make_video（--image_source to fill in URL）、remove_background, or collection-related commands.
npx -y @talesofai/neta-skills@latest upload --file_path "/path/to/file.png"
📖 Media Upload — supported formats, size limits, and correspondence with downstream commands.
Character Query
Search Characters
npx -y @talesofai/neta-skills@latest search_character_or_elementum --keywords "关键词" --parent_type "character" --sort_scheme "exact"
📖 Detailed Guide - search strategy, parameter selection
Get Character Details
npx -y @talesofai/neta-skills@latest request_character_or_elementum --name "角色名"
Query by UUID
npx -y @talesofai/neta-skills@latest request_character_or_elementum --uuid "uuid"
Creative Approach
Get Creative Approach from a Work
npx -y @talesofai/neta-skills@latest read_collection --uuid "作品-uuid"
AP and My Works
AP (Action Points) are consumed with each generation command. Use the following commands to check your balance and review generation records.
AP Balance
npx -y @talesofai/neta-skills@latest get_ap_info
AP Consumption History
npx -y @talesofai/neta-skills@latest get_ap_history --page_size 10
List My Works
npx -y @talesofai/neta-skills@latest list_my_artifacts --page_size 20
npx -y @talesofai/neta-skills@latest list_my_artifacts --modality PICTURE
npx -y @talesofai/neta-skills@latest list_my_artifacts --is_starred true
📖 AP Points Guide · Works Guide
Reference Documentation
| Scenario | Document |
|---|---|
| 🎨 Image Generation | image-generation.md |
| 🎬 Video Generation | video-generation.md |
| 🎵 Song Creation | song-creation.md |
| 🎞️ MV Production | song-mv.md |
| 📤 Local Upload | media-upload.md |
| 👤 Character Query | character-search.md |
| 🖊️ Content Creation Approach | collection-remix.md |
| 💡 AP Points | ap-credits.md |
| 🖼️ My Works | my-artifacts.md |