Neta Creative Skill

Used to interact with the Neta API for multimedia content creation, creation‑related character queries, and premium subscription flows where supported.

Instructions

1. For tasks that create or edit concrete assets (images, videos, songs, MVs, background removal), follow this flow:
   • Before creation, use character queries to fetch canonical character settings, then generate images/videos/songs based on them.
   • To reverse‑engineer creative ideas from an existing work, call read_collection and combine the result with the guidance in the reference docs.
2. If, during creation, you discover that the real need is more like “browse recommendations / casually explore / research topics”, combine this skill with neta-community or neta-suggest instead of overloading this skill.
3. Premium (plans, orders, Stripe): use the commands below. Run get_current_premium_plan before and after checkout so the user can confirm tier (and end time if returned). Commerce needs the global Neta API—see the premium reference. If creation is blocked by quota / credits (电量) or usage frequency (频率), say why in one beat; if an upgrade fits their goal, offer the path once (list plans → create order → pay)—do not repeat upgrade nudges in the same conversation unless the user asks.

Commands

Content creation

Generate image

npx -y @talesofai/neta-skills@latest make_image --prompt "@character_name, /elementum_name, ref_img-uuid, description1, description2" --aspect "3:4"

📖 Detailed guide — prompt structure, aspect ratio choices, examples.

Generate video

npx -y @talesofai/neta-skills@latest make_video --image_source "image URL" --prompt "action description" --model "model_s"

📖 Detailed guide — motion description principles, model selection.

Generate song

npx -y @talesofai/neta-skills@latest make_song --prompt "style description" --lyrics "lyrics content"

📖 Detailed guide — style prompts, lyrics format.

Create MV

Combine an audio track and video to create a full MV.

📖 Detailed guide — end‑to‑end workflow.

Remove background

npx -y @talesofai/neta-skills@latest remove_background --input_image "image_artifact_uuid"

Upload local image or video

Registers a file from disk or from an http:// / https:// URL as a Neta artifact (after upload and moderation). Use the returned uuid or url in make_image (ref_img-…), make_video (--image_source URL), remove_background, or collection commands.

npx -y @talesofai/neta-skills@latest upload --file_path "/path/to/file.png"
# or: --file_path "https://example.com/asset.png"

📖 Media upload — supported types, size limits, and how outputs map to each downstream command.

Character queries

Search characters

npx -y @talesofai/neta-skills@latest search_character_or_elementum --keywords "keywords" --parent_type "character" --sort_scheme "exact"

📖 Detailed guide — search strategies and parameter choices.

Get character details

npx -y @talesofai/neta-skills@latest request_character_or_elementum --name "character_name"

Query by UUID

npx -y @talesofai/neta-skills@latest request_character_or_elementum --uuid "uuid"

Creative idea deconstruction

Derive creative ideas from a work

npx -y @talesofai/neta-skills@latest read_collection --uuid "collection-uuid"

📖 Detailed guide

Premium subscription

Current plan (verify before / after upgrade)

npx -y @talesofai/neta-skills@latest get_current_premium_plan

Returns the signed-in user’s current tier (e.g. Basic, Starter, Pro, Master) and subscription end when applicable. Use it before starting checkout to record the baseline, and again after payment or renewal completes so the user can confirm the plan changed as expected.

List plans and SPU UUIDs

npx -y @talesofai/neta-skills@latest list_premium_plans

Create an order

npx -y @talesofai/neta-skills@latest create_premium_order --spu_uuid "spu-uuid"

Get one order

npx -y @talesofai/neta-skills@latest get_premium_order --order_uuid "order-uuid"

List orders (paginated)

npx -y @talesofai/neta-skills@latest list_premium_orders --page_index 0 --page_size 20

Pay an unpaid order (Stripe Checkout)

npx -y @talesofai/neta-skills@latest pay_premium_order --order_uuid "order-uuid" --channel "stripe-checkout"

📖 Premium workflow and limits

Credits & your artifacts

AP (Action Points) is consumed by every generation command. Use these to monitor your balance and review generated output.

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 your generated artifacts

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 credits guide · Artifacts guide

Reference docs

Scenario	Doc
🎨 Image generation	image-generation.md
🎬 Video generation	video-generation.md
🎵 Song generation	song-creation.md
🎞️ MV creation	song-mv.md
📤 Local media upload	media-upload.md
👤 Character queries	character-search.md
🖊️ Creative remixing	collection-remix.md
⭐ Premium / subscribe	premium.md
💡 AP credits	ap-credits.md
🖼️ My artifacts	my-artifacts.md