Skip to content

works.md

Latest commit

 

History

History
292 lines (251 loc) · 10 KB

works.md

File metadata and controls

292 lines (251 loc) · 10 KB
Raw

works（用户作品表）

用户作品表，存储用户创作的作品信息，合并了原创造表和作品表的功能。

字段说明

字段 类型 说明
id INTEGER 内部主键
work_id VARCHAR(32) 作品ID（年月日时分秒毫秒+8位随机字母数字）
user_uuid VARCHAR(36) 用户UUID（外键关联用户表）
points_consumed FLOAT 消耗积分值
models JSON 模型信息（JSON数组）
content TEXT 创造文本内容
extra_info TEXT 其他信息
creation_type ENUM 创作类型（TEXT/VIDEO/IMAGE/COPYWRITING/OTHER）
time_tag VARCHAR(8) 时间标签（格式：YYYYMMDD）
result_info JSON 作品成果信息（JSON数组）
tags JSON 作品标签（JSON数组）
status ENUM 作品状态（QUEUING/CREATING/COMPLETED/CANCELED/FAILED/INVALID）
is_deleted INTEGER 软删除标记(0-未删除,1-已删除)
created_at BIGINT 创建时间（毫秒时间戳）
updated_at BIGINT 更新时间（毫秒时间戳）

作品状态枚举

枚举值 说明
QUEUING 排队中
CREATING 创造中
COMPLETED 已完成
CANCELED 已取消
FAILED 失败
INVALID 已失效

创作类型枚举

枚举值 说明
TEXT 文本
VIDEO 视频
IMAGE 图片
COPYWRITING 文案
OTHER 其他

索引

索引名 字段 说明
idx_work_id work_id 唯一索引，加速按作品ID查询
idx_user_uuid user_uuid 加速按用户UUID查询
idx_status status 加速按状态查询
idx_creation_type creation_type 加速按创作类型查询
idx_time_tag time_tag 加速按时间标签查询
idx_deleted_status is_deleted, status 加速按删除状态和状态的复合查询

API接口

接口 方法 说明 权限
/work/create POST 创建作品 登录用户
/work/list POST 查询作品列表 登录用户
/work/detail POST 查询作品详情 登录用户
/work/update POST 更新作品 登录用户
/work/delete POST 删除作品 登录用户

接口详情

创建作品 /work/create

请求：

{
    "points_consumed": 10.0,
    "models": [1, 2],
    "content": "生成一只猫的图片",
    "extra_info": "",
    "creation_type": "IMAGE",
    "tags": ["猫", "动物"]
}

响应：

{
    "state": 200,
    "message": "作品创建成功",
    "data": {
        "id": 1,
        "work_id": "20260426123456789ABC1234",
        "user_uuid": "123e4567-e89b-12d3-a456-426614174000",
        "points_consumed": 10.0,
        "models": [1, 2],
        "content": "生成一只猫的图片",
        "extra_info": "",
        "creation_type": "IMAGE",
        "time_tag": "20260426",
        "result_info": [],
        "tags": ["猫", "动物"],
        "status": "QUEUING",
        "is_deleted": 0,
        "created_at": 1745568000000,
        "updated_at": 1745568000000
    }
}

查询作品列表 /work/list

请求：

{
    "creation_type": "IMAGE",
    "status": "COMPLETED",
    "time_tag": "20260426",
    "page": 1,
    "page_size": 10
}

响应：

{
    "state": 200,
    "message": "查询成功",
    "data": {
        "list": [
            {
                "id": 1,
                "work_id": "20260426123456789ABC1234",
                "user_uuid": "123e4567-e89b-12d3-a456-426614174000",
                "points_consumed": 10.0,
                "models": [1, 2],
                "content": "生成一只猫的图片",
                "extra_info": "",
                "creation_type": "IMAGE",
                "time_tag": "20260426",
                "result_info": ["/uploads/productions/20260426123456789ABC1234/cat.png"],
                "tags": ["猫", "动物"],
                "status": "COMPLETED",
                "is_deleted": 0,
                "created_at": 1745568000000,
                "updated_at": 1745568001000
            }
        ],
        "total": 1,
        "page": 1,
        "page_size": 10,
        "pages": 1
    }
}

查询作品详情 /work/detail

请求（内部ID）：

{
    "id": 1
}

请求（外部ID）：

{
    "work_id": "20260426123456789ABC1234"
}

响应：

{
    "state": 200,
    "message": "查询成功",
    "data": {
        "id": 1,
        "work_id": "20260426123456789ABC1234",
        "user_uuid": "123e4567-e89b-12d3-a456-426614174000",
        "points_consumed": 10.0,
        "models": [1, 2],
        "content": "生成一只猫的图片",
        "extra_info": "",
        "creation_type": "IMAGE",
        "time_tag": "20260426",
        "result_info": ["/uploads/productions/20260426123456789ABC1234/cat.png"],
        "tags": ["猫", "动物"],
        "status": "COMPLETED",
        "is_deleted": 0,
        "created_at": 1745568000000,
        "updated_at": 1745568001000
    }
}

更新作品 /work/update

请求：

{
    "id": 1,
    "status": "COMPLETED",
    "result_info": ["/uploads/productions/20260426123456789ABC1234/cat.png"],
    "tags": ["猫", "动物", "可爱"]
}

响应：

{
    "state": 200,
    "message": "作品更新成功",
    "data": {
        "id": 1,
        "work_id": "20260426123456789ABC1234",
        "user_uuid": "123e4567-e89b-12d3-a456-426614174000",
        "points_consumed": 10.0,
        "models": [1, 2],
        "content": "生成一只猫的图片",
        "extra_info": "",
        "creation_type": "IMAGE",
        "time_tag": "20260426",
        "result_info": ["/uploads/productions/20260426123456789ABC1234/cat.png"],
        "tags": ["猫", "动物", "可爱"],
        "status": "COMPLETED",
        "is_deleted": 0,
        "created_at": 1745568000000,
        "updated_at": 1745568002000
    }
}

删除作品 /work/delete

请求：

{
    "id": 1
}

响应：

{
    "state": 200,
    "message": "作品删除成功"
}