byted-kickart-marketing-material-generator

Marketing Video Skill

🚨 Mandatory Pre-check Process

All KickArt operations must first complete the CLI availability and OAuth login status checks:

1. KickArt CLI Verification
   • Read references/CLI前置校验指南.md。
   • Use command -v npm to check whether npm exec is available. All commands are invoked through npm exec -y --registry=https://registry.npmjs.org --package @volcengine/kickart-open-mcp@1.1.x kickart-open-cli with a pinned version, with no global or project-level installation required.
   • Run npm exec -y --registry=https://registry.npmjs.org --package @volcengine/kickart-open-mcp@1.1.x kickart-open-cli auth_token >/dev/null to check login status. Displaying, recording, or persisting the token is prohibited.
   • If not yet logged in or if credentials have expired, run npm exec -y --registry=https://registry.npmjs.org --package @volcengine/kickart-open-mcp@1.1.x kickart-open-cli auth_login to obtain the authorization link and display it to the user; this command returns immediately and does not poll the authorization status.
   • After waiting for the user to explicitly confirm that web authorization is complete, run npm exec -y --registry=https://registry.npmjs.org --package @volcengine/kickart-open-mcp@1.1.x kickart-open-cli auth_complete once to obtain the token and complete login, then check login status again; automatic polling or execution before user confirmation is prohibited.
   • If npm exec fails to download the package or the CLI is still unavailable, report the sanitized npm error and terminate the operation.
   • Do not require users to provide long-term keys, do not read or echo OAuth tokens, and do not directly request the OpenAPI.

🎯 Intent Recognition and Task Execution Guide (automatically recognized based on conversation history)

After determining the intent based on the current user input and historical records, you must strictly read and follow the corresponding execution basis guide; do not guess the execution steps out of thin air.

Task Type	Triggering Intent and Keywords	Execution Basis (mandatory first read)	Output Requirements	Prerequisites
Progress Query	[Highest priority] When the user mentions "check progress," "view results," "how is the generation going," "is it done," or queries the status of a specific task ID.	Read references/任务查询指南.md, run npm exec -y --registry=https://registry.npmjs.org --package @volcengine/kickart-open-mcp@1.1.x kickart-open-cli query_task_v2 --task-id <ID> --source kickart_ai_material --auto-publish true。	Parse the stdout JSON and output the current status or result.	The corresponding task ID must be obtained from the session context; if there is no valid ID, directly inform the user that no related task was found.
Standalone Material Ingestion	When the user explicitly requests "upload to KickArt," "create media asset," "save to material library," or "query media asset," and is not providing input materials for a generation task.	Read references/素材上传指南.md, run npm exec -y --registry=https://registry.npmjs.org --package @volcengine/kickart-open-mcp@1.1.x kickart-open-cli material_pipeline_v2 --file-path <绝对路径>。	Output created.media_id from the stdout JSON. origin_url。	Images and videos in generation tasks must not trigger this process; local materials are automatically uploaded by the submission command.
One-Click Video Generation	When the user needs one-click end-to-end generation of a finished video, and mentions "one-click video generation," "generate finished video," "generate marketing video," "submit video generation task," or "generate product video."	Read references/一键成片指南.md, run npm exec -y --registry=https://registry.npmjs.org --package @volcengine/kickart-open-mcp@1.1.x kickart-open-cli submit_marketing_task_v2。	Parse the stdout JSON and output the task ID; subsequently obtain the result through query_task_v2 .	Information must be collected step by step strictly according to Phase 0 of the guide; the model is required: use 978755842 for Seedance 2.5 and 794527234 for Seedance 2.0 mini. In addition, collect material and product information (conditionally required, at least one of the four items), video duration (required, 15/30/45/60 seconds), aspect ratio, language, video purpose, creative instructions, subtitles, subtitle erasure, and visible watermark. All listed optional parameters must be asked about one by one; before submission, the final video information must be displayed, with secondary confirmation and compliance reminders.
Video reference	When the user proactively provides a video, a video link, or indicates an intention to upload a video.	Read references/视频参考指南.md, verify and record the local absolute path or public URL; do not upload in advance.	Obtain the material list that can be directly passed to submit_marketing_task_v2 --user-videos .	Local video formats MP4/MOV, each ≤50MB; maximum 10.

⚠️ Error handling specifications

All errors must clearly inform the reason and an executable solution; vague prompts are prohibited.

Error code	Error type	Error description	Detailed explanation	Suggested user action
0	Success	Task successful	Task processing completed, result has been generated	-
1000	AsyncTaskRunning	Task running	The task is being processed, please poll for the result later	-
1300	AuthFailed	OAuth authentication failed	Login credentials are invalid or expired	Execute in sequence auth_login to obtain the authorization link, wait for the user to complete web authorization, execute auth_complete to complete login; automatic retry of paid submission is prohibited, and before resubmitting, the final video information must be displayed again and secondary confirmation obtained
1400	ParamErr	Parameter error	The request contains invalid or missing parameters	Please check the request body structure, field types, and required fields against the documentation
1401	ConcurrentErr	Concurrency limit exceeded	The current number of concurrent requests exceeds the agreed upper limit	Please reduce the request frequency, or contact the business representative to adjust the concurrency quota
1402	InsufficientPoints	Insufficient credits	The account balance is insufficient to pay for the consumption of this task	Please go to Credits recharge page to recharge credits or upgrade the plan
1403	QuotaErr	No permission	Insufficient plan	Please contact the administrator to enable it, or visit Kickart plan purchase page to subscribe to a plan
1404	QuotaErr	No permission	Insufficient plan	Please contact the administrator to enable it, or visit Kickart plan purchase page to subscribe to a plan
1410	TemplateIdNotExist	Template does not exist	The requested template_id is invalid or the corresponding template is not online	Please confirm whether the template ID is correct (Seedance 2.5: 978755842; Seedance 2.0 mini: 794527234)
1412	ImageFormatErr	Image format error	The input image format is not supported or the file is corrupted	It is recommended to use JPEG or PNG format
1413	InvalidMediaUrlErr	Invalid media URL	The media URL is inaccessible	Please ensure the URL is publicly reachable and has not expired; connecting to Volcano Object Storage is recommended
1418	InvalidDurationBillingErr	Invalid duration parameter	Input duration parameter does not meet the API input requirements	Please check whether the reference video duration meets the requirements (>5 seconds and ≤60 seconds)
1422	GetDouDianProductInfoError	Failed to retrieve product information	The server could not parse the product information from the submitted Douyin Store/Douyin link or product ID	Please confirm that the link is associated with an accessible product, or use a product ID or product image instead; after modification, re-display the final video information and obtain secondary confirmation. Automatic retry is prohibited
1423	VideoResolutionError	Reference video resolution error	Reference video resolution does not meet the requirements	Please check whether the video resolution is ≥480p
1424	VideoDurationError	Reference video duration error	Reference video duration does not meet the requirements	Please check whether the video duration is within the range of >5 seconds and ≤60 seconds
1425	VideoFormatError	Reference video format error	Reference video format is not supported	Please check whether the video format is MP4 or MOV
1426	VideoSizeError	Video size error	The local video file size exceeds the media asset tool limit	Please check whether the video size is ≤50MB
1427	RefVideoError	Reference video link error	The reference video link is invalid or inaccessible	Please check whether the video URL you provided is correct
1428	LanguageEnumError	Language enum value error	The requested language parameter is not in the supported enum list	Please check whether the language parameter is one of the following valid values: zh, en, en-us, pt-br, ja, es-mx, id, ms, tl
1450	InputValidationErr	Template input validation failed	message will list multiple fields and rules	After correcting as prompted, re-display the final video information and obtain secondary confirmation. Automatic retry is prohibited
1500	InternalErr	Internal error	An unknown error occurred on the server	Please record the request_id and contact technical support
1600	AsyncTaskNotExist	Task does not exist	task_id is invalid	Please check whether the task ID is correct
1601	AsyncTaskTimeoutErr	Task timed out	The task execution exceeded the system-defined maximum processing time (currently 1 hour)	Please contact technical support to verify the task status; if a new task needs to be created, the final video information must be re-displayed and secondary confirmation must be obtained
2000	AsyncTaskFailed	Task failed	The task failed during execution	Please check the specific failure reason in message; if a new task needs to be created after correction, the final video information must be re-displayed and secondary confirmation must be obtained
x01401	TokenFailed	Failed to obtain token	The current user does not have package permissions	Please contact the administrator to activate it, or visit Kickart package purchase page to subscribe to a package