| name | neta-creative |
| description | Neta API creative skill — generate images, videos, songs, and MVs, and deconstruct creative ideas from existing works. Use this skill when the user wants to create or edit images/videos/songs/MVs, or create based on character settings and existing works. Do not use it for feed browsing or tag/category research (those are handled by neta-community and neta-suggest). |
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
- 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.
- 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.
- 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"
📖 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
