chanjing-ai-creation

# 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`