轻现AI 视频接口

所有操作通过 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} 返回：

脚本列表

所有脚本输出原始 JSON 响应。可使用 jq（或其他 JSON 解析器）提取字段。

构建提示词

自主模式端到端运行，无需额外输入 — 将所有信息写入一条消息：

• 主题、目标受众、时长（30秒/60秒/90秒）、风格、章节数（2–6）、语言（默认 zh-CN）。

交互模式适用于需要迭代调整的场景：先创建空会话（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\
' "$json" | jq -r '"[progress] \(.progress) \(.message // "")"' ;;
        phase_change) printf '%s\
' "$json" | jq -r '"[phase] \(.from) -> \(.to)"' ;;
        video_ready)  url=$(printf '%s' "$json" | jq -r '.url // .data.url'); echo "VIDEO: $url"; break ;;
        error)        printf '%s\
' "$json" | jq -r '"[error] \(.message)"' >&2; exit 1 ;;
      esac
      ;;
  esac
done

progress 事件的 progress 字段通常为 0–100，但偶尔可能为 0–1；展示前请做归一化处理。自主模式中首个 video_ready 即为交付物；后续的（修订阶段）是修改后的版本。

错误码

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