Chanjing AI Creation#

When to Use This Skill#

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

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

如果需求更接近“文生数字人”，优先使用 chanjing-text-to-digital-person。

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

Preconditions#

本 Skill 自己包含本地配置和鉴权流程，不依赖其他 skill 的运行时脚本。

本 Skill 使用：

• 配置文件： ~/.chanjing/credentials.json
• 若设置环境变量 CHANJING_CONFIG_DIR：使用 $CHANJING_CONFIG_DIR/credentials.json
• API 基础地址： https://open-api.chanjing.cc（可用 CHANJING_API_BASE 覆盖）

当本地缺少 AK/SK 或 AK/SK 无效时，脚本可能在默认浏览器打开蝉镜官网登录页：

https://www.chanjing.cc/openapi/login

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#

脚本目录：

• scripts/

脚本说明chanjing-config写入/查看本地 app_id 与 secret_key，并清理旧 token 缓存chanjing-get-token从本地凭证获取有效 access_token（必要时自动刷新）_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 文生图

bash

TASK_ID=$(python3 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 scripts/poll_task --unique-id "$TASK_ID"

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

bash

TASK_ID=$(python3 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 scripts/poll_task --unique-id "$TASK_ID"

示例 3：直接透传完整 JSON

bash

python3 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