1 line
36 KiB
JSON
1 line
36 KiB
JSON
{"openapi":"3.0.1","info":{"title":"API集成系统","description":"API集成系统，整合了多个外部服务接口，包括Coze, Kie AI API等。\n\n","contact":{"name":"API Support","url":"","email":""},"license":{"name":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"},"version":"1.0.0"},"servers":[{"url":"http://localhost:6081","description":"Generated server url"}],"tags":[{"name":"配置测试","description":"配置验证相关接口"},{"name":"文章管理","description":"文章管理接口"},{"name":"腾讯云语音识别接口","description":"腾讯云语音识别API接口调用"},{"name":"扣子coze API","description":"扣子cozeAPI https://www.coze.cn/open/docs/developer_guides/coze_api_overview"},{"name":"Kie AI视频生成接口","description":"Kie AI视频生成API接口调用"},{"name":"Kie AI回调接口","description":"Kie AI Sora-2 API回调通知处理"},{"name":"Kie AI图像生成接口","description":"Kie AI图像生成API"}],"paths":{"/api/articles/{id}":{"get":{"tags":["文章管理"],"summary":"根据ID获取文章详情","description":"根据ID获取文章详情","operationId":"getArticleById","parameters":[{"name":"id","in":"path","description":"文章ID","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseResult"}}}}}},"put":{"tags":["文章管理"],"summary":"更新文章","description":"更新文章","operationId":"updateArticle","parameters":[{"name":"id","in":"path","description":"文章ID","required":true,"schema":{"type":"integer","format":"int32"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Article"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseResult"}}}}}},"delete":{"tags":["文章管理"],"summary":"删除文章","description":"删除文章","operationId":"deleteArticle","parameters":[{"name":"id","in":"path","description":"文章ID","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseResult"}}}}}}},"/api/articles/task/{taskId}/status":{"put":{"tags":["文章管理"],"summary":"根据任务ID更新文章状态","description":"根据任务ID更新文章状态","operationId":"updateArticleStatusByTaskId","parameters":[{"name":"taskId","in":"path","description":"任务ID","required":true,"schema":{"type":"string"}},{"name":"statusTask","in":"query","description":"任务状态","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseResult"}}}}}}},"/api/tencent/asr/sentence-recognition":{"post":{"tags":["腾讯云语音识别接口"],"summary":"一句话识别","description":"对60秒以内的短音频进行识别（同步识别，直接返回结果）","operationId":"sentenceRecognition","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TencentAsrRequest"}}},"required":true},"responses":{"400":{"description":"参数错误"},"500":{"description":"识别失败"},"200":{"description":"识别成功","content":{"*/*":{"schema":{"$ref":"#/components/schemas/TencentAsrResponse"}}}}}}},"/api/tencent/asr/create-task":{"post":{"tags":["腾讯云语音识别接口"],"summary":"创建录音文件识别任务","description":"创建语音识别任务，适用于长音频文件（异步识别）","operationId":"createRecognitionTask","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TencentAsrRequest"}}},"required":true},"responses":{"400":{"description":"参数错误"},"200":{"description":"创建成功","content":{"*/*":{"schema":{"$ref":"#/components/schemas/TencentAsrResponse"}}}},"500":{"description":"创建失败"}}}},"/api/kieai/text-to-video":{"post":{"tags":["Kie AI视频生成接口"],"summary":"创建文生视频任务","description":"通过文本描述创建视频生成任务","operationId":"createTextToVideoTask","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sora2Request"}}},"required":true},"responses":{"400":{"description":"参数错误"},"200":{"description":"创建成功","content":{"*/*":{"schema":{"type":"string"}}}},"500":{"description":"创建失败"}}}},"/api/kieai/remove-watermark":{"post":{"tags":["Kie AI视频生成接口"],"summary":"去除视频水印","description":"根据任务ID去除视频水印","operationId":"removeWatermark","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sora2Request"}}},"required":true},"responses":{"400":{"description":"参数错误"},"200":{"description":"创建成功","content":{"*/*":{"schema":{"type":"string"}}}},"500":{"description":"创建失败"}}}},"/api/kieai/pro/text-to-video":{"post":{"tags":["Kie AI视频生成接口"],"summary":"创建专业版本文生视频任务","operationId":"createProTextToVideoTask","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProTextToVideoRequest"}}},"required":true},"responses":{"400":{"description":"参数错误","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseResult"}}}},"200":{"description":"成功","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseResult"}}}},"500":{"description":"系统错误","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseResult"}}}}}}},"/api/kieai/pro/image-to-video":{"post":{"tags":["Kie AI视频生成接口"],"summary":"创建专业版本图生视频任务","description":"通过图片URL创建高质量视频生成任务","operationId":"createProImageToVideoTask","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sora2Request"}}},"required":true},"responses":{"400":{"description":"参数错误","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseResult"}}}},"200":{"description":"创建成功","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseResult"}}}},"500":{"description":"系统错误","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseResult"}}}}}}},"/api/kieai/image/text-to-image":{"post":{"tags":["Kie AI图像生成接口"],"operationId":"createTextToImageTask","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NanoBananaRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NanoBananaResponseCreateTaskResponse"}}}}}}},"/api/kieai/image/task/{taskId}/retry":{"post":{"tags":["Kie AI图像生成接口"],"operationId":"retryTask","parameters":[{"name":"taskId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NanoBananaResponseCreateTaskResponse"}}}}}}},"/api/kieai/image/task/{taskId}/cancel":{"post":{"tags":["Kie AI图像生成接口"],"operationId":"cancelTask","parameters":[{"name":"taskId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NanoBananaResponseString"}}}}}}},"/api/kieai/image/image-edit":{"post":{"tags":["Kie AI图像生成接口"],"operationId":"createImageEditTask","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NanoBananaRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseResult"}}}}}}},"/api/kieai/image/callback/{taskId}":{"post":{"tags":["Kie AI图像生成接口"],"operationId":"handleCallback","parameters":[{"name":"taskId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryTaskResponse"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NanoBananaResponseString"}}}}}}},"/api/kieai/image-to-video":{"post":{"tags":["Kie AI视频生成接口"],"summary":"创建图生视频任务","description":"通过图片URL创建视频生成任务","operationId":"createImageToVideoTask","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sora2Request"}}},"required":true},"responses":{"400":{"description":"参数错误"},"200":{"description":"创建成功","content":{"*/*":{"schema":{"type":"string"}}}},"500":{"description":"创建失败"}}}},"/api/kieai/file-url-upload":{"post":{"tags":["Kie AI视频生成接口"],"summary":"通过URL上传文件","description":"通过文件URL上传文件到Kie AI服务器","operationId":"uploadFileByUrl","parameters":[{"name":"fileUrl","in":"query","description":"文件URL","required":true,"schema":{"type":"string"}},{"name":"uploadPath","in":"query","description":"上传路径","required":false,"schema":{"type":"string"}},{"name":"fileName","in":"query","description":"文件名","required":false,"schema":{"type":"string"}},{"name":"apiKey","in":"query","description":"API密钥","required":true,"schema":{"type":"string"},"example":"55fd537f17575b13444221c37aa11f47"}],"responses":{"500":{"description":"上传失败"},"400":{"description":"参数错误"},"200":{"description":"上传成功","content":{"*/*":{"schema":{"type":"string"}}}}}}},"/api/kieai/callback":{"post":{"tags":["Kie AI回调接口"],"summary":"处理回调通知","description":"处理Kie AI Sora-2 API任务完成后的回调通知","operationId":"callback","requestBody":{"content":{"application/json":{"schema":{"type":"string","description":"回调通知数据"}}},"required":true},"responses":{"400":{"description":"参数错误"},"500":{"description":"处理失败"},"200":{"description":"处理成功","content":{"*/*":{"schema":{"type":"string"}}}}}}},"/api/kieai/callback20994":{"post":{"tags":["Kie AI回调接口"],"summary":"处理回调通知","description":"处理Kie AI Sora-2 API任务完成后的回调通知","operationId":"callback_1","requestBody":{"content":{"application/json":{"schema":{"type":"string","description":"回调通知数据"}}},"required":true},"responses":{"400":{"description":"参数错误"},"500":{"description":"处理失败"},"200":{"description":"处理成功","content":{"*/*":{"schema":{"type":"string"}}}}}}},"/api/coze/workflow/stream":{"post":{"tags":["扣子coze API"],"summary":"执行工作流 (流式)","description":"触发 Coze 预定义的工作流并以 SSE 流式返回执行事件","operationId":"runWorkflowStream","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CozeWorkflowRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SseEmitter"}}}}}}},"/api/coze/workflow/run":{"post":{"tags":["扣子coze API"],"summary":"执行工作流","description":"触发 Coze 预定义的工作流","operationId":"runWorkflow","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CozeWorkflowRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/api/coze/file/upload":{"post":{"tags":["扣子coze API"],"summary":"上传文件","description":"上传文件到 Coze 平台，获取 file_id 用于后续对话或工作流","operationId":"uploadFile","requestBody":{"content":{"application/json":{"schema":{"required":["file"],"type":"object","properties":{"file":{"type":"string","description":"待上传的文件","format":"binary"}}}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CozeBaseResponseObject"}}}}}}},"/api/coze/chat":{"post":{"tags":["扣子coze API"],"summary":"发起对话","description":"与 Coze Bot 进行对话，支持流式和非流式返回","operationId":"chat","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CozeChatRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object"}}}}}}},"/api/coze/chat/retrieve":{"post":{"tags":["扣子coze API"],"summary":"查看对话详情","description":"根据 Conversation ID 和 Chat ID 查询对话状态和详情","operationId":"retrieveChat","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CozeRetrieveChatRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CozeBaseResponseObject"}}}}}}},"/api/coze/chat/messages/list":{"post":{"tags":["扣子coze API"],"summary":"查看对话消息详情","description":"获取指定对话中的消息列表","operationId":"listMessages","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CozeListMessageRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CozeBaseResponseObject"}}}}}}},"/api/articles":{"get":{"tags":["文章管理"],"summary":"分页查询文章列表","description":"分页查询文章列表","operationId":"getArticles","parameters":[{"name":"page","in":"query","description":"页码","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"name":"size","in":"query","description":"每页数量","required":false,"schema":{"type":"integer","format":"int32","default":10}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseResult"}}}}}},"post":{"tags":["文章管理"],"summary":"创建文章","description":"创建文章","operationId":"createArticle","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Article"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseResult"}}}}}}},"/api/tencent/asr/query-status/{taskId}":{"get":{"tags":["腾讯云语音识别接口"],"summary":"查询识别任务状态","description":"根据任务ID查询语音识别任务的状态和结果","operationId":"queryTaskStatus","parameters":[{"name":"taskId","in":"path","description":"任务ID","required":true,"schema":{"type":"string"},"example":1234567890}],"responses":{"200":{"description":"查询成功","content":{"*/*":{"schema":{"$ref":"#/components/schemas/TencentAsrTaskStatus"}}}},"400":{"description":"参数错误"},"500":{"description":"查询失败"}}}},"/api/tencent/asr/health":{"get":{"tags":["腾讯云语音识别接口"],"summary":"健康检查","description":"检查腾讯云语音识别服务状态","operationId":"health","responses":{"200":{"description":"服务正常"}}}},"/api/tencent/asr/config-check":{"get":{"tags":["腾讯云语音识别接口"],"summary":"配置检查","description":"检查腾讯云API密钥配置状态","operationId":"configCheck","responses":{"500":{"description":"配置异常"},"200":{"description":"配置正常"}}}},"/api/kieai/task/{taskId}":{"get":{"tags":["Kie AI视频生成接口"],"summary":"查询任务状态","description":"根据任务ID查询视频生成任务的状态","operationId":"getTaskStatus","parameters":[{"name":"taskId","in":"path","description":"任务ID","required":true,"schema":{"type":"string"},"example":"task_1234567890"},{"name":"apiKey","in":"query","description":"API密钥","required":true,"schema":{"type":"string"},"example":"55fd537f17575b13444221c37aa11f47"}],"responses":{"400":{"description":"参数错误"},"200":{"description":"查询成功","content":{"*/*":{"schema":{"$ref":"#/components/schemas/TaskStatus"}}}},"500":{"description":"查询失败"}}}},"/api/kieai/image/tasks":{"get":{"tags":["Kie AI图像生成接口"],"operationId":"getTaskList","parameters":[{"name":"page","in":"query","required":false,"schema":{"minimum":1,"type":"integer","format":"int32","default":1}},{"name":"size","in":"query","required":false,"schema":{"minimum":1,"type":"integer","format":"int32","default":10}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NanoBananaResponseListNanoBananaTask"}}}}}}},"/api/kieai/image/task/{taskId}":{"get":{"tags":["Kie AI图像生成接口"],"operationId":"queryTask","parameters":[{"name":"taskId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NanoBananaResponseQueryTaskResponse"}}}}}}},"/api/kieai/image/task/{taskId}/wait":{"get":{"tags":["Kie AI图像生成接口"],"operationId":"waitForTaskCompletion","parameters":[{"name":"taskId","in":"path","required":true,"schema":{"type":"string"}},{"name":"maxWaitSeconds","in":"query","required":false,"schema":{"minimum":1,"type":"integer","format":"int32","default":300}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NanoBananaResponseQueryTaskResponse"}}}}}}},"/api/kieai/image/task/{taskId}/detail":{"get":{"tags":["Kie AI图像生成接口"],"operationId":"getTaskDetail","parameters":[{"name":"taskId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NanoBananaResponseNanoBananaTask"}}}}}}},"/api/config/kieai":{"get":{"tags":["配置测试"],"summary":"获取KieAI配置信息","description":"验证KieAI相关配置是否正确从YAML文件加载","operationId":"getKieAIConfig","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseResult"}}}}}}},"/api/config/kieai/callback-url":{"get":{"tags":["配置测试"],"summary":"验证api-callback-url配置","description":"专门验证api-callback-url是否正确从YAML文件加载","operationId":"getCallbackUrlConfig","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseResult"}}}}}}},"/api/articles/search":{"get":{"tags":["文章管理"],"summary":"根据条件查询文章列表","description":"根据status_task、uid、tags等字段查询文章数据","operationId":"searchArticles","parameters":[{"name":"statusTask","in":"query","description":"任务状态","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"uid","in":"query","description":"用户ID","required":false,"schema":{"type":"string"}},{"name":"tags","in":"query","description":"标签","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","description":"类型","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"页码","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"name":"size","in":"query","description":"每页数量","required":false,"schema":{"type":"integer","format":"int32","default":100}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseResult"}}}}}}}},"components":{"schemas":{"Article":{"type":"object","properties":{"id":{"type":"integer","format":"int32"},"cid":{"type":"string"},"title":{"type":"string"},"author":{"type":"string"},"imageInput":{"type":"string"},"synopsis":{"type":"string"},"shareTitle":{"type":"string"},"shareSynopsis":{"type":"string"},"visit":{"type":"string"},"sort":{"type":"integer","format":"int32"},"url":{"type":"string"},"mediaId":{"type":"string"},"status":{"type":"boolean"},"hide":{"type":"boolean"},"adminId":{"type":"integer","format":"int32"},"merId":{"type":"integer","format":"int32"},"productId":{"type":"integer","format":"int32"},"isHot":{"type":"boolean"},"isBanner":{"type":"boolean"},"content":{"type":"string"},"createTime":{"type":"string","format":"date-time"},"updateTime":{"type":"string","format":"date-time"},"uid":{"type":"string"},"postId":{"type":"integer","format":"int64"},"checkInRecordId":{"type":"integer","format":"int32"},"image2":{"type":"string"},"image3":{"type":"string"},"statusTask":{"type":"integer","format":"int32"},"tags":{"type":"string"},"originalTitle":{"type":"string"},"originalUrl":{"type":"string"},"browserId":{"type":"string"},"videoUrl":{"type":"string"},"thumbnailUrl":{"type":"string"},"duration":{"type":"integer","format":"int32"},"fileSize":{"type":"integer","format":"int64"},"imageUrls":{"type":"string"},"taskId":{"type":"string"},"prompt":{"type":"string"},"scriptJson":{"type":"string"},"dishesJson":{"type":"string"},"nutritionJson":{"type":"string"},"generationMethod":{"type":"string"},"aiProvider":{"type":"string"},"generationCost":{"type":"number","format":"double"},"generationTime":{"type":"integer","format":"int32"},"downloadCount":{"type":"integer","format":"int32"},"shareCount":{"type":"integer","format":"int32"},"aspectRatio":{"type":"string"},"remark":{"type":"string"},"type":{"type":"integer","format":"int32"}},"description":"文章对象"},"ResponseResult":{"required":["code","message"],"type":"object","properties":{"code":{"type":"integer","description":"状态码，200表示成功，其他表示失败","format":"int32","example":200},"message":{"type":"string","description":"响应消息","example":"操作成功"},"data":{"type":"object","description":"响应数据体"}},"description":"统一响应结果"},"TencentAsrRequest":{"required":["url"],"type":"object","properties":{"url":{"type":"string","description":"音频URL地址，音频格式支持 wav、pcm、mp3、silk、speex、amr、m4a 等","example":"https://example.com/audio.wav"},"engineModelType":{"type":"string","description":"引擎模型类型，如16k_zh、16k_en等","example":"16k_zh"},"channelNum":{"type":"integer","description":"音频声道数，1：单声道；2：双声道","format":"int32","example":1},"resTextFormat":{"type":"integer","description":"识别结果文本格式，0：带标点；1：不带标点","format":"int32","example":0},"sourceType":{"type":"integer","description":"音频来源，0：音频URL；1：音频数据（base64编码）","format":"int32","example":0},"callbackUrl":{"type":"string","description":"回调URL，任务完成后将结果通过POST请求发送到该地址"},"data":{"type":"string","description":"音频数据（base64编码），当sourceType为1时使用"},"dataLen":{"type":"integer","description":"数据长度，当sourceType为1时需要提供","format":"int64"},"hotwordId":{"type":"string","description":"热词表ID，用于提高专有名词识别准确率"},"filterDirty":{"type":"boolean","description":"是否过滤脏词（默认不过滤）","example":false},"filterModal":{"type":"boolean","description":"是否过滤语气词（默认不过滤）","example":false},"convertNumMode":{"type":"boolean","description":"是否进行阿拉伯数字智能转换（默认不转换）","example":false},"wordInfo":{"type":"boolean","description":"是否显示词级别时间戳（默认不显示）","example":false}},"description":"识别请求参数"},"TencentAsrResponse":{"type":"object","properties":{"taskId":{"type":"string","description":"任务ID","example":"task_12345678"},"status":{"type":"integer","description":"任务状态：0-等待；1-执行中；2-成功；3-失败","format":"int32","example":2},"statusStr":{"type":"string","description":"任务状态描述","example":"识别成功"},"result":{"type":"string","description":"识别结果文本","example":"你好，这是语音识别测试"},"audioDuration":{"type":"number","description":"音频时长（秒）","format":"float","example":3.5},"errorCode":{"type":"integer","description":"错误码，0表示成功","format":"int32","example":0},"errorMsg":{"type":"string","description":"错误描述","example":"成功"},"resultDetail":{"type":"string","description":"结果详情（JSON格式）"},"requestId":{"type":"string","description":"请求ID","example":"req_abc123def456"}},"description":"腾讯云语音识别响应结果"},"Sora2Input":{"required":["aspect_ratio","prompt","remove_watermark"],"type":"object","properties":{"prompt":{"maxLength":2000,"minLength":1,"type":"string","description":"视频生成的文本描述，支持中英文","example":"介绍一下ai数字员工"},"image_urls":{"type":"array","description":"图片URL数组，用于图生视频任务。当进行图生视频时必填","example":["https://file.aiquickdraw.com/custom-page/akr/section-images/17594315607644506ltpf.jpg"],"items":{"type":"string","description":"图片URL数组，用于图生视频任务。当进行图生视频时必填","example":"[\"https://file.aiquickdraw.com/custom-page/akr/section-images/17594315607644506ltpf.jpg\"]"}},"aspect_ratio":{"type":"string","description":"视频宽高比","example":"portrait","enum":["portrait","landscape","9:16","16:9","1:1","4:3","3:4"]},"n_frames":{"maximum":30,"minimum":1,"type":"integer","description":"视频时长（秒），专业版本参数","format":"int32","example":5},"size":{"type":"string","description":"视频质量，专业版本参数","example":"standard","enum":["standard","high"],"default":"standard"},"remove_watermark":{"type":"boolean","description":"是否移除水印","example":true,"default":true},"video_url":{"type":"string","description":"视频URL，用于视频重绘任务","example":"https://sora.chatgpt.com/p/s_68e83bd7eee88191be79d2ba7158516f"}},"description":"Sora-2视频生成输入参数"},"Sora2Request":{"required":["api_key","input","model"],"type":"object","properties":{"model":{"type":"string","description":"模型名称，固定值为sora-2-text-to-video","example":"sora-2-text-to-video","enum":["sora-2-text-to-video"]},"tenant_id":{"type":"string","description":"租户ID，用于多租户场景","example":"tenant_001"},"title":{"type":"string","description":"任务标题，用于标识任务","example":"生成AI数字员工介绍视频"},"api_key":{"type":"string","description":"API密钥，用于身份验证","example":"484661585fe62c5bcb77e6d392ba8ee8"},"callBackUrl":{"type":"string","description":"回调地址，任务完成后会向该地址发送通知","example":"https://jxz.uj345.cc/models/api/kieai/callback"},"task_id":{"type":"string","description":"任务ID，用于关联任务记录","example":"task_12345"},"uid":{"type":"string","description":"用户ID，用于标识用户","example":"user_001"},"nickname":{"type":"string","description":"用户昵称，用于显示用户名","example":"张三"},"webhook_wxbot_url":{"type":"string","description":"企业微信机器人Webhook URL","example":"https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=f9b8db90-0941-4812-9d44-f50c3a7978dc"},"webhook_feishubot_url":{"type":"string","description":"飞书机器人Webhook URL","example":"https://open.feishu.cn/open-apis/bot/v2/hook/7d9263b7-212e-4037-bdd4-ccf17b78a04d"},"input":{"$ref":"#/components/schemas/Sora2Input"}},"description":"Sora-2请求参数"},"CreateProTextToVideoRequest":{"required":["apiKey","prompt"],"type":"object","properties":{"prompt":{"type":"string","description":"视频生成的文本描述","example":"A beautiful sunset over the ocean"},"aspectRatio":{"type":"string","description":"视频宽高比，如\"16:9\"、\"9:16\"、\"1:1\"等","example":"16:9"},"n_frames":{"type":"integer","description":"帧数","format":"int32","example":24},"size":{"type":"string","description":"视频尺寸","example":"1920*1080"},"removeWatermark":{"type":"boolean","description":"是否移除水印","example":false},"apiKey":{"type":"string","description":"API密钥","example":"sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},"articleId":{"type":"integer","description":"文章ID，用于关联文章记录","format":"int64","example":1}},"description":"创建专业版本文生视频任务请求参数"},"NanoBananaInput":{"required":["prompt"],"type":"object","properties":{"prompt":{"maxLength":1000,"minLength":1,"type":"string","description":"图像生成或编辑的文本描述，支持中英文","example":"A surreal painting of a giant banana floating in space, stars and galaxies in the background, vibrant colors, digital art"},"image_urls":{"type":"array","description":"图片URL数组，用于图像编辑任务。当进行图像编辑时必填","example":["https://example.com/image.png","https://example.com/image2.jpg"],"items":{"type":"string","description":"图片URL数组，用于图像编辑任务。当进行图像编辑时必填","example":"[\"https://example.com/image.png\",\"https://example.com/image2.jpg\"]"}},"output_format":{"type":"string","description":"输出图像格式","example":"png","enum":["png","jpg","jpeg","webp"],"default":"png"},"image_size":{"type":"string","description":"图像尺寸比例","example":"1:1","enum":["1:1","16:9","9:16","4:3","3:4"],"default":"1:1"},"aspect_ratio":{"type":"string","description":"宽高比","example":"16:9","enum":["1:1","16:9","9:16","4:3","3:4","3:2","2:3","21:9","9:21"]},"resolution":{"type":"string","description":"分辨率","example":"1024x1024"}},"description":"NanoBanana图像生成输入参数"},"NanoBananaRequest":{"required":["api_key","input","model"],"type":"object","properties":{"model":{"type":"string","description":"模型名称，固定值为nano-banana","example":"nano-banana","enum":["nano-banana"]},"tenant_id":{"type":"string","description":"租户ID，用于多租户场景","example":"tenant_001"},"title":{"type":"string","description":"任务标题，用于标识任务","example":"生成太空香蕉图像"},"api_key":{"type":"string","description":"API密钥，用于身份验证","example":"484661585fe62c5bcb77e6d392ba8ee8"},"callBackUrl":{"type":"string","description":"回调地址，任务完成后会向该地址发送通知","example":"https://jxz.uj345.cc/models/api/kieai/callback"},"task_id":{"type":"string","description":"任务ID，用于关联任务记录","example":"task_12345"},"uid":{"type":"string","description":"用户ID，用于标识用户","example":"user_001"},"nickname":{"type":"string","description":"用户昵称，用于显示用户名","example":"张三"},"webhook_wxbot_url":{"type":"string","description":"企业微信机器人Webhook URL","example":"https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=f9b8db90-0941-4812-9d44-f50c3a7978dc"},"webhook_feishubot_url":{"type":"string","description":"飞书机器人Webhook URL","example":"https://open.feishu.cn/open-apis/bot/v2/hook/7d9263b7-212e-4037-bdd4-ccf17b78a04d"},"input":{"$ref":"#/components/schemas/NanoBananaInput"}},"description":"图像编辑请求参数"},"CreateTaskResponse":{"required":["created_at","id","model","status"],"type":"object","properties":{"id":{"type":"string","description":"任务ID，用于后续查询任务状态","example":"task_123456"},"status":{"type":"string","description":"任务状态","example":"queuing","enum":["queuing","processing","completed","failed"]},"created_at":{"type":"string","description":"任务创建时间，ISO 8601格式","example":"2024-01-01T10:00:00Z"},"model":{"type":"string","description":"使用的模型类型","example":"google/nano-banana"}},"description":"创建任务响应结果"},"NanoBananaResponseCreateTaskResponse":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/CreateTaskResponse"}}},"NanoBananaResponseString":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"data":{"type":"string"}}},"QueryTaskResponse":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"created_at":{"type":"string"},"finished_at":{"type":"string"},"model":{"type":"string"},"input":{"type":"object"},"output":{"type":"array","items":{"type":"string"}},"error":{"type":"string"}}},"CozeWorkflowRequest":{"type":"object","properties":{"workflowId":{"type":"string"},"parameters":{"type":"object","additionalProperties":{"type":"object"}},"isAsync":{"type":"boolean"}}},"SseEmitter":{"type":"object","properties":{"timeout":{"type":"integer","format":"int64"}}},"CozeBaseResponseObject":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"data":{"type":"object"}}},"ChatMessage":{"type":"object","properties":{"role":{"type":"string"},"content":{"type":"string"},"contentType":{"type":"string"}}},"CozeChatRequest":{"type":"object","properties":{"botId":{"type":"string"},"userId":{"type":"string"},"query":{"type":"string"},"stream":{"type":"boolean"},"chatHistory":{"type":"array","items":{"$ref":"#/components/schemas/ChatMessage"}},"additionalParams":{"type":"object","additionalProperties":{"type":"object"}}}},"CozeRetrieveChatRequest":{"type":"object","properties":{"conversationId":{"type":"string"},"chatId":{"type":"string"}}},"CozeListMessageRequest":{"type":"object","properties":{"conversationId":{"type":"string"},"chatId":{"type":"string"}}},"TencentAsrTaskStatus":{"type":"object","properties":{"taskId":{"type":"string","description":"任务ID","example":"task_12345678"},"status":{"type":"integer","description":"任务状态：0-等待；1-执行中；2-成功；3-失败","format":"int32","example":2},"statusStr":{"type":"string","description":"任务状态描述","example":"识别成功"},"result":{"type":"string","description":"识别结果文本","example":"你好，这是语音识别测试"},"audioDuration":{"type":"number","description":"音频时长（秒）","format":"float","example":3.5},"errorCode":{"type":"integer","description":"错误码","format":"int32","example":0},"errorMsg":{"type":"string","description":"错误描述"},"resultDetail":{"type":"string","description":"结果详情（JSON格式）"}},"description":"腾讯云语音识别任务状态"},"TaskStatus":{"type":"object","properties":{"taskId":{"type":"string","description":"任务ID","example":"task_1234567890"},"state":{"type":"string","description":"任务状态","example":"success"},"resultUrls":{"type":"array","description":"结果URL数组，包含生成的视频或图片的URL","example":["https://example.com/video.mp4"],"items":{"type":"string","description":"结果URL数组，包含生成的视频或图片的URL","example":"[\"https://example.com/video.mp4\"]"}},"model":{"type":"string","description":"模型名称","example":"sora-2-text-to-video"},"param":{"type":"string","description":"请求参数","example":"{\"model\":\"sora-2-text-to-video\",\"callBackUrl\":\"https://your-domain.com/api/callback\",\"input\":{\"prompt\":\"A professor stands at the front of a lively classroom.\",\"aspect_ratio\":\"landscape\",\"remove_watermark\":true}}"},"failCode":{"type":"string","description":"失败代码","example":"INVALID_PARAM"},"failMsg":{"type":"string","description":"失败消息","example":"参数验证失败"},"completeTime":{"type":"integer","description":"完成时间（时间戳）","format":"int64","example":1698765432000},"createTime":{"type":"integer","description":"创建时间（时间戳）","format":"int64","example":1698765400000},"updateTime":{"type":"integer","description":"更新时间（时间戳）","format":"int64","example":1698765432000}},"description":"任务状态信息"},"NanoBananaResponseListNanoBananaTask":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/NanoBananaTask"}}}},"NanoBananaTask":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"taskId":{"type":"string"},"modelType":{"type":"string","enum":["NANO_BANANA","NANO_BANANA_EDIT","NANO_BANANA_PRO"]},"status":{"type":"string","enum":["QUEUING","GENERATING","SUCCESS","FAIL"]},"inputParams":{"type":"string"},"outputResult":{"type":"string"},"errorMessage":{"type":"string"},"callbackUrl":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"finishedAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"success":{"type":"boolean"},"finished":{"type":"boolean"}}},"NanoBananaResponseQueryTaskResponse":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/QueryTaskResponse"}}},"NanoBananaResponseNanoBananaTask":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/NanoBananaTask"}}}}}} |