# Project

Base URL `https://api.sniphunter.com`

项目、素材、脚本、时间线与导出。

# Project


## POST /api/v1/project/projects

创建项目
创建新的项目 (支持 generic, image, video, tool)

```json
{
  "security": [
    {
      "HTTPBearer": []
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/ProjectCreate"
        }
      }
    }
  },
  "responses": {
    "201": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ProjectResponse"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
```


## GET /api/v1/project/projects

获取项目列表
获取当前用户的项目列表

```json
{
  "security": [
    {
      "HTTPBearer": []
    }
  ],
  "parameters": [
    {
      "name": "project_type",
      "in": "query",
      "required": false,
      "schema": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "description": "项目类型过滤",
        "title": "Project Type"
      },
      "description": "项目类型过滤"
    },
    {
      "name": "status",
      "in": "query",
      "required": false,
      "schema": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "description": "状态过滤",
        "title": "Status"
      },
      "description": "状态过滤"
    },
    {
      "name": "page",
      "in": "query",
      "required": false,
      "schema": {
        "type": "integer",
        "minimum": 1,
        "description": "页码",
        "default": 1,
        "title": "Page"
      },
      "description": "页码"
    },
    {
      "name": "page_size",
      "in": "query",
      "required": false,
      "schema": {
        "type": "integer",
        "maximum": 100,
        "minimum": 1,
        "description": "每页数量",
        "default": 20,
        "title": "Page Size"
      },
      "description": "每页数量"
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ProjectListResponse"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
```


## GET /api/v1/project/projects/{project_id}

获取项目详情
获取项目详情（含消息历史和业务数据）

```json
{
  "security": [
    {
      "HTTPBearer": []
    }
  ],
  "parameters": [
    {
      "name": "project_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "integer",
        "title": "Project Id"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ProjectDetailResponse"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
```


## PUT /api/v1/project/projects/{project_id}

更新项目
更新项目基本信息和配置

```json
{
  "security": [
    {
      "HTTPBearer": []
    }
  ],
  "parameters": [
    {
      "name": "project_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "integer",
        "title": "Project Id"
      }
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/ProjectUpdate"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ProjectResponse"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
```


## DELETE /api/v1/project/projects/{project_id}

删除项目
删除项目

```json
{
  "security": [
    {
      "HTTPBearer": []
    }
  ],
  "parameters": [
    {
      "name": "project_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "integer",
        "title": "Project Id"
      }
    }
  ],
  "responses": {
    "204": {
      "description": "Successful Response"
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
```


## GET /api/v1/project/projects/{project_id}/assets

获取项目资产列表
获取项目的资产列表

```json
{
  "security": [
    {
      "HTTPBearer": []
    }
  ],
  "parameters": [
    {
      "name": "project_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "integer",
        "title": "Project Id"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MediaAssetResponse"
            },
            "title": "Response Get Project Assets Api V1 Project Projects  Project Id  Assets Get"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
```


## POST /api/v1/project/projects/{project_id}/assets

添加资产
向项目添加资产

```json
{
  "security": [
    {
      "HTTPBearer": []
    }
  ],
  "parameters": [
    {
      "name": "project_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "integer",
        "title": "Project Id"
      }
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/AddAssetRequest"
        }
      }
    }
  },
  "responses": {
    "201": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/MediaAssetResponse"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
```


## DELETE /api/v1/project/projects/{project_id}/assets/{asset_id}

删除资产
从项目删除资产

```json
{
  "security": [
    {
      "HTTPBearer": []
    }
  ],
  "parameters": [
    {
      "name": "project_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "integer",
        "title": "Project Id"
      }
    },
    {
      "name": "asset_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "title": "Asset Id"
      }
    }
  ],
  "responses": {
    "204": {
      "description": "Successful Response"
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
```


## POST /api/v1/project/projects/{project_id}/chat

发送聊天消息
与 Agent 进行对话

```json
{
  "security": [
    {
      "HTTPBearer": []
    }
  ],
  "parameters": [
    {
      "name": "project_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "integer",
        "title": "Project Id"
      }
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/AgentChatRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/AgentChatResponse"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
```


## POST /api/v1/project/projects/{project_id}/export

导出项目
导出项目 (支持视频导出、图片导出等)

```json
{
  "security": [
    {
      "HTTPBearer": []
    }
  ],
  "parameters": [
    {
      "name": "project_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "integer",
        "title": "Project Id"
      }
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/ProjectExportRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ProjectExportResponse"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
```


## POST /api/v1/project/projects/{project_id}/generate

生成内容
触发内容生成

```json
{
  "security": [
    {
      "HTTPBearer": []
    }
  ],
  "parameters": [
    {
      "name": "project_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "integer",
        "title": "Project Id"
      }
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/AgentGenerateRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/AgentGenerateResponse"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
```


## GET /api/v1/project/projects/{project_id}/scripts

获取脚本列表
获取项目的脚本列表

```json
{
  "security": [
    {
      "HTTPBearer": []
    }
  ],
  "parameters": [
    {
      "name": "project_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "integer",
        "title": "Project Id"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ScriptSegmentResponse"
            },
            "title": "Response Get Project Scripts Api V1 Project Projects  Project Id  Scripts Get"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
```


## PUT /api/v1/project/projects/{project_id}/scripts

更新脚本列表
更新项目的脚本列表

```json
{
  "security": [
    {
      "HTTPBearer": []
    }
  ],
  "parameters": [
    {
      "name": "project_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "integer",
        "title": "Project Id"
      }
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/UpdateScriptsRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ScriptSegmentResponse"
            },
            "title": "Response Update Project Scripts Api V1 Project Projects  Project Id  Scripts Put"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
```


## GET /api/v1/project/projects/{project_id}/timeline

获取时间线
获取项目的时间线

```json
{
  "security": [
    {
      "HTTPBearer": []
    }
  ],
  "parameters": [
    {
      "name": "project_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "integer",
        "title": "Project Id"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/TimelineResponse"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
```


## PUT /api/v1/project/projects/{project_id}/timeline

更新时间线
更新项目的时间线

```json
{
  "security": [
    {
      "HTTPBearer": []
    }
  ],
  "parameters": [
    {
      "name": "project_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "integer",
        "title": "Project Id"
      }
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/UpdateTimelineRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/TimelineResponse"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
```


# Components

```json
{
  "schemas": {
    "AddAssetRequest": {
      "properties": {
        "asset": {
          "$ref": "#/components/schemas/MediaAssetCreate",
          "description": "资产信息"
        }
      },
      "type": "object",
      "required": [
        "asset"
      ],
      "title": "AddAssetRequest",
      "description": "添加资产请求"
    },
    "AgentChatRequest": {
      "properties": {
        "message": {
          "type": "string",
          "minLength": 1,
          "title": "Message",
          "description": "用户消息"
        },
        "attachments": {
          "anyOf": [
            {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Attachments",
          "description": "附件"
        }
      },
      "type": "object",
      "required": [
        "message"
      ],
      "title": "AgentChatRequest",
      "description": "Agent 聊天请求"
    },
    "AgentChatResponse": {
      "properties": {
        "message": {
          "$ref": "#/components/schemas/AgentMessageResponse",
          "description": "Agent 回复"
        },
        "project_status": {
          "type": "string",
          "title": "Project Status",
          "description": "项目状态"
        }
      },
      "type": "object",
      "required": [
        "message",
        "project_status"
      ],
      "title": "AgentChatResponse",
      "description": "Agent 聊天响应"
    },
    "AgentGenerateRequest": {
      "properties": {
        "prompt": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Prompt",
          "description": "生成提示词"
        },
        "config": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Config",
          "description": "生成配置"
        }
      },
      "type": "object",
      "title": "AgentGenerateRequest",
      "description": "Agent 生成请求"
    },
    "AgentGenerateResponse": {
      "properties": {
        "task_id": {
          "type": "string",
          "title": "Task Id",
          "description": "任务ID"
        },
        "status": {
          "type": "string",
          "title": "Status",
          "description": "状态: pending, processing, completed, failed"
        },
        "progress": {
          "type": "integer",
          "title": "Progress",
          "description": "进度百分比",
          "default": 0
        },
        "result": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Result",
          "description": "生成结果"
        }
      },
      "type": "object",
      "required": [
        "task_id",
        "status"
      ],
      "title": "AgentGenerateResponse",
      "description": "Agent 生成响应"
    },
    "AgentMessageResponse": {
      "properties": {
        "role": {
          "type": "string",
          "title": "Role",
          "description": "角色: user, agent, system"
        },
        "content": {
          "type": "string",
          "title": "Content",
          "description": "消息内容"
        },
        "attachments": {
          "anyOf": [
            {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Attachments",
          "description": "附件列表"
        },
        "id": {
          "type": "integer",
          "title": "Id",
          "description": "消息ID"
        },
        "project_id": {
          "type": "integer",
          "title": "Project Id",
          "description": "项目ID"
        },
        "tool_calls": {
          "anyOf": [
            {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Tool Calls",
          "description": "工具调用记录"
        },
        "tool_results": {
          "anyOf": [
            {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Tool Results",
          "description": "工具执行结果"
        },
        "status": {
          "type": "string",
          "title": "Status",
          "description": "状态",
          "default": "completed"
        },
        "created_at": {
          "type": "string",
          "format": "date-time",
          "title": "Created At",
          "description": "创建时间"
        }
      },
      "type": "object",
      "required": [
        "role",
        "content",
        "id",
        "project_id",
        "created_at"
      ],
      "title": "AgentMessageResponse",
      "description": "Agent 消息响应"
    },
    "ClipCreate": {
      "properties": {
        "type": {
          "$ref": "#/components/schemas/ClipType"
        },
        "start": {
          "type": "number",
          "title": "Start",
          "description": "开始时间(秒)"
        },
        "end": {
          "type": "number",
          "title": "End",
          "description": "结束时间(秒)"
        },
        "content": {
          "type": "string",
          "title": "Content",
          "description": "片段内容(文本或资产ID)"
        },
        "thumbnail_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Thumbnail Url",
          "description": "缩略图"
        }
      },
      "type": "object",
      "required": [
        "type",
        "start",
        "end",
        "content"
      ],
      "title": "ClipCreate",
      "description": "创建片段"
    },
    "ClipResponse": {
      "properties": {
        "type": {
          "$ref": "#/components/schemas/ClipType"
        },
        "start": {
          "type": "number",
          "title": "Start",
          "description": "开始时间(秒)"
        },
        "end": {
          "type": "number",
          "title": "End",
          "description": "结束时间(秒)"
        },
        "content": {
          "type": "string",
          "title": "Content",
          "description": "片段内容(文本或资产ID)"
        },
        "thumbnail_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Thumbnail Url",
          "description": "缩略图"
        },
        "id": {
          "type": "string",
          "title": "Id",
          "description": "片段ID"
        }
      },
      "type": "object",
      "required": [
        "type",
        "start",
        "end",
        "content",
        "id"
      ],
      "title": "ClipResponse",
      "description": "片段响应"
    },
    "ClipType": {
      "type": "string",
      "enum": [
        "text",
        "video",
        "audio",
        "image"
      ],
      "title": "ClipType",
      "description": "片段类型"
    },
    "HTTPValidationError": {
      "properties": {
        "detail": {
          "items": {
            "$ref": "#/components/schemas/ValidationError"
          },
          "type": "array",
          "title": "Detail"
        }
      },
      "type": "object",
      "title": "HTTPValidationError"
    },
    "MediaAssetCreate": {
      "properties": {
        "type": {
          "$ref": "#/components/schemas/MediaType"
        },
        "name": {
          "type": "string",
          "title": "Name",
          "description": "资产名称"
        },
        "url": {
          "type": "string",
          "title": "Url",
          "description": "资产URL"
        },
        "thumbnail_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Thumbnail Url",
          "description": "缩略图URL"
        },
        "duration": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Duration",
          "description": "时长(秒)"
        },
        "width": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Width",
          "description": "宽度"
        },
        "height": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Height",
          "description": "高度"
        }
      },
      "type": "object",
      "required": [
        "type",
        "name",
        "url"
      ],
      "title": "MediaAssetCreate",
      "description": "创建媒体资产"
    },
    "MediaAssetResponse": {
      "properties": {
        "type": {
          "$ref": "#/components/schemas/MediaType"
        },
        "name": {
          "type": "string",
          "title": "Name",
          "description": "资产名称"
        },
        "url": {
          "type": "string",
          "title": "Url",
          "description": "资产URL"
        },
        "thumbnail_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Thumbnail Url",
          "description": "缩略图URL"
        },
        "duration": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Duration",
          "description": "时长(秒)"
        },
        "width": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Width",
          "description": "宽度"
        },
        "height": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Height",
          "description": "高度"
        },
        "id": {
          "type": "string",
          "title": "Id",
          "description": "资产ID"
        },
        "created_at": {
          "type": "string",
          "format": "date-time",
          "title": "Created At",
          "description": "创建时间"
        }
      },
      "type": "object",
      "required": [
        "type",
        "name",
        "url",
        "id",
        "created_at"
      ],
      "title": "MediaAssetResponse",
      "description": "媒体资产响应"
    },
    "MediaType": {
      "type": "string",
      "enum": [
        "video",
        "image",
        "audio"
      ],
      "title": "MediaType",
      "description": "媒体类型"
    },
    "ProjectCreate": {
      "properties": {
        "project_type": {
          "type": "string",
          "title": "Project Type",
          "description": "项目类型: image, video"
        },
        "title": {
          "type": "string",
          "maxLength": 200,
          "title": "Title",
          "description": "项目标题"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Description",
          "description": "项目描述"
        },
        "config": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Config",
          "description": "项目配置"
        },
        "initial_message": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Initial Message",
          "description": "初始消息"
        },
        "aspect_ratio": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Aspect Ratio",
          "description": "画面比例 (视频项目)"
        }
      },
      "type": "object",
      "required": [
        "project_type",
        "title"
      ],
      "title": "ProjectCreate",
      "description": "创建项目"
    },
    "ProjectDetailResponse": {
      "properties": {
        "project_type": {
          "type": "string",
          "title": "Project Type",
          "description": "项目类型: image, video"
        },
        "title": {
          "type": "string",
          "maxLength": 200,
          "title": "Title",
          "description": "项目标题"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Description",
          "description": "项目描述"
        },
        "id": {
          "type": "integer",
          "title": "Id",
          "description": "项目ID"
        },
        "user_id": {
          "type": "integer",
          "title": "User Id",
          "description": "用户ID"
        },
        "status": {
          "type": "string",
          "title": "Status",
          "description": "状态",
          "default": "draft"
        },
        "config": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Config",
          "description": "项目配置"
        },
        "result": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Result",
          "description": "生成结果"
        },
        "thumbnail_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Thumbnail Url",
          "description": "缩略图"
        },
        "created_at": {
          "type": "string",
          "format": "date-time",
          "title": "Created At",
          "description": "创建时间"
        },
        "updated_at": {
          "type": "string",
          "format": "date-time",
          "title": "Updated At",
          "description": "更新时间"
        },
        "data": {
          "anyOf": [
            {},
            {
              "type": "null"
            }
          ],
          "title": "Data",
          "description": "反序列化后的项目数据"
        },
        "messages": {
          "items": {
            "$ref": "#/components/schemas/AgentMessageResponse"
          },
          "type": "array",
          "title": "Messages",
          "description": "消息列表"
        }
      },
      "type": "object",
      "required": [
        "project_type",
        "title",
        "id",
        "user_id",
        "created_at",
        "updated_at"
      ],
      "title": "ProjectDetailResponse",
      "description": "项目详情响应（含消息）"
    },
    "ProjectExportRequest": {
      "properties": {
        "format": {
          "type": "string",
          "title": "Format",
          "description": "导出格式: png, jpg, mp4, webm",
          "default": "mp4"
        },
        "quality": {
          "type": "string",
          "title": "Quality",
          "description": "质量: low, medium, high",
          "default": "high"
        },
        "variant_index": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Variant Index",
          "description": "变体索引"
        },
        "resolution": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Resolution",
          "description": "分辨率 (视频项目)"
        },
        "include_captions": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Include Captions",
          "description": "包含字幕"
        }
      },
      "type": "object",
      "title": "ProjectExportRequest",
      "description": "项目导出请求"
    },
    "ProjectExportResponse": {
      "properties": {
        "task_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Task Id",
          "description": "任务ID"
        },
        "status": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Status",
          "description": "任务状态"
        },
        "progress": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Progress",
          "description": "任务进度"
        },
        "download_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Download Url",
          "description": "下载URL"
        },
        "file_size": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "File Size",
          "description": "文件大小"
        },
        "expires_at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time"
            },
            {
              "type": "null"
            }
          ],
          "title": "Expires At",
          "description": "过期时间"
        }
      },
      "type": "object",
      "title": "ProjectExportResponse",
      "description": "项目导出响应"
    },
    "ProjectListResponse": {
      "properties": {
        "projects": {
          "items": {
            "$ref": "#/components/schemas/ProjectResponse"
          },
          "type": "array",
          "title": "Projects",
          "description": "项目列表"
        },
        "total": {
          "type": "integer",
          "title": "Total",
          "description": "总数"
        },
        "page": {
          "type": "integer",
          "title": "Page",
          "description": "当前页",
          "default": 1
        },
        "page_size": {
          "type": "integer",
          "title": "Page Size",
          "description": "每页数量",
          "default": 20
        }
      },
      "type": "object",
      "required": [
        "projects",
        "total"
      ],
      "title": "ProjectListResponse",
      "description": "项目列表响应"
    },
    "ProjectResponse": {
      "properties": {
        "project_type": {
          "type": "string",
          "title": "Project Type",
          "description": "项目类型: image, video"
        },
        "title": {
          "type": "string",
          "maxLength": 200,
          "title": "Title",
          "description": "项目标题"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Description",
          "description": "项目描述"
        },
        "id": {
          "type": "integer",
          "title": "Id",
          "description": "项目ID"
        },
        "user_id": {
          "type": "integer",
          "title": "User Id",
          "description": "用户ID"
        },
        "status": {
          "type": "string",
          "title": "Status",
          "description": "状态",
          "default": "draft"
        },
        "config": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Config",
          "description": "项目配置"
        },
        "result": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Result",
          "description": "生成结果"
        },
        "thumbnail_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Thumbnail Url",
          "description": "缩略图"
        },
        "created_at": {
          "type": "string",
          "format": "date-time",
          "title": "Created At",
          "description": "创建时间"
        },
        "updated_at": {
          "type": "string",
          "format": "date-time",
          "title": "Updated At",
          "description": "更新时间"
        },
        "data": {
          "anyOf": [
            {},
            {
              "type": "null"
            }
          ],
          "title": "Data",
          "description": "反序列化后的项目数据"
        }
      },
      "type": "object",
      "required": [
        "project_type",
        "title",
        "id",
        "user_id",
        "created_at",
        "updated_at"
      ],
      "title": "ProjectResponse",
      "description": "项目响应"
    },
    "ProjectUpdate": {
      "properties": {
        "title": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 200
            },
            {
              "type": "null"
            }
          ],
          "title": "Title",
          "description": "项目标题"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Description",
          "description": "项目描述"
        },
        "config": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Config",
          "description": "项目配置"
        },
        "aspect_ratio": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Aspect Ratio",
          "description": "画面比例"
        },
        "caption_enabled": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Caption Enabled",
          "description": "是否显示字幕"
        }
      },
      "type": "object",
      "title": "ProjectUpdate",
      "description": "更新项目"
    },
    "ScriptSegmentCreate": {
      "properties": {
        "time_start": {
          "type": "number",
          "title": "Time Start",
          "description": "开始时间(秒)"
        },
        "time_end": {
          "type": "number",
          "title": "Time End",
          "description": "结束时间(秒)"
        },
        "text": {
          "type": "string",
          "title": "Text",
          "description": "脚本文本"
        },
        "voice_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Voice Id",
          "description": "配音ID"
        }
      },
      "type": "object",
      "required": [
        "time_start",
        "time_end",
        "text"
      ],
      "title": "ScriptSegmentCreate",
      "description": "创建脚本片段"
    },
    "ScriptSegmentResponse": {
      "properties": {
        "time_start": {
          "type": "number",
          "title": "Time Start",
          "description": "开始时间(秒)"
        },
        "time_end": {
          "type": "number",
          "title": "Time End",
          "description": "结束时间(秒)"
        },
        "text": {
          "type": "string",
          "title": "Text",
          "description": "脚本文本"
        },
        "voice_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Voice Id",
          "description": "配音ID"
        },
        "id": {
          "type": "string",
          "title": "Id",
          "description": "片段ID"
        }
      },
      "type": "object",
      "required": [
        "time_start",
        "time_end",
        "text",
        "id"
      ],
      "title": "ScriptSegmentResponse",
      "description": "脚本片段响应"
    },
    "TimelineCreate": {
      "properties": {
        "duration": {
          "type": "number",
          "title": "Duration",
          "description": "总时长(秒)",
          "default": 0
        },
        "playhead_position": {
          "type": "number",
          "title": "Playhead Position",
          "description": "播放头位置(秒)",
          "default": 0
        },
        "zoom_level": {
          "type": "number",
          "title": "Zoom Level",
          "description": "缩放级别",
          "default": 1.0
        },
        "tracks": {
          "items": {
            "$ref": "#/components/schemas/TrackCreate"
          },
          "type": "array",
          "title": "Tracks",
          "description": "轨道列表"
        }
      },
      "type": "object",
      "title": "TimelineCreate",
      "description": "创建时间线"
    },
    "TimelineResponse": {
      "properties": {
        "duration": {
          "type": "number",
          "title": "Duration",
          "description": "总时长(秒)",
          "default": 0
        },
        "playhead_position": {
          "type": "number",
          "title": "Playhead Position",
          "description": "播放头位置(秒)",
          "default": 0
        },
        "zoom_level": {
          "type": "number",
          "title": "Zoom Level",
          "description": "缩放级别",
          "default": 1.0
        },
        "tracks": {
          "items": {
            "$ref": "#/components/schemas/TrackResponse-Output"
          },
          "type": "array",
          "title": "Tracks",
          "description": "轨道列表"
        }
      },
      "type": "object",
      "title": "TimelineResponse",
      "description": "时间线响应"
    },
    "TrackCreate": {
      "properties": {
        "type": {
          "$ref": "#/components/schemas/TrackType"
        },
        "name": {
          "type": "string",
          "title": "Name",
          "description": "轨道名称"
        },
        "muted": {
          "type": "boolean",
          "title": "Muted",
          "description": "是否静音",
          "default": false
        },
        "locked": {
          "type": "boolean",
          "title": "Locked",
          "description": "是否锁定",
          "default": false
        },
        "clips": {
          "items": {
            "$ref": "#/components/schemas/ClipCreate"
          },
          "type": "array",
          "title": "Clips",
          "description": "片段列表"
        }
      },
      "type": "object",
      "required": [
        "type",
        "name"
      ],
      "title": "TrackCreate",
      "description": "创建轨道"
    },
    "TrackResponse-Output": {
      "properties": {
        "type": {
          "$ref": "#/components/schemas/TrackType"
        },
        "name": {
          "type": "string",
          "title": "Name",
          "description": "轨道名称"
        },
        "muted": {
          "type": "boolean",
          "title": "Muted",
          "description": "是否静音",
          "default": false
        },
        "locked": {
          "type": "boolean",
          "title": "Locked",
          "description": "是否锁定",
          "default": false
        },
        "id": {
          "type": "string",
          "title": "Id",
          "description": "轨道ID"
        },
        "clips": {
          "items": {
            "$ref": "#/components/schemas/ClipResponse"
          },
          "type": "array",
          "title": "Clips",
          "description": "片段列表"
        }
      },
      "type": "object",
      "required": [
        "type",
        "name",
        "id"
      ],
      "title": "TrackResponse",
      "description": "轨道响应"
    },
    "TrackType": {
      "type": "string",
      "enum": [
        "subtitle",
        "video",
        "voiceover",
        "music"
      ],
      "title": "TrackType",
      "description": "轨道类型"
    },
    "UpdateScriptsRequest": {
      "properties": {
        "scripts": {
          "items": {
            "$ref": "#/components/schemas/ScriptSegmentCreate"
          },
          "type": "array",
          "title": "Scripts",
          "description": "脚本列表"
        }
      },
      "type": "object",
      "required": [
        "scripts"
      ],
      "title": "UpdateScriptsRequest",
      "description": "更新脚本请求"
    },
    "UpdateTimelineRequest": {
      "properties": {
        "timeline": {
          "$ref": "#/components/schemas/TimelineCreate",
          "description": "时间线数据"
        }
      },
      "type": "object",
      "required": [
        "timeline"
      ],
      "title": "UpdateTimelineRequest",
      "description": "更新时间线请求"
    },
    "ValidationError": {
      "properties": {
        "loc": {
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "integer"
              }
            ]
          },
          "type": "array",
          "title": "Location"
        },
        "msg": {
          "type": "string",
          "title": "Message"
        },
        "type": {
          "type": "string",
          "title": "Error Type"
        }
      },
      "type": "object",
      "required": [
        "loc",
        "msg",
        "type"
      ],
      "title": "ValidationError"
    }
  },
  "securitySchemes": {
    "HTTPBearer": {
      "type": "http",
      "scheme": "bearer"
    }
  }
}
```