LumenX API 集成开发指南

LumenX 提供完整的 REST API，可集成到自有系统中。

API 基础

• 基础地址: http://localhost:17177
• 文档: http://localhost:17177/docs（Swagger UI）
• 认证: API Key 或在设置中配置

核心接口

生成视频

POST /api/v1/generate
Content-Type: application/json

{
  "script": "小说文本内容...",
  "style": "写实",
  "characters": ["林小雨", "张明"],
  "scenes": ["咖啡馆", "公园"]
}

查询状态

GET /api/v1/tasks/{task_id}

获取结果

GET /api/v1/tasks/{task_id}/output

Webhook 通知

支持任务完成时回调：

{
  "webhook_url": "https://your-server.com/callback",
  "webhook_events": ["task.completed", "task.failed"]
}

批量集成

通过 API 可以将 LumenX 嵌入内容管理系统，实现小说→视频的全自动流水线。