{"openapi":"3.0.3","info":{"title":"AIMIX Open API","version":"1.0.0"},"servers":[{"url":"https://aihub.aimix.pro"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"视频处理"}],"paths":{"/open-api/v1/video-process/submit":{"post":{"tags":["视频处理"],"summary":"提交视频处理任务","description":"提交视频处理任务，支持去重、基础合成、专业合成三种类型。根据 taskType 选择不同的参数结构。","parameters":[{"name":"X-API-Key","in":"header","required":true,"schema":{"type":"string"},"description":"API Key 认证"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoProcessSubmitReq"}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitTaskResp"}}}}},"operationId":"submitVideoProcessTask"}},"/open-api/v1/video-process/status/{taskNo}":{"get":{"tags":["视频处理"],"summary":"查询任务状态","description":"根据任务编号查询任务处理状态和进度","parameters":[{"name":"X-API-Key","in":"header","required":true,"schema":{"type":"string"},"description":"API Key 认证"},{"name":"taskNo","in":"path","required":true,"schema":{"type":"string"},"description":"任务编号"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskStatusResp"}}}}},"operationId":"getVideoProcessTaskStatus"}},"/open-api/v1/video-process/list":{"get":{"tags":["视频处理"],"summary":"查询任务列表","description":"分页查询当前用户的任务列表","parameters":[{"name":"X-API-Key","in":"header","required":true,"schema":{"type":"string"},"description":"API Key 认证"},{"name":"pageNo","in":"query","schema":{"type":"integer","default":1},"description":"页码"},{"name":"pageSize","in":"query","schema":{"type":"integer","default":10},"description":"每页数量"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}},"operationId":"listVideoProcessTasks"}},"/open-api/v1/video-process/balance":{"get":{"tags":["视频处理"],"summary":"查询点数余额","description":"查询当前用户的剩余点数","parameters":[{"name":"X-API-Key","in":"header","required":true,"schema":{"type":"string"},"description":"API Key 认证"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}},"operationId":"getVideoProcessBalance"}},"/open-api/v1/video-process/records":{"get":{"tags":["视频处理"],"summary":"查询消耗记录","description":"分页查询当前用户的点数消耗记录","parameters":[{"name":"X-API-Key","in":"header","required":true,"schema":{"type":"string"},"description":"API Key 认证"},{"name":"pageNo","in":"query","schema":{"type":"integer","default":1},"description":"页码"},{"name":"pageSize","in":"query","schema":{"type":"integer","default":10},"description":"每页数量"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}},"operationId":"listVideoProcessRecords"}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}},"schemas":{"VideoProcessSubmitReq":{"oneOf":[{"$ref":"#/components/schemas/VideoDeduplicationReq"},{"$ref":"#/components/schemas/BaseVideoMixReq"},{"$ref":"#/components/schemas/ProVideoMixReq"}],"discriminator":{"propertyName":"taskType","mapping":{"videoDeduplication":"#/components/schemas/VideoDeduplicationReq","baseVideoMix":"#/components/schemas/BaseVideoMixReq","proVideoMix":"#/components/schemas/ProVideoMixReq"}}},"VideoDeduplicationReq":{"type":"object","required":["taskType","params"],"description":"视频去重任务","properties":{"taskType":{"type":"string","enum":["videoDeduplication"],"description":"任务类型：视频去重"},"params":{"type":"object","required":["videoList"],"description":"去重任务参数","properties":{"videoList":{"type":"array","description":"待去重的视频列表","items":{"type":"object","required":["filename","duration"],"properties":{"filename":{"type":"string","description":"视频URL","example":"https://cdn.example.com/video1.mp4"},"duration":{"type":"number","description":"视频时长（秒）","example":30.5}}}},"options":{"type":"object","description":"去重效果选项","properties":{"isMirror":{"type":"boolean","description":"是否镜像翻转","default":false},"isFilter":{"type":"boolean","description":"是否启用滤镜","default":false},"fps":{"type":"integer","description":"输出帧率","enum":[25,30,50,60],"default":30},"frameExtraction":{"type":"object","description":"随机抽帧","properties":{"isExtract":{"type":"boolean","description":"是否启用","default":false},"start":{"type":"number","description":"起始帧率，范围 25~30","minimum":25,"maximum":30,"default":25},"end":{"type":"number","description":"结束帧率，范围 25~30","minimum":25,"maximum":30,"default":30}}},"speed":{"type":"object","description":"随机变速","properties":{"isSpeed":{"type":"boolean","description":"是否启用","default":false},"start":{"type":"number","description":"起始倍速，范围 0.5~2.0，步长 0.1","minimum":0.5,"maximum":2,"default":1},"end":{"type":"number","description":"结束倍速，范围 0.5~2.0，步长 0.1","minimum":0.5,"maximum":2,"default":1.5}}},"rotation":{"type":"object","description":"随机旋转","properties":{"isRotate":{"type":"boolean","description":"是否启用","default":false},"direction":{"type":"string","description":"旋转方向","enum":["clockwise","counterclockwise"],"default":"clockwise"},"minAngle":{"type":"number","description":"最小角度（度），范围 0~180","minimum":0,"maximum":180,"default":0},"maxAngle":{"type":"number","description":"最大角度（度），范围 0~180","minimum":0,"maximum":180,"default":2}}},"zoom":{"type":"object","description":"随机缩放","properties":{"isZoom":{"type":"boolean","description":"是否启用","default":false},"minScale":{"type":"number","description":"最小缩放倍数，范围 1.0~2.0，步长 0.1","minimum":1,"maximum":2,"default":1},"maxScale":{"type":"number","description":"最大缩放倍数，范围 1.0~2.0，步长 0.1","minimum":1,"maximum":2,"default":1.1}}},"colourMixing":{"type":"object","description":"调色","properties":{"isMixing":{"type":"boolean","description":"是否启用","default":false},"brightnessMin":{"type":"number","description":"亮度最小值，范围 -1.0~1.0，步长 0.1","minimum":-1,"maximum":1,"default":-0.1},"brightnessMax":{"type":"number","description":"亮度最大值，范围 -1.0~1.0，步长 0.1","minimum":-1,"maximum":1,"default":0.1},"contrastMin":{"type":"number","description":"对比度最小值，范围 -2.0~2.0，步长 0.1","minimum":-2,"maximum":2,"default":0.9},"contrastMax":{"type":"number","description":"对比度最大值，范围 -2.0~2.0，步长 0.1","minimum":-2,"maximum":2,"default":1.1},"saturationMin":{"type":"number","description":"饱和度最小值，范围 0.0~3.0，步长 0.1","minimum":0,"maximum":3,"default":0.9},"saturationMax":{"type":"number","description":"饱和度最大值，范围 0.0~3.0，步长 0.1","minimum":0,"maximum":3,"default":1.1},"gammaMin":{"type":"number","description":"伽马最小值，范围 0.1~10.0，步长 0.1","minimum":0.1,"maximum":10,"default":0.9},"gammaMax":{"type":"number","description":"伽马最大值，范围 0.1~10.0，步长 0.1","minimum":0.1,"maximum":10,"default":1.1}}},"hueMixing":{"type":"object","description":"色相调整","properties":{"isMixing":{"type":"boolean","description":"是否启用","default":false},"h":{"type":"number","description":"色相偏移，范围 0~360，步长 0.1","minimum":0,"maximum":360,"default":0},"s":{"type":"number","description":"饱和度偏移，范围 0~1，步长 0.1","minimum":0,"maximum":1,"default":0},"b":{"type":"number","description":"亮度偏移，范围 0~1，步长 0.1","minimum":0,"maximum":1,"default":0}}},"colorBalance":{"type":"object","description":"色彩平衡","properties":{"isBalance":{"type":"boolean","description":"是否启用","default":false},"rs":{"type":"number","description":"红色阴影，范围 0~1，步长 0.1","minimum":0,"maximum":1,"default":0},"gs":{"type":"number","description":"绿色阴影，范围 0~1，步长 0.1","minimum":0,"maximum":1,"default":0},"bs":{"type":"number","description":"蓝色阴影，范围 0~1，步长 0.1","minimum":0,"maximum":1,"default":0},"rh":{"type":"number","description":"红色高光，范围 0~1，步长 0.1","minimum":0,"maximum":1,"default":0},"gh":{"type":"number","description":"绿色高光，范围 0~1，步长 0.1","minimum":0,"maximum":1,"default":0},"bh":{"type":"number","description":"蓝色高光，范围 0~1，步长 0.1","minimum":0,"maximum":1,"default":0},"rm":{"type":"number","description":"红色中间调，范围 0~1，步长 0.1","minimum":0,"maximum":1,"default":0},"gm":{"type":"number","description":"绿色中间调，范围 0~1，步长 0.1","minimum":0,"maximum":1,"default":0},"bm":{"type":"number","description":"蓝色中间调，范围 0~1，步长 0.1","minimum":0,"maximum":1,"default":0}}},"picMask":{"type":"object","description":"图片蒙层","properties":{"isMask":{"type":"boolean","description":"是否启用","default":false},"picFiles":{"type":"array","description":"蒙层图片URL列表","items":{"type":"string"}},"layerCount":{"type":"integer","description":"蒙层层数，范围 0~10","minimum":0,"maximum":10,"default":1},"trans":{"type":"number","description":"透明度，范围 1~100","minimum":1,"maximum":100,"default":3}}},"videoMask":{"type":"object","description":"视频蒙层","properties":{"isMask":{"type":"boolean","description":"是否启用","default":false},"videoFiles":{"type":"array","description":"蒙层视频URL列表","items":{"type":"string"}},"layerCount":{"type":"integer","description":"蒙层层数，范围 0~10","minimum":0,"maximum":10,"default":1},"trans":{"type":"number","description":"透明度，范围 1~100","minimum":1,"maximum":100,"default":3}}},"effect":{"type":"object","description":"特效","properties":{"value":{"type":"string","description":"特效名称"},"trans":{"type":"number","description":"透明度，范围 1~100","minimum":1,"maximum":100,"default":3},"duration":{"type":"number","description":"特效时长（秒），范围 0~60","minimum":0,"maximum":60,"default":0.5},"position":{"type":"number","description":"特效位置，范围 0~100（百分比）","minimum":0,"maximum":100,"default":0}}},"PIP":{"type":"object","description":"画中画","properties":{"isPIP":{"type":"boolean","description":"是否启用","default":false},"padding":{"type":"number","description":"内边距（百分比），范围 1~80","minimum":1,"maximum":80,"default":10},"fillMode":{"type":"integer","description":"填充模式：1=背景填充, 2=模糊填充","enum":[1,2],"default":2},"fillVideoPath":{"type":"string","description":"填充视频URL"}}}}}}},"callbackUrl":{"type":"string","description":"任务完成后的回调通知URL"},"clientTaskId":{"type":"string","description":"客户端任务ID，用于幂等校验，避免重复提交"}}},"BaseVideoMixReq":{"type":"object","required":["taskType","params"],"description":"基础视频合成任务","properties":{"taskType":{"type":"string","enum":["baseVideoMix"],"description":"任务类型：基础视频合成"},"params":{"type":"object","required":["videoList"],"description":"基础合成任务参数","properties":{"videoList":{"type":"array","description":"视频组合列表，每个元素代表一组分镜视频，最多100组","items":{"type":"object","properties":{"videos":{"type":"array","description":"分镜视频列表，每组最多100个","items":{"type":"object","properties":{"url":{"type":"string","description":"视频URL"},"duration":{"type":"number","description":"时长（秒）"},"sceneName":{"type":"string","description":"分镜名称"}}}},"totalDuration":{"type":"number","description":"该组合总时长（秒），最大600秒"}}}},"isShortest":{"type":"boolean","description":"是否按最短视频时长截断所有视频","default":false},"options":{"type":"object","description":"合成选项","properties":{"resolution":{"type":"string","description":"输出分辨率","enum":["720:1280","1080:1920","1280:720","1920:1080"],"default":"720:1280"},"resolutionMode":{"type":"string","description":"铺满模式：none=默认, crop=等比例缩放, stretch=拉伸","enum":["none","crop","stretch"],"default":"none"},"fps":{"type":"integer","description":"输出帧率","enum":[25,30,50,60],"default":30},"backgroundMusic":{"type":"object","description":"背景音乐","properties":{"url":{"type":"string","description":"音乐文件URL"},"fileName":{"type":"string","description":"文件名"},"duration":{"type":"number","description":"时长（秒），最大600","maximum":600},"volume":{"type":"integer","description":"音量，范围 0~100","minimum":0,"maximum":100,"default":80},"fadeIn":{"type":"number","description":"淡入时长（秒），范围 0~10","minimum":0,"maximum":10,"default":0.5},"fadeOut":{"type":"number","description":"淡出时长（秒），范围 0~10","minimum":0,"maximum":10,"default":0.5}}},"audio":{"type":"object","description":"配音轨道","properties":{"url":{"type":"string","description":"音频文件URL"},"fileName":{"type":"string","description":"文件名"},"duration":{"type":"number","description":"时长（秒），最大600","maximum":600},"volume":{"type":"integer","description":"音量，范围 0~100","minimum":0,"maximum":100,"default":80},"fadeIn":{"type":"number","description":"淡入时长（秒），范围 0~10","minimum":0,"maximum":10,"default":0.5},"fadeOut":{"type":"number","description":"淡出时长（秒），范围 0~10","minimum":0,"maximum":10,"default":0.5}}},"subtitle":{"type":"object","description":"字幕","properties":{"url":{"type":"string","description":"字幕文件URL（SRT/VTT格式）"},"fileName":{"type":"string","description":"文件名"},"style":{"type":"object","description":"字幕样式","properties":{"fontSize":{"type":"integer","description":"字号","enum":[10,11,12,13,14,15,16,17,18],"default":14},"fontColor":{"type":"string","description":"字体颜色（HEX），如 #FFFFFF","default":"#FFFFFF"},"outlineColor":{"type":"string","description":"描边颜色（HEX），如 #000000"},"backColor":{"type":"string","description":"背景颜色（HEX），如 #000000"},"bottom":{"type":"integer","description":"底部距离（像素），范围 0~1000","minimum":0,"maximum":1000,"default":50},"magnification":{"type":"number","description":"放大倍数，范围 0.1~5.0","minimum":0.1,"maximum":5,"default":2.5}}}}}}}}},"callbackUrl":{"type":"string","description":"任务完成后的回调通知URL"},"clientTaskId":{"type":"string","description":"客户端任务ID，用于幂等校验，避免重复提交"}}},"ProVideoMixReq":{"type":"object","required":["taskType","params"],"description":"专业视频合成任务","properties":{"taskType":{"type":"string","enum":["proVideoMix"],"description":"任务类型：专业视频合成"},"params":{"type":"object","required":["scenes","audioMode","generateCount"],"description":"专业合成任务参数","properties":{"scenes":{"type":"array","description":"分镜定义列表，最多100个分镜","items":{"type":"object","required":["sceneKey","sceneName","duration","resources"],"properties":{"sceneKey":{"type":"string","description":"分镜唯一标识"},"sceneName":{"type":"string","description":"分镜名称"},"duration":{"type":"number","description":"分镜时长（秒）"},"resources":{"type":"array","description":"视频资源列表，每个分镜最多100个资源，系统会从中随机选取生成不同组合","items":{"type":"object","properties":{"key":{"type":"string","description":"资源标识"},"url":{"type":"string","description":"视频URL"},"duration":{"type":"number","description":"时长（秒）"}}}},"audioResources":{"type":"array","description":"音频资源列表","items":{"type":"object","properties":{"url":{"type":"string","description":"音频URL"},"duration":{"type":"number","description":"时长（秒）"},"startTime":{"type":"number","description":"起始时间（秒）"}}}}}}},"audioMode":{"type":"string","description":"音频模式：merge=合并音频, split=分离音频","enum":["merge","split"]},"generateCount":{"type":"integer","description":"生成视频数量，最大5","maximum":5},"combinations":{"type":"array","description":"手动指定资源组合，二维数组，值为各分镜 resources 的索引。不传则由系统随机组合","items":{"type":"array","items":{"type":"integer"}}},"options":{"type":"object","description":"合成选项","properties":{"resolution":{"type":"string","description":"输出分辨率","enum":["720:1280","1080:1920","1280:720","1920:1080"],"example":"1920:1080"},"resolutionMode":{"type":"string","description":"铺满模式：none=默认, crop=等比例缩放, stretch=拉伸","enum":["none","crop","stretch"],"default":"none"},"fps":{"type":"integer","description":"输出帧率","enum":[25,30,50,60],"default":30},"isShortest":{"type":"boolean","description":"是否按最短视频时长截断","default":false},"backgroundMusic":{"type":"object","description":"背景音乐","properties":{"url":{"type":"string","description":"音乐文件URL"},"fileName":{"type":"string","description":"文件名"},"duration":{"type":"number","description":"时长（秒），最大600","maximum":600},"volume":{"type":"integer","description":"音量，范围 0~100","minimum":0,"maximum":100,"default":80},"fadeIn":{"type":"number","description":"淡入时长（秒），范围 0~10","minimum":0,"maximum":10,"default":0.5},"fadeOut":{"type":"number","description":"淡出时长（秒），范围 0~10","minimum":0,"maximum":10,"default":0.5}}},"audio":{"type":"object","description":"配音轨道","properties":{"url":{"type":"string","description":"音频文件URL"},"fileName":{"type":"string","description":"文件名"},"duration":{"type":"number","description":"时长（秒），最大600","maximum":600},"volume":{"type":"integer","description":"音量，范围 0~100","minimum":0,"maximum":100,"default":80},"fadeIn":{"type":"number","description":"淡入时长（秒），范围 0~10","minimum":0,"maximum":10,"default":0.5},"fadeOut":{"type":"number","description":"淡出时长（秒），范围 0~10","minimum":0,"maximum":10,"default":0.5}}},"subtitle":{"type":"object","description":"字幕","properties":{"url":{"type":"string","description":"字幕文件URL（SRT/VTT格式）"},"fileName":{"type":"string","description":"文件名"},"style":{"type":"object","description":"字幕样式","properties":{"fontSize":{"type":"integer","description":"字号","enum":[10,11,12,13,14,15,16,17,18],"default":14},"fontColor":{"type":"string","description":"字体颜色（HEX）","default":"#FFFFFF"},"outlineColor":{"type":"string","description":"描边颜色（HEX）"},"backColor":{"type":"string","description":"背景颜色（HEX）"},"bottom":{"type":"integer","description":"底部距离（像素），范围 0~1000","minimum":0,"maximum":1000,"default":50},"magnification":{"type":"number","description":"放大倍数，范围 0.1~5.0","minimum":0.1,"maximum":5,"default":2.5}}}}}}}}},"callbackUrl":{"type":"string","description":"任务完成后的回调通知URL"},"clientTaskId":{"type":"string","description":"客户端任务ID，用于幂等校验，避免重复提交"}}},"SubmitTaskResp":{"type":"object","description":"提交任务响应","properties":{"code":{"type":"integer","description":"状态码，0=成功"},"msg":{"type":"string","description":"状态信息"},"data":{"type":"object","properties":{"taskNo":{"type":"string","description":"任务编号，用于查询状态"},"taskId":{"type":"integer","description":"任务ID"},"estimatedDotCount":{"type":"integer","description":"预计消耗点数"},"totalItems":{"type":"integer","description":"总处理数量"}}}}},"TaskStatusResp":{"type":"object","description":"查询任务状态响应","properties":{"code":{"type":"integer","description":"状态码，0=成功"},"msg":{"type":"string","description":"状态信息"},"data":{"type":"object","properties":{"taskNo":{"type":"string","description":"任务编号"},"taskType":{"type":"string","description":"任务类型"},"status":{"type":"integer","description":"任务状态：0=待提交，1=已入队，2=执行中，3=已完成，4=失败，5=已取消，6=拒绝","enum":[0,1,2,3,4,5,6]},"statusName":{"type":"string","description":"状态名称"},"progressPercent":{"type":"integer","description":"进度百分比 0~100"}}}}}}}}