chanjing-ai-creation

name	chanjing-ai-creation
description	Use Chanjing AI creation APIs to submit image or video generation tasks across multiple models, inspect task status, poll async results, and explicitly download generated assets when requested.

Chanjing AI Creation

When to Use This Skill

当用户要做这些事时使用本 Skill：

• 用蝉镜 AI 创作模型生成图片
• 用蝉镜 AI 创作模型生成视频
• 查询 AI 创作任务列表或单个任务详情
• 轮询 AI 创作异步结果
• 在用户明确要求时下载图片或视频到本地

如果需求更接近“文生数字人”，优先使用 chanjing-text-to-digital-person。
如果需求更接近“已有数字人视频合成”，优先使用 chanjing-video-compose。

Preconditions

执行本 Skill 前，必须先通过 chanjing-credentials-guard 完成 AK/SK 与 Token 校验。

本 Skill 与 guard 共用：

• ~/.chanjing/credentials.json
• https://open-api.chanjing.cc

无凭证时，脚本会自动打开蝉镜登录页，并提示配置命令。

Standard Workflow

AI 创作的主接口是统一提交器：

1. 调用 submit_task 提交图片或视频生成任务，得到 unique_id
2. 调用 poll_task 轮询直到成功，得到 output_url
3. 如需回看任务参数或错误原因，调用 get_task
4. 如需看历史记录，调用 list_tasks
5. 只有在用户明确要求保存到本地时，才调用 download_result

这个 skill 默认做成“通用任务提交器”：

• 对常见图片/视频模型，优先使用脚本提供的通用参数
• 对特殊模型参数，使用 --body-file 或 --body-json 透传完整请求体

Covered APIs

本 Skill 当前覆盖：

• POST /open/v1/ai_creation/task/submit
• POST /open/v1/ai_creation/task/page
• GET /open/v1/ai_creation/task

Scripts

脚本目录：

• skills/chanjing-ai-creation/scripts/

脚本	说明
_auth.py	读取凭证、获取或刷新 access_token
submit_task	提交 AI 创作任务，输出 unique_id
get_task	获取单个任务详情
list_tasks	列出图片或视频任务
poll_task	轮询任务直到完成，默认输出第一个结果地址
download_result	下载图片或视频到 outputs/ai-creation/

Usage Examples

示例 1：Seedream 3.0 文生图

TASK_ID=$(python3 skills/chanjing-ai-creation/scripts/submit_task \
  --creation-type 3 \
  --model-code "doubao-seedream-3.0-t2i" \
  --prompt "赛博朋克城市夜景，霓虹灯，雨夜，电影镜头" \
  --aspect-ratio "16:9" \
  --clarity 2048 \
  --number-of-images 1)

python3 skills/chanjing-ai-creation/scripts/poll_task --unique-id "$TASK_ID"

示例 2：腾讯 Kling v2.1 Master 图生视频

TASK_ID=$(python3 skills/chanjing-ai-creation/scripts/submit_task \
  --creation-type 4 \
  --model-code "tx_kling-v2-1-master" \
  --ref-img-url "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/start.jpg" \
  --ref-img-url "https://res.chanjing.cc/chanjing/res/aigc_creation/photo/end.jpg" \
  --prompt "角色从静止到转身，镜头平滑移动，叙事感强" \
  --aspect-ratio "9:16" \
  --clarity 1080 \
  --quality-mode pro \
  --video-duration 5)

python3 skills/chanjing-ai-creation/scripts/poll_task --unique-id "$TASK_ID"

示例 3：直接透传完整 JSON

python3 skills/chanjing-ai-creation/scripts/submit_task \
  --body-file ./payload.json

Download Rule

下载是显式动作，不是默认动作：

• poll_task 成功后应先返回远端 output_url
• 不要自动下载结果文件
• 只有当用户明确表达“下载到本地”“保存到 outputs”“帮我落盘”时，才执行 download_result

Output Convention

默认本地输出目录：

• outputs/ai-creation/

Additional Resources

更多接口细节见：

• skills/chanjing-ai-creation/reference.md
• skills/chanjing-ai-creation/examples.md