轻现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} 返回：

| 字段 | 类型 | 说明 | |---|---|---| | video_url | string | 最终合成视频的 OSS 地址；未生成时为空 | | chat_url | string | 前端对话页面地址，如 https://chilltion.com/chat/{session_id} |

脚本列表

| 脚本 | 参数 | 端点 | |---|---|---| | scripts/create_session.sh | [mode] [message] | POST /api/sessions — mode 默认为 autonomous；传入 message 后后端会立即开始处理。 | | scripts/stream.sh | <session_id> [from_seq] | GET /api/chat/{id}/stream（SSE；推送 phase_change / progress / preview_ready / video_ready / done / error）。 | | scripts/send_message.sh | <session_id> <content> | POST /api/chat/{id}/message — 交互模式下的后续对话。 | | scripts/list_sessions.sh | [offset] [limit] | GET /api/sessions | | scripts/session_detail.sh | <session_id> | GET /api/sessions/{id} — 返回 video_url（OSS）和 chat_url（前端页面）。 | | scripts/balance.sh | – | GET /api/credits/balance | | scripts/session_cost.sh | <session_id> | GET /api/credits/session-cost/{id} | | scripts/credit_log.sh | [offset] [limit] [start] [end] | GET /api/credits/log（日期格式 YYYY-MM-DD） |

所有脚本输出原始 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\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'); echo "VIDEO: $url"; break ;;
        error)        printf '%s\n' "$json" | jq -r '"[error] \(.message)"' >&2; exit 1 ;;
      esac
      ;;
  esac
done

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

错误码

| 状态码 | 含义 | |---|---| | 401 | 密钥无效或已过期 — 请用户核实 ct_ 密钥 | | 402 | 积分不足 — 返回 detail.balance 和 detail.required | | 404 | 会话不存在 — 需重新创建 | | 409 | 会话正忙 — 请先连接 SSE 观察进度 |

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