- 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 自己包含本地配置和鉴权流程，不依赖其他 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 创作的主接口是统一提交器：
- 调用
submit_task提交图片或视频生成任务，得到unique_id - 调用
poll_task轮询直到成功，得到output_url - 如需回看任务参数或错误原因，调用
get_task - 如需看历史记录，调用
list_tasks - 只有在用户明确要求保存到本地时，才调用
download_result
这个 skill 默认做成“通用任务提交器”：
- 对常见图片/视频模型，优先使用脚本提供的通用参数
- 对特殊模型参数，使用
--body-file或--body-json透传完整请求体
Covered APIs
本 Skill 当前覆盖：
POST /open/v1/ai_creation/task/submitPOST /open/v1/ai_creation/task/pageGET /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 文生图
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 图生视频
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
python3 scripts/submit_task \
--body-file ./payload.jsonDownload Rule
下载是显式动作，不是默认动作：
poll_task成功后应先返回远端output_url- 不要自动下载结果文件
- 只有当用户明确表达“下载到本地”“保存到 outputs”“帮我落盘”时，才执行
download_result
Output Convention
默认本地输出目录：
outputs/ai-creation/
Additional Resources
更多接口细节见：
skills/chanjing-ai-creation/reference.mdskills/chanjing-ai-creation/examples.md