🚨 Mandatory Pre-check Process (must be executed in order; if any step fails, terminate the process directly)
All user requests must first complete the following Volcano authentication verification and must not be skipped:
- Volcano Authentication Verification
- Read
./references/火山鉴权指南.md, check whether the environment variables have been configured locally (KICKART_ACCESS_KEY/KICKART_SECRET_KEY or ACCESS_KEY_ID/SECRET_ACCESS_KEY) - Not configured: guide the user to complete key configuration according to the guide, and terminate the process
- After configuration: through
core/core.pyoftoken()function, obtain x-muse-token as the credential for subsequent OpenAPI calls
- Read
🎯 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, and must not guess the execution steps out of thin air.
| Task Type | Triggering Intent and Keywords | Execution Basis (mandatory first read) | Output Requirements | Prerequisite Requirements |
|---|---|---|---|---|
| Progress Query | [Highest priority] When the user mentions "query progress," "view results," "how is the generation going," "is it done," or queries the status of a specific task ID. | Read references/任务查询指南.md。⚠️absolutely prohibitedDo not call any script directly without reading the guide, and strictly prohibit the use of any internal poll command not allowed by the guide! |
Output the current task execution status (such as "Task completed," "Task in progress," etc.), and confirm whether adjustment is needed | The corresponding task ID and the template_idused for this submission need to be obtained from the persistent storage of the session context; if there is no valid ID, directly inform the user that no related task was found |
| Material Upload | The user mentions "upload materials," "add images," "add videos," "custom materials" | Read references/素材上传指南.md |
Output the list of successfully uploaded material URLs, confirm material integrity, and then ask about the next requirement | After the task is submitted successfully, automatically persistently store the session ID and material list in the session context |
| Game Video Replication | When the user mentions "game video fission," "game video cloning," "copy game videos," "clone game videos," "same-style game videos," etc., or expresses equivalent intent to create content like a certain popular game video. | Read references/游戏视频复刻指南.md |
Output the download link of the replicated final video, confirm the result, and ask about the next requirement | Required information must be collected step by step strictly according to the guideline Phase 0: reference video (required, MP4/MOV, >5s and ≤60s, ≤50MB, ≥480p), character images (required, 1-10 JPEG/PNG, each ≤8MB, ≥480p), game name (required, ≤500 characters), language (required, must list all languages supported in the guideline for the user to choose, must not omit or make up your own), template ID (required,604911874 Professional mode / 463631106 Advanced mode, choose one of the two, must be explicitly entered by the user, must not be selected by the skill itself or reused from history). Scene reference images (0-3) and creative prompt are optional.The user must not bypass the required steps for any reason; submitting the task is strictly prohibited before completion.🚨 Mandatory secondary confirmation requirement: After completing the collection of all required information and before submitting the task,mustfollow guideline step 8 "Display final video information" and step 9 "Secondary confirmation and compliance notice" to display the final video information to the user and wait for the user's explicit confirmation.This step is mandatory and must not be skipped for any reason, including authentication failure retries, parameter adjustments, or any other reason. Even if the user has completed authentication or previously confirmed, the final video information must be displayed again and user confirmation obtained before each new task submission. |
| Video reference | When the user proactively provides a reference video, video link, or indicates they want to upload a video | Read references/视频参考指南.md |
Obtain a compliant reference video link or material ID to prepare for replication | The primary prerequisite step when the user triggers the game video replication intent |
| Digital avatar | When the user mentions "add model", "custom character", "model on camera", "digital human", "custom model" | Read references/数字形象指南.md |
Obtain a compliant character image media asset ID as the required role_images passed in |
Triggered when the user obtains character images in the game video replication task; character images are required for this task |
⚠️ Error Handling Specification
All errors must clearly inform the cause and an actionable solution; vague prompts are prohibited!!!
General Error Codes
| Error Code | Error Type | Error Description | Detailed Explanation | User Handling Suggestions |
|---|---|---|---|---|
| 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 via the query interface | - |
| 1300 | AuthFailed | Authentication Failed | token is invalid, expired, or not activated | Please check whether the Volcengine authentication AK/SK you provided is correct, you can visitVolcengine Consoleconfirm |
| 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 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 this task's consumption | Please go to Creative Point Recharge Page Recharge Creative Points or upgrade your plan |
| 1403 | QuotaErr | No Permission | The account does not have permission to call this API | Please contact your enterprise administrator to grant access to the relevant services |
| 1500 | InternalErr | Internal Error | An unknown error occurred on the server | Please record the request_id and contact technical support |
API-specific error codes
| Error Code | Error Type | Error Description | Detailed Explanation | Suggested User Action |
|---|---|---|---|---|
| 1410 | TemplateIdNotExist | Template Does Not Exist | The requested template_id is invalid or the corresponding template is not online | Please check whether template_id is 604911874 or 463631106 |
| 1411 | InputResolutionErr | Resolution Error | The resolution is not in the resolutions list supported by the template | Please check whether the resolution parameter is in the list supported by the template |
| 1412 | ImageFormatErr | Image Format Error | The input image format is not supported or the file is corrupted | It is recommended to use common JPEG or PNG formats |
| 1413 | InvalidMediaUrlErr | Invalid Media URL | The URL in ResourceList is inaccessible | Please ensure the URL is publicly accessible and has not expired; we recommend using Volcano Object Storage https://console.volcengine.com/tos |
| 1414 | MediaSensitiveErr | Input Content Triggers Security Review | The input media asset failed the security review | Please replace the materials and try again |
| 1415 | OutputMediaSensitiveErr | Output Contains Sensitive Information | The output result triggers security review | Please adjust the creative strategy or materials and try again |
| 1416 | InvalidMediaCountErr | Media Count Does Not Meet Specifications | The number of character images/scene images does not meet the requirements | Character images must be 1-10, and scene images 0-3 |
| 1417 | ChatCompletionError | Large Model Invocation Error | The underlying large model invocation failed | Please try again later, or contact technical support |
| 1418 | InvalidDurationBillingErr | Duration Billing Parameter Error | The duration parameter does not meet the API input requirements | Please check whether the video duration meets the requirements |
| 1419 | TemplateIdErr | Template ID Error | The template ID is invalid | Please check whether the template_id parameter is 604911874 or 463631106 |
| 1420 | ImageDetectionRulesError | Image Content Detection Matched No Rules | The image content does not meet the template requirements | Please replace the image and try again |
| 1421 | DurationEnumError | Invalid Duration Enum Value in Input | The duration enum value is invalid | Please correct the duration parameter according to the documentation |
| 1423 | VideoResolutionError | Reference Video Resolution Error | The reference video resolution does not meet the requirements | Please use a reference video with a resolution ≥480p |
| 1424 | VideoDurationError | Reference Video Duration Error | The reference video duration does not meet the requirements | The reference video duration must be >5s and ≤60s |
| 1425 | VideoFormatError | Reference Video Format Error | The reference video format is not supported | Please use MP4/MOV format |
| 1426 | VideoSizeError | Reference Video Size Error | The reference video file size exceeds the limit | The reference video size must be ≤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 | Invalid language enum value | The 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 |
| 1429 | ModelImageCountError | The model image_count is inconsistent with the template | The number of images does not match the template | Please adjust the number of images according to the template requirements |
| 1430 | InputRatioError | Incorrect input image aspect ratio | The input image aspect ratio does not meet the requirements | The image aspect ratio must be between (0.4, 2.5) |
| 1431 | CopyrightCheckFailed | Copyright verification failed | Copyright verification did not pass | Please confirm that the material copyright is legitimate |
| 1432 | NoCopyright | The input media asset has no copyright | The input material has no copyright | Please replace it with copyrighted material |
| 1435 | OutputNoCopyright | The output media asset has no copyright | The output result has no copyright | Please adjust the material or strategy and try again |
| 1450 | InputValidationErr | Template input parameter validation failed | message will list the violated fields and rules | Correct according to the prompt and try again |
| 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 maximum processing time set by the system (currently 1 hour) | Please try again later, or contact technical support |
| x01401 | TokenFailed | Token acquisition failed | The current user does not have package permissions. Please contact the administrator to enable it, or visit Kickart package purchase page to subscribe to a package. | |
| 1602 | AsyncTaskCanceled | Task has been canceled | The task has been canceled by the user | - |
| 1603 | AsyncTaskFinished | Task has ended | The task has completed and can no longer be canceled | - |
| 1604 | CancelFailed | Task cancellation failed | The cancellation operation failed | Please try again later |
| 2000 | AsyncTaskFailed | Task execution failed | The task failed during execution | Please troubleshoot based on the detailed reason in message |
| 3000 | TaskCallbackFailed | Callback failed | The callback address is unreachable | Please check whether callback_url is accessible |
📦 Output Directory
- The result JSON of the submitted task is saved by default under
/tmp/openclaw/byted-kickart-game-replicator/output/, named using a millisecond timestamp + random number to avoid concurrent overwrites. - Each task must persistently save
task_idand thetemplate_idused for this submission; when querying progress, both fields must be carried.
📎 References
- API Protocol:
references/kickart接口协议.md - Game Video Replication Guide:
references/游戏视频复刻指南.md - Volcengine Authentication Guide:
references/火山鉴权指南.md - Task Query Guide:
references/任务查询指南.md - Video Reference Guide:
references/视频参考指南.md - Digital Avatar Guide:
references/数字形象指南.md - Material Upload Guide:
references/素材上传指南.md