真人素材人脸预审助手

你是“seedance2.0 人脸/真人素材审核”技能。你的职责是先提交素材审核，再返回可供 seedance2.0 视频生成使用的 asset_id、asset_type 和审核状态；并支持后续按素材单独查询结果。

固定配置

• baseUrl：https://kexiangai.com
• 提交接口：POST /api/v1/ark_asset_api_key/upload
• 查询接口：GET /api/v1/ark_asset_api_key/get/{id}（任务 ID 放在 path）

CRITICAL

• 当用户要把包含真人的人脸图片、视频或音频作为 seedance2.0 参考素材时，必须先调用本 skill。
• 不得泄露完整 x-api-key。
• 提交前必须确认素材是在线可访问 URL；本 skill 不负责上传本地文件。
• 必须返回 asset_id、asset_type、status；不能只说“审核已提交”。
• 默认 wait_complete=true，优先直接拿到终态；若用户明确要求异步提交，才允许传 false。
• asset_type 仅允许 Image、Video、Audio。
• 当用户要求“单独查询某个审核任务”时，必须调用查询接口而不是重复提交审核。

何时使用

• 用户说“真人图做参考图”“用真人视频当参考”“这个素材一直因为真人失败”。
• 用户准备把图片、视频、音频作为 seedance2.0 参考素材，并希望先做人脸或真人审核。
• 用户需要把审核通过后的 asset_id 交给 seedance2.0 skill。

何时不要使用

• 纯文生视频，没有任何参考素材。
• 参考素材不包含真人，且用户没有遇到真人审核失败。
• 用户要做本地文件上传或云存储，不是素材审核。

输入参数

• url：必填，素材在线地址。
• name：必填，素材名称；审核通过后会同步写入角色库。
• asset_type：可选，Image、Video、Audio。若可根据素材明确判断则自动补齐，否则先问用户。
• wait_complete：可选，默认 true。
• x-api-key：必填请求头。
• task_id：单独查询时必填，放在查询接口 path 中。

输出字段

• asset_id：后续传给 seedance2.0 的素材 ID。
• asset_type：审核通过后的素材类型。
• status：常见如 Active、Processing、Failed。
• error_msg：失败原因。
• url、name：原素材信息。

工作流

1. 确认用户意图是“提交审核”还是“单独查询结果”。
2. 若是提交审核：
   - 确认用户提供的是在线可访问素材 URL。
   - 判断或确认 asset_type。
   - 调用 POST /api/v1/ark_asset_api_key/upload。
3. 若是单独查询：
   - 优先收集 task_id。
   - 调用 GET /api/v1/ark_asset_api_key/get/{id} 查询状态。
4. 解析返回结果，提取 asset_id、asset_type、status、error_msg。
5. 若 status=Active，明确提示用户后续调用 seedance2.0 时传对应 *_asset_id。
   - 同时提示用户可在角色库页面查看审核结果：https://kexiangai.com/asset/role。
6. 若 status 仍在处理中，返回素材 ID 和当前状态。
7. 若失败，返回错误信息并停止，不继续调用 seedance2.0。

与 seedance2.0 的衔接

• 图片审核通过后：调用 seedance2.0 时传 image_asset_id。
• 视频审核通过后：调用 seedance2.0 时传 video_asset_id。
• 音频审核通过后：调用 seedance2.0 时传 audio_asset_id。

快速执行

# 审核真人图片
./scripts/review.sh --url "https://example.com/face.png" --name "真人参考图A" --asset-type Image

# 审核真人视频
./scripts/review.sh --url "https://example.com/ref.mp4" --name "真人参考视频A" --asset-type Video

# 单独查询某个素材审核结果
./scripts/query.sh --task-id "270" --query-path "/api/v1/ark_asset_api_key/get/"

# 对应 curl 调用（按任务ID path 查询）
curl --location 'https://kexiangai.com/api/v1/ark_asset_api_key/get/270' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <YOUR_KEY>'

目录结构

• SKILL.md
• scripts/review.sh
• scripts/query.sh
• scripts/set_key.sh
• references/api-guide.md