所有操作通过 scripts/ 目录下的 shell 脚本完成。每个脚本都会加载 scripts/_common.sh，该文件将 CHILLTION_BASE_URL 默认设为 https://chilltion.com，若缺少 CHILLTION_API_KEY 则以退出码 2 终止。
CHILLTION_BASE_URL # 默认 https://chilltion.com；开发时可传入调试地址
CHILLTION_API_KEY # ct_... 格式的密钥，在 Web 应用的 /keys 页面创建
CHILLTION_INSECURE=1 # 可选，内网环境跳过 TLS 验证（需在脚本中添加 -k 参数）
如果用户尚未提供密钥，请在调用前询问。获取密钥的方法：登录 https://chilltion.com，进入 设置 → API 密钥，创建新密钥（以 ct_ 开头）。
GET /api/sessions/{id} 返回：
| 字段 | 类型 | 说明 |
|---|---|---|
| --- | --- | --- |
title | string | 会话标题（用户设置或自动生成） |
video_url | string | 最终合成视频的下载地址；未生成时为空 |
play_url | string | 视频播放页面地址，带签名参数，可直接在浏览器打开播放 |
chat_url | string | 前端对话页面地址，可提出要求修改视频，如 https://chilltion.com/chat/{session_id} |
| 脚本 | 参数 | 端点 |
|---|---|---|
| --- | --- | --- |
scripts/create_session.sh | [mode] [message] | POST /api/sessions — mode 默认为 autonomous；传入 message 后后端会立即开始处理。 |
scripts/stream.sh | | GET /api/chat/{id}/stream（SSE；推送 phase_change / progress / preview_ready / video_ready / done / error）。 |
scripts/send_message.sh | | POST /api/chat/{id}/message — 交互模式下的后续对话。 |
scripts/list_sessions.sh | [offset] [limit] | GET /api/sessions |
scripts/session_detail.sh | | GET /api/sessions/{id} — 返回 video_url（下载地址）、play_url（播放页面地址）和 chat_url（对话页面）。 |
scripts/balance.sh | – | GET /api/credits/balance |
scripts/session_cost.sh | | GET /api/credits/session-cost/{id} |
scripts/credit_log.sh | [offset] [limit] [start] [end] | GET /api/credits/log（日期格式 YYYY-MM-DD） |
所有脚本输出原始 JSON 响应。可使用 jq（或其他 JSON 解析器）提取字段。
自主模式端到端运行，无需额外输入 — 将所有信息写入一条消息：
交互模式适用于需要迭代调整的场景：先创建空会话（scripts/create_session.sh interactive），再通过 scripts/send_message.sh 逐轮发送消息。
# 1) 一次调用创建会话 + 发送首条消息
sid=$(scripts/create_session.sh autonomous "做个 60 秒介绍光合作用的科普视频，3 章节，中文" | jq -r .session_id)
# 2) 流式监听直到 video_ready，然后退出
scripts/stream.sh "$sid" 0 | while IFS= read -r line; do
case "$line" in
data:*)
json="${line#data: }"
type=$(printf '%s' "$json" | jq -r '.type // empty')
case "$type" in
progress) printf '%s\n' "$json" | jq -r '"[progress] \(.progress) \(.message // "")"' ;;
phase_change) printf '%s\n' "$json" | jq -r '"[phase] \(.from) -> \(.to)"' ;;
video_ready) url=$(printf '%s' "$json" | jq -r '.url // .data.url'); play=$(scripts/session_detail.sh "$sid" | jq -r '.play_url'); echo "VIDEO: $url"; echo "PLAY: $play"; break ;;
error) printf '%s\n' "$json" | jq -r '"[error] \(.message)"' >&2; exit 1 ;;
esac
;;
esac
done
progress 事件的 progress 字段通常为 0–100，但偶尔可能为 0–1；展示前请做归一化处理。自主模式中首个 video_ready 即为交付物；后续的（修订阶段）是修改后的版本。
video_url 是视频文件的下载地址（OSS 直链），play_url 是带签名的视频播放页面地址，可直接在浏览器中打开，页面包含视频播放器、标题和轻现AI品牌信息。两者均通过 GET /api/sessions/{id} 获取。
| 状态码 | 含义 |
|---|---|
| --- | --- |
| 401 | 密钥无效或已过期 — 请用户核实 ct_ 密钥 |
| 402 | 积分不足 — 返回 detail.balance 和 detail.required |
| 404 | 会话不存在 — 需重新创建 |
| 409 | 会话正忙 — 请先连接 SSE 观察进度 |
每行格式为 data: {json}，包含顶层 seq 和 type。主要事件类型：
phase_change — from、to（requirements → creative_planning → designing → producing → revision → complete）progress — message、progress（0–100，偶尔 0–1）preview_ready / preview_append — 章节缩略图video_ready — 最终视频地址，位于 url（或 data.url）done — 流结束error — message共 3 个版本