mixvideo-v2/openapi.json

3773 lines
144 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

{
"openapi": "3.1.0",
"info": {
"title": "Text Video Agent Api",
"description": "文本生成视频API服务",
"version": "1.0.6"
},
"paths": {
"/api/prompt/default": {
"get": {
"tags": [
"提示词预处理"
],
"summary": "获取示例提示词",
"operationId": "get_sample_prompt_api_prompt_default_get",
"parameters": [
{
"name": "task_type",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Task Type"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/prompt/health": {
"get": {
"tags": [
"提示词预处理"
],
"summary": "健康检测",
"operationId": "health_check_api_prompt_health_get",
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
}
}
}
},
"/api/file/upload": {
"post": {
"tags": [
"文件操作"
],
"summary": "上传文件到COS",
"description": "上传文件到腾讯云COS\n\n- **file**: 要上传的文件\n\n返回上传后的文件URL",
"operationId": "upload_file_api_file_upload_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_upload_file_api_file_upload_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FileUploadResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
},
"deprecated": true
}
},
"/api/file/upload/s3": {
"post": {
"tags": [
"文件操作"
],
"summary": "上传文件到s3【推荐 cdn加速】",
"operationId": "upload_s3_api_file_upload_s3_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_upload_s3_api_file_upload_s3_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/FileUploadResponse"
}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/file/health": {
"get": {
"tags": [
"文件操作"
],
"summary": "健康检测",
"operationId": "health_check_api_file_health_get",
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
}
}
}
},
"/api/template/default": {
"get": {
"tags": [
"视频模板管理"
],
"summary": "获取视频模板列表",
"description": "获取视频模板列表,支持分页和按任务类型筛选\n\nArgs:\n category: 模版分类标签, 默认为 全部\n task_type: 任务类型如果为None则返回所有模板\n page: 页码从1开始默认1\n page_size: 每页记录数默认100最大1000\n \nReturns:\n {\n \"status\": True, \n \"data\": [模板数据列表], \n \"page\": 当前页码,\n \"page_size\": 每页数量,\n \"total\": 总记录数,\n \"total_pages\": 总页数\n }",
"operationId": "query_video_template_v2_api_template_default_get",
"parameters": [
{
"name": "task_type",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Task Type"
}
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"minimum": 1,
"description": "页码从1开始",
"default": 1,
"title": "Page"
},
"description": "页码从1开始"
},
{
"name": "page_size",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "每页数量",
"default": 100,
"title": "Page Size"
},
"description": "每页数量"
},
{
"name": "category",
"in": "query",
"required": false,
"schema": {
"type": "string",
"description": "模版分类,标签",
"default": "全部",
"title": "Category"
},
"description": "模版分类,标签"
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/template/check/task_type": {
"get": {
"tags": [
"视频模板管理"
],
"summary": "检查任务类型是否可用",
"description": "检查指定的任务类型是否可用(未被占用)\n\nArgs:\n task_type: 要检查的任务类型\n \nReturns:\n JSON: 包含任务类型可用性的响应",
"operationId": "check_template_task_type__api_template_check_task_type_get",
"parameters": [
{
"name": "task_type",
"in": "query",
"required": true,
"schema": {
"type": "string",
"title": "Task Type"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/template/create": {
"post": {
"tags": [
"视频模板管理"
],
"summary": "创建新的视频模板",
"description": "创建新的视频模板\n \n Args:\n template_data: 模板数据必须包含task_type字段且该字段值必须唯一\n 样例数据: {\n \"prompt\": \"Cozy, earthy-style visual highlighting the natural essence of herbal detox tea for gut health. A ceramic tea cup with hand-painted floral designs contains steaming tea, its surface sprinkled with turmeric and cinnamon. The cup rests on a weathered outdoor stone surface, surrounded by wildflowers and fresh green leaves for a natural ambiance. A small clay bowl holds psyllium husk and senna leaves, showcasing the raw ingredients. The scene is enhanced with soft sunlight filtering through tree branches, creating dappled shadows. A few drops of water glisten on nearby stones, suggesting a dew-kissed morning. Shot with a Nikon DSLR, the image captures a warm, rustic tone, emphasizing the organic and earth-inspired elements of the tea ritual.\",\n \"cover_url\": \"https://sucai-1324682537.cos.ap-shanghai.myqcloud.com/tk/image/upload_20250630_172120_6226.png\",\n \"video_url\": \"https://sucai-1324682537.cos.ap-shanghai.myqcloud.com/tk/video/02175127558530600000000000000000000ffffac15900ce5c3cc.mp4\",\n \"description\": \"茶艺展示\",\n \"detailDescription\": \"茶艺仪式与草本排毒茶的自然精华展示\",\n \"title_zh\": \"养生草本茶艺展示\",\n \"title_en\": null,\n \"description_zh\": \"茶艺展示\",\n \"description_en\": null,\n \"aspect_ratio\": \"9:16\",\n \"engine\": \"mj\",\n \"presetPrompts\": \"11111\n22222\",\n \"task_type\": \"tea\"\n }\n \n Returns:\n JSON: 包含创建结果的响应",
"operationId": "handler_create_video_template_api_template_create_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"additionalProperties": true,
"type": "object",
"title": "Template Data"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/template/update": {
"put": {
"tags": [
"视频模板管理"
],
"summary": "更新视频模板",
"description": "更新视频模板\n\nArgs:\n template_data: 模板数据必须包含id字段\n \nReturns:\n JSON: 包含更新结果的响应",
"operationId": "handler_update_video_template_api_template_update_put",
"requestBody": {
"content": {
"application/json": {
"schema": {
"additionalProperties": true,
"type": "object",
"title": "Template Data"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/template/delete/{template_id}": {
"delete": {
"tags": [
"视频模板管理"
],
"summary": "删除视频模板",
"description": "删除视频模板(软删除)\n\nArgs:\n template_id: 要删除的模板ID\n \nReturns:\n JSON: 包含删除结果的响应",
"operationId": "handler_delete_video_template_api_template_delete__template_id__delete",
"parameters": [
{
"name": "template_id",
"in": "path",
"required": true,
"schema": {
"type": "integer",
"title": "Template Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/mj/prompt/check": {
"get": {
"tags": [
"Midjourney图片生成"
],
"summary": "🔥图片提示词预审",
"operationId": "prompt_check_api_mj_prompt_check_get",
"parameters": [
{
"name": "prompt",
"in": "query",
"required": true,
"schema": {
"type": "string",
"title": "Prompt"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/mj/sync/image": {
"post": {
"tags": [
"Midjourney图片生成"
],
"summary": "同步生成图片接口",
"description": "同步生成图片接口 - 提交任务并轮询结果\n\nArgs:\n prompt (str): 图片生成提示词\n img_file: 样貌参考 --oref\n max_wait_time (int): 最大等待时间默认120秒\n poll_interval (int): 轮询间隔默认2秒\n\nReturns:\n dict: 包含status, msg, data的响应字典",
"operationId": "generate_image_sync_api_mj_sync_image_post",
"parameters": [
{
"name": "prompt",
"in": "query",
"required": true,
"schema": {
"type": "string",
"title": "Prompt"
}
},
{
"name": "max_wait_time",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"default": 120,
"title": "Max Wait Time"
}
},
{
"name": "poll_interval",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"default": 2,
"title": "Poll Interval"
}
}
],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_generate_image_sync_api_mj_sync_image_post"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/mj/generate-image": {
"post": {
"tags": [
"Midjourney图片生成"
],
"summary": "生成图片",
"description": "生成图片接口",
"operationId": "generate_image_api_api_mj_generate_image_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_generate_image_api_api_mj_generate_image_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/mj/sync/img/describe": {
"post": {
"tags": [
"Midjourney图片生成"
],
"summary": "获取图像描述",
"description": "获取图像描述接口",
"operationId": "describe_image_api_api_mj_sync_img_describe_post",
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"$ref": "#/components/schemas/Body_describe_image_api_api_mj_sync_img_describe_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/mj/sync/file/img/describe": {
"post": {
"tags": [
"Midjourney图片生成"
],
"summary": "通过文件获取生图的提示词",
"operationId": "desc_img_by_file_api_mj_sync_file_img_describe_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_desc_img_by_file_api_mj_sync_file_img_describe_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/mj/health": {
"get": {
"tags": [
"Midjourney图片生成"
],
"summary": "健康检查",
"description": "健康检查接口",
"operationId": "health_check_api_mj_health_get",
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
}
}
}
},
"/api/mj/async/generate/image": {
"post": {
"tags": [
"Midjourney图片生成"
],
"summary": "异步提交生图任务",
"operationId": "async_gen_image_api_mj_async_generate_image_post",
"parameters": [
{
"name": "prompt",
"in": "query",
"required": true,
"schema": {
"type": "string",
"title": "Prompt"
}
}
],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_async_gen_image_api_mj_async_generate_image_post"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/mj/async/query/status": {
"get": {
"tags": [
"Midjourney图片生成"
],
"summary": "异步查询任务状态",
"operationId": "async_query_status_api_mj_async_query_status_get",
"parameters": [
{
"name": "task_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"title": "Task Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/jm/generate-video": {
"post": {
"tags": [
"极梦视频生成api"
],
"summary": "生成视频",
"description": "生成视频接口",
"operationId": "generate_video_api_api_jm_generate_video_post",
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"$ref": "#/components/schemas/Body_generate_video_api_api_jm_generate_video_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/jm/sync/generate/video": {
"post": {
"tags": [
"极梦视频生成api"
],
"summary": "同步:生成视频v2,支持通过图片文件生成视频",
"operationId": "sync_generate_video_v2_api_jm_sync_generate_video_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_sync_generate_video_v2_api_jm_sync_generate_video_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/jm/async/generate/video": {
"post": {
"tags": [
"极梦视频生成api"
],
"summary": "异步生成视频,提交任务",
"operationId": "async_gen_video_api_jm_async_generate_video_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_async_gen_video_api_jm_async_generate_video_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/jm/async/query/status": {
"get": {
"tags": [
"极梦视频生成api"
],
"summary": "异步查询生成视频的任务状态",
"operationId": "async_query_video_status_api_jm_async_query_status_get",
"parameters": [
{
"name": "task_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"title": "Task Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/jm/health": {
"get": {
"tags": [
"极梦视频生成api"
],
"summary": "健康检查",
"description": "健康检查接口",
"operationId": "health_check_api_jm_health_get",
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
}
}
}
},
"/api/task/create/task": {
"post": {
"tags": [
"任务管理api"
],
"summary": "新版异步提交任务)",
"description": "异步提交任务到 Modal 进行处理不阻塞立即返回任务ID\n\n- **task_type**: 任务类型 (tea/chop/lady/vlog)\n- **prompt**: 生成提示词\n- **img_url**: 可选的参考图片URL如果提供会先进行图片描述\n- **ar**: 生成图片的长宽比 默认为9:16\n\n立即返回 Modal 任务ID任务在后台异步执行",
"operationId": "submit_task_v2_api_task_create_task_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TaskRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/task/create/task/v2": {
"post": {
"tags": [
"任务管理api"
],
"summary": "新版本异步提交任务",
"description": "异步提交任务到 Modal 进行处理不阻塞立即返回任务ID\n\n - **task_type**: 任务类型 (tea/chop/lady/vlog)\n - **prompt**: 生成提示词\n - **img_url**: 可选的参考图片URL如果提供会先进行图片描述\n - **ar**: 生成图片的长宽比 默认为9:16\n 立即返回 Modal 任务ID任务在后台异步执行",
"operationId": "submit_task_v3_api_task_create_task_v2_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TaskRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/task/status/{task_id}": {
"get": {
"tags": [
"任务管理api"
],
"summary": "异步查询任务状态",
"operationId": "get_task_status_v2_api_task_status__task_id__get",
"parameters": [
{
"name": "task_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"title": "Task Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/task/health": {
"get": {
"tags": [
"任务管理api"
],
"summary": "健康检测",
"operationId": "health_check_api_task_health_get",
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
}
}
}
},
"/api/mj/video/async/submit": {
"post": {
"tags": [
"midjourney视频生成api"
],
"summary": "异步提交生成视频任务",
"operationId": "submit_video_task_api_mj_video_async_submit_post",
"parameters": [
{
"name": "prompt",
"in": "query",
"required": true,
"schema": {
"type": "string",
"title": "Prompt"
}
},
{
"name": "img_url",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Img Url"
}
}
],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_submit_video_task_api_mj_video_async_submit_post"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/mj/video/async/task/status": {
"post": {
"tags": [
"midjourney视频生成api"
],
"summary": "异步查询生成任务进度",
"operationId": "async_query_task_status_api_mj_video_async_task_status_post",
"parameters": [
{
"name": "task_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"title": "Task Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/mj/video/sync/gen": {
"post": {
"tags": [
"midjourney视频生成api"
],
"summary": "同步生成视频视频",
"operationId": "sync_submit_task_api_mj_video_sync_gen_post",
"parameters": [
{
"name": "prompt",
"in": "query",
"required": true,
"schema": {
"type": "string",
"title": "Prompt"
}
},
{
"name": "img_url",
"in": "query",
"required": false,
"schema": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Img Url"
}
}
],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_sync_submit_task_api_mj_video_sync_gen_post"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/mj/video/health": {
"get": {
"tags": [
"midjourney视频生成api"
],
"summary": "健康检查",
"operationId": "health_check_api_mj_video_health_get",
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
}
}
}
},
"/api/302/mj/async/generate/image": {
"post": {
"tags": [
"🔥302ai Midjourney图片生成"
],
"summary": "异步提交生图任务",
"operationId": "async_gen_image_api_302_mj_async_generate_image_post",
"parameters": [
{
"name": "prompt",
"in": "query",
"required": true,
"schema": {
"type": "string",
"title": "Prompt"
}
}
],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_async_gen_image_api_302_mj_async_generate_image_post"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/mj/task/cancel": {
"post": {
"tags": [
"🔥302ai Midjourney图片生成"
],
"summary": "取消任务",
"operationId": "cancel_task_api_302_mj_task_cancel_post",
"parameters": [
{
"name": "task_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"title": "Task Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/mj/async/query/status": {
"get": {
"tags": [
"🔥302ai Midjourney图片生成"
],
"summary": "异步查询任务状态",
"description": "Args:\n\n cdn_flag: 是否cdn转换,默认为False 【cnd 转换耗时】\n\n task_id: 任务id\n\n task_type: 任务类型image【生图】, describe【反推提示词】\n\nReturns:",
"operationId": "async_query_status_api_302_mj_async_query_status_get",
"parameters": [
{
"name": "task_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"title": "Task Id"
}
},
{
"name": "task_type",
"in": "query",
"required": false,
"schema": {
"type": "string",
"default": "image",
"title": "Task Type"
}
},
{
"name": "cdn_flag",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Cdn Flag"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/mj/sync/img/describe": {
"post": {
"tags": [
"🔥302ai Midjourney图片生成"
],
"summary": "获取图像描述",
"operationId": "describe_image_api_api_302_mj_sync_img_describe_post",
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"$ref": "#/components/schemas/Body_describe_image_api_api_302_mj_sync_img_describe_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/mj/sync/file/img/describe": {
"post": {
"tags": [
"🔥302ai Midjourney图片生成"
],
"summary": "通过文件获取生图的提示词",
"operationId": "desc_img_by_file_api_302_mj_sync_file_img_describe_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_desc_img_by_file_api_302_mj_sync_file_img_describe_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/mj/sync/image": {
"post": {
"tags": [
"🔥302ai Midjourney图片生成"
],
"summary": "同步生成图片接口",
"operationId": "generate_image_sync_api_302_mj_sync_image_post",
"parameters": [
{
"name": "prompt",
"in": "query",
"required": true,
"schema": {
"type": "string",
"title": "Prompt"
}
},
{
"name": "max_wait_time",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"default": 500,
"title": "Max Wait Time"
}
},
{
"name": "poll_interval",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"default": 4,
"title": "Poll Interval"
}
}
],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_generate_image_sync_api_302_mj_sync_image_post"
}
}
}
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/jm/sync/generate/video": {
"post": {
"tags": [
"🔥302ai 极梦视频生成api"
],
"summary": "【302ai】同步:生成视频v2,支持通过图片文件生成视频",
"operationId": "sync_generate_video_v2_api_302_jm_sync_generate_video_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_sync_generate_video_v2_api_302_jm_sync_generate_video_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/jm/async/generate/video": {
"post": {
"tags": [
"🔥302ai 极梦视频生成api"
],
"summary": "异步生成视频,提交任务",
"operationId": "async_gen_video_api_302_jm_async_generate_video_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_async_gen_video_api_302_jm_async_generate_video_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/jm/async/query/status": {
"get": {
"tags": [
"🔥302ai 极梦视频生成api"
],
"summary": "异步查询生成视频的任务状态",
"operationId": "async_query_video_status_api_302_jm_async_query_status_get",
"parameters": [
{
"name": "task_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"title": "Task Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/mj/video/async/submit": {
"post": {
"tags": [
"🔥302ai Midjourney视频生成接口"
],
"summary": "异步提交生成视频任务",
"operationId": "submit_task_api_302_mj_video_async_submit_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_submit_task_api_302_mj_video_async_submit_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/mj/video/async/task/status": {
"post": {
"tags": [
"🔥302ai Midjourney视频生成接口"
],
"summary": "异步查询生成任务进度",
"operationId": "async_query_task_status_api_302_mj_video_async_task_status_post",
"parameters": [
{
"name": "task_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"title": "Task Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/mj/video/sync/generate/video": {
"post": {
"tags": [
"🔥302ai Midjourney视频生成接口"
],
"summary": "同步生成视频【text+img-->video】",
"operationId": "sync_gen_video_api_302_mj_video_sync_generate_video_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_sync_gen_video_api_302_mj_video_sync_generate_video_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/veo/video/async/submit": {
"post": {
"tags": [
"🔥 302ai veo视频生成接口"
],
"summary": "异步:text-->video or text + img --> video",
"operationId": "submit_iv_submit_api_302_veo_video_async_submit_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_submit_iv_submit_api_302_veo_video_async_submit_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/veo/video/sync/generate/video": {
"post": {
"tags": [
"🔥 302ai veo视频生成接口"
],
"summary": "同步: 生成视频【文本+图片 OR 文生成视频】",
"operationId": "sync_img_2video_api_302_veo_video_sync_generate_video_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_sync_img_2video_api_302_veo_video_sync_generate_video_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/veo/video/task/{task_id}": {
"get": {
"tags": [
"🔥 302ai veo视频生成接口"
],
"summary": "异步: 获取任务执行状态",
"description": "Args:\n task_id: 任务id\n\n img_mode: True:图文到视频 False 文生视频\n\nReturns:",
"operationId": "get_task_status_api_302_veo_video_task__task_id__get",
"parameters": [
{
"name": "task_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"title": "Task Id"
}
},
{
"name": "img_mode",
"in": "query",
"required": false,
"schema": {
"type": "boolean",
"default": false,
"title": "Img Mode"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/hedra/v2/submit/task": {
"post": {
"tags": [
"hedra 口型合成【2.0】"
],
"summary": "提交口型合成任务",
"operationId": "submit_character_task_api_302_hedra_v2_submit_task_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_submit_character_task_api_302_hedra_v2_submit_task_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
},
"deprecated": true
}
},
"/api/302/hedra/v2/task/status": {
"get": {
"tags": [
"hedra 口型合成【2.0】"
],
"summary": "查询任务状态",
"operationId": "query_task_status_api_302_hedra_v2_task_status_get",
"deprecated": true,
"parameters": [
{
"name": "task_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"description": "task_id",
"title": "Task Id"
},
"description": "task_id"
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/hedra/v2/upload": {
"post": {
"tags": [
"hedra 口型合成【2.0】"
],
"summary": "上传文件到hedra服务器仅支持,image, audio",
"operationId": "internal_upload_file_api_302_hedra_v2_upload_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_internal_upload_file_api_302_hedra_v2_upload_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
},
"deprecated": true
}
},
"/api/302/hedra/v3/file/upload": {
"post": {
"tags": [
"hedra 口型合成【3.0】"
],
"summary": "上传文件到hedra平台,返回资源的id",
"operationId": "upload_file_to_hedra_api_302_hedra_v3_file_upload_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_upload_file_to_hedra_api_302_hedra_v3_file_upload_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/hedra/v3/submit/task": {
"post": {
"tags": [
"hedra 口型合成【3.0】"
],
"summary": "异步提交任务",
"operationId": "handler_hedra_task_submit_api_302_hedra_v3_submit_task_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_handler_hedra_task_submit_api_302_hedra_v3_submit_task_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/hedra/v3/task/status": {
"get": {
"tags": [
"hedra 口型合成【3.0】"
],
"summary": "查询任务状态",
"operationId": "handler_query_task_status_api_302_hedra_v3_task_status_get",
"parameters": [
{
"name": "task_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"description": "任务id",
"title": "Task Id"
},
"description": "任务id"
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/hl_router/sync/generate/speech": {
"post": {
"tags": [
"海螺API"
],
"summary": "海螺同步生成音频",
"operationId": "hl_tts_api_302_hl_router_sync_generate_speech_post",
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"$ref": "#/components/schemas/Body_hl_tts_api_302_hl_router_sync_generate_speech_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/hl_router/sync/get/voices": {
"get": {
"tags": [
"海螺API"
],
"summary": "查询克隆的音色ID, 【接口来自官方, 302没有对应的中转接口】",
"operationId": "get_voices_hl_api_302_hl_router_sync_get_voices_get",
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
}
}
}
},
"/api/302/hl_router/sync/file/upload": {
"post": {
"tags": [
"海螺API"
],
"summary": "上传素材到302ai,用于复刻",
"operationId": "upload_material_file_api_302_hl_router_sync_file_upload_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_upload_material_file_api_302_hl_router_sync_file_upload_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/302/hl_router/sync/voice/clone": {
"post": {
"tags": [
"海螺API"
],
"summary": "声音克隆",
"operationId": "voice_clone_api_302_hl_router_sync_voice_clone_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_voice_clone_api_302_hl_router_sync_voice_clone_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/union/img/model/list": {
"get": {
"tags": [
"🔥【聚合接口】图片生成"
],
"summary": "获取支持的模型列表",
"operationId": "fetch_supported_model_api_union_img_model_list_get",
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
}
}
}
},
"/api/union/img/sync/generate/image": {
"post": {
"tags": [
"🔥【聚合接口】图片生成"
],
"summary": "生图",
"description": "详细参考: https://doc.302.ai/286288228e0",
"operationId": "sync_gen_image_api_union_img_sync_generate_image_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_sync_gen_image_api_union_img_sync_generate_image_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/union/video/model/list": {
"get": {
"tags": [
"🔥【聚合接口】视频生成接口"
],
"summary": "获取支持的模型列表",
"operationId": "fetch_supported_model_api_union_video_model_list_get",
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
}
}
}
},
"/api/union/video/async/generate/video": {
"post": {
"tags": [
"🔥【聚合接口】视频生成接口"
],
"summary": "异步提交任务",
"operationId": "submit_task_api_union_video_async_generate_video_post",
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_submit_task_api_union_video_async_generate_video_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/union/video/async/{task_id}/status": {
"get": {
"tags": [
"🔥【聚合接口】视频生成接口"
],
"summary": "异步查询任务状态",
"operationId": "query_task_status_api_union_video_async__task_id__status_get",
"parameters": [
{
"name": "task_id",
"in": "path",
"required": true,
"schema": {
"type": "string",
"title": "Task Id"
}
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/comfy/fetch/running/node": {
"get": {
"tags": [
"comfyui工作流处理"
],
"summary": "根据任务数,获取运行节点",
"operationId": "get_running_node_api_comfy_fetch_running_node_get",
"parameters": [
{
"name": "task_count",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"description": "运行任务的数目",
"default": 1,
"title": "Task Count"
},
"description": "运行任务的数目"
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/comfy/async/submit/task": {
"post": {
"tags": [
"comfyui工作流处理"
],
"summary": "异步提交任务",
"operationId": "submit_task_api_comfy_async_submit_task_post",
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"$ref": "#/components/schemas/Body_submit_task_api_comfy_async_submit_task_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/comfy/async/task/status": {
"get": {
"tags": [
"comfyui工作流处理"
],
"summary": "查询任务状态",
"operationId": "query_task_status_api_comfy_async_task_status_get",
"parameters": [
{
"name": "task_id",
"in": "query",
"required": true,
"schema": {
"type": "string",
"description": "任务id",
"title": "Task Id"
},
"description": "任务id"
}
],
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/api/comfy/sync/execute/workflow": {
"post": {
"tags": [
"comfyui工作流处理"
],
"summary": "同步执行comfy工作流",
"operationId": "sync_execute_workflow_api_comfy_sync_execute_workflow_post",
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"$ref": "#/components/schemas/Body_sync_execute_workflow_api_comfy_sync_execute_workflow_post"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
},
"422": {
"description": "Validation Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
}
}
}
}
},
"/": {
"get": {
"summary": "Root",
"operationId": "root__get",
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
}
}
}
},
"/health": {
"get": {
"summary": "Health Check",
"operationId": "health_check_health_get",
"responses": {
"200": {
"description": "Successful Response",
"content": {
"application/json": {
"schema": {}
}
}
}
}
}
}
},
"components": {
"schemas": {
"Body_async_gen_image_api_302_mj_async_generate_image_post": {
"properties": {
"img_file": {
"anyOf": [
{
"type": "string",
"format": "binary"
},
{
"type": "null"
}
],
"title": "Img File",
"description": "样貌参考图片"
}
},
"type": "object",
"title": "Body_async_gen_image_api_302_mj_async_generate_image_post"
},
"Body_async_gen_image_api_mj_async_generate_image_post": {
"properties": {
"img_file": {
"anyOf": [
{
"type": "string",
"format": "binary"
},
{
"type": "null"
}
],
"title": "Img File",
"description": "样貌参考图片"
}
},
"type": "object",
"title": "Body_async_gen_image_api_mj_async_generate_image_post"
},
"Body_async_gen_video_api_302_jm_async_generate_video_post": {
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"description": "视频生成提示词"
},
"img_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Img Url",
"description": "图片URL地址",
"default": ""
},
"img_file": {
"anyOf": [
{
"type": "string",
"format": "binary"
},
{
"type": "null"
}
],
"title": "Img File",
"description": "上传的图片文件"
},
"duration": {
"type": "string",
"title": "Duration",
"description": "视频时长(秒)",
"default": "5"
},
"model_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Model Type",
"description": "模型类型, 支持 lite pro",
"default": "lite"
}
},
"type": "object",
"required": [
"prompt"
],
"title": "Body_async_gen_video_api_302_jm_async_generate_video_post"
},
"Body_async_gen_video_api_jm_async_generate_video_post": {
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"description": "视频生成提示词"
},
"img_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Img Url",
"description": "图片URL地址",
"default": ""
},
"img_file": {
"anyOf": [
{
"type": "string",
"format": "binary"
},
{
"type": "null"
}
],
"title": "Img File",
"description": "上传的图片文件"
},
"duration": {
"type": "string",
"title": "Duration",
"description": "视频时长(秒)",
"default": "5"
},
"model_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Model Type",
"description": "模型类型, 支持 lite pro",
"default": "lite"
}
},
"type": "object",
"required": [
"prompt"
],
"title": "Body_async_gen_video_api_jm_async_generate_video_post"
},
"Body_desc_img_by_file_api_302_mj_sync_file_img_describe_post": {
"properties": {
"img_file": {
"type": "string",
"format": "binary",
"title": "Img File",
"description": "上传的图片"
},
"max_wait_time": {
"type": "integer",
"title": "Max Wait Time",
"description": "最大等待时间(秒)",
"default": 120
},
"poll_interval": {
"type": "integer",
"title": "Poll Interval",
"description": "轮询间隔(秒)",
"default": 2
}
},
"type": "object",
"required": [
"img_file"
],
"title": "Body_desc_img_by_file_api_302_mj_sync_file_img_describe_post"
},
"Body_desc_img_by_file_api_mj_sync_file_img_describe_post": {
"properties": {
"img_file": {
"type": "string",
"format": "binary",
"title": "Img File",
"description": "上传的图片"
},
"max_wait_time": {
"type": "integer",
"title": "Max Wait Time",
"description": "最大等待时间(秒)",
"default": 120
},
"poll_interval": {
"type": "integer",
"title": "Poll Interval",
"description": "轮询间隔(秒)",
"default": 2
}
},
"type": "object",
"required": [
"img_file"
],
"title": "Body_desc_img_by_file_api_mj_sync_file_img_describe_post"
},
"Body_describe_image_api_api_302_mj_sync_img_describe_post": {
"properties": {
"image_url": {
"type": "string",
"title": "Image Url",
"description": "图片URL地址"
},
"max_wait_time": {
"type": "integer",
"title": "Max Wait Time",
"description": "最大等待时间(秒)",
"default": 120
},
"poll_interval": {
"type": "integer",
"title": "Poll Interval",
"description": "轮询间隔(秒)",
"default": 2
}
},
"type": "object",
"required": [
"image_url"
],
"title": "Body_describe_image_api_api_302_mj_sync_img_describe_post"
},
"Body_describe_image_api_api_mj_sync_img_describe_post": {
"properties": {
"image_url": {
"type": "string",
"title": "Image Url",
"description": "图片URL地址"
},
"max_wait_time": {
"type": "integer",
"title": "Max Wait Time",
"description": "最大等待时间(秒)",
"default": 120
},
"poll_interval": {
"type": "integer",
"title": "Poll Interval",
"description": "轮询间隔(秒)",
"default": 2
}
},
"type": "object",
"required": [
"image_url"
],
"title": "Body_describe_image_api_api_mj_sync_img_describe_post"
},
"Body_generate_image_api_api_mj_generate_image_post": {
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"description": "图片生成提示词"
},
"img_file": {
"anyOf": [
{
"type": "string",
"format": "binary"
},
{
"type": "null"
}
],
"title": "Img File",
"description": "样貌参考图片"
},
"max_wait_time": {
"type": "integer",
"title": "Max Wait Time",
"description": "最大等待时间(秒)",
"default": 120
},
"poll_interval": {
"type": "integer",
"title": "Poll Interval",
"description": "轮询间隔(秒)",
"default": 2
}
},
"type": "object",
"required": [
"prompt"
],
"title": "Body_generate_image_api_api_mj_generate_image_post"
},
"Body_generate_image_sync_api_302_mj_sync_image_post": {
"properties": {
"img_file": {
"anyOf": [
{
"type": "string",
"format": "binary"
},
{
"type": "null"
}
],
"title": "Img File",
"description": "样貌参考图片"
}
},
"type": "object",
"title": "Body_generate_image_sync_api_302_mj_sync_image_post"
},
"Body_generate_image_sync_api_mj_sync_image_post": {
"properties": {
"img_file": {
"anyOf": [
{
"type": "string",
"format": "binary"
},
{
"type": "null"
}
],
"title": "Img File",
"description": "样貌参考图片"
}
},
"type": "object",
"title": "Body_generate_image_sync_api_mj_sync_image_post"
},
"Body_generate_video_api_api_jm_generate_video_post": {
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"description": "视频生成提示词"
},
"img_url": {
"type": "string",
"title": "Img Url",
"description": "图片URL地址"
},
"duration": {
"type": "string",
"title": "Duration",
"description": "视频时长(秒)",
"default": "5"
},
"max_wait_time": {
"type": "integer",
"title": "Max Wait Time",
"description": "最大等待时间(秒)",
"default": 300
},
"poll_interval": {
"type": "integer",
"title": "Poll Interval",
"description": "轮询间隔(秒)",
"default": 5
},
"model_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Model Type",
"description": "模型类型, 支持 lite pro",
"default": "lite"
}
},
"type": "object",
"required": [
"prompt",
"img_url"
],
"title": "Body_generate_video_api_api_jm_generate_video_post"
},
"Body_handler_hedra_task_submit_api_302_hedra_v3_submit_task_post": {
"properties": {
"img_file": {
"type": "string",
"format": "binary",
"title": "Img File",
"description": "图片文件"
},
"audio_file": {
"type": "string",
"format": "binary",
"title": "Audio File",
"description": "音频文件"
},
"prompt": {
"type": "string",
"title": "Prompt",
"description": "文本提示词",
"default": ""
},
"resolution": {
"type": "string",
"title": "Resolution",
"description": "分辨率支持: 720p, 540p",
"default": "720p"
},
"aspect_ratio": {
"type": "string",
"title": "Aspect Ratio",
"description": "尺寸: 1:1, 16:9, 9:16",
"default": "1:1"
}
},
"type": "object",
"required": [
"img_file",
"audio_file"
],
"title": "Body_handler_hedra_task_submit_api_302_hedra_v3_submit_task_post"
},
"Body_hl_tts_api_302_hl_router_sync_generate_speech_post": {
"properties": {
"text": {
"type": "string",
"title": "Text",
"description": "tts文本内容"
},
"voice_id": {
"type": "string",
"title": "Voice Id",
"description": "Voice ID"
},
"speed": {
"type": "number",
"title": "Speed",
"description": "语速, [0.5, 2]",
"default": 1.0
},
"vol": {
"type": "number",
"title": "Vol",
"description": "音量(0,10]默认1.0",
"default": 1.0
},
"emotion": {
"type": "string",
"title": "Emotion",
"description": "情感, [\"happy\", \"sad\", \"angry\", \"fearful\", \"disgusted\", \"surprised\", \"calm\"]"
}
},
"type": "object",
"required": [
"text",
"voice_id"
],
"title": "Body_hl_tts_api_302_hl_router_sync_generate_speech_post"
},
"Body_internal_upload_file_api_302_hedra_v2_upload_post": {
"properties": {
"file": {
"type": "string",
"format": "binary",
"title": "File",
"description": "上传文件到hedra服务器,仅支持image与audio"
}
},
"type": "object",
"required": [
"file"
],
"title": "Body_internal_upload_file_api_302_hedra_v2_upload_post"
},
"Body_submit_character_task_api_302_hedra_v2_submit_task_post": {
"properties": {
"avatar_file": {
"type": "string",
"format": "binary",
"title": "Avatar File",
"description": "人像照片"
},
"audio_file": {
"type": "string",
"format": "binary",
"title": "Audio File",
"description": "音频文件"
}
},
"type": "object",
"required": [
"avatar_file",
"audio_file"
],
"title": "Body_submit_character_task_api_302_hedra_v2_submit_task_post"
},
"Body_submit_iv_submit_api_302_veo_video_async_submit_post": {
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"description": "生成视频的提示词"
},
"img_file": {
"anyOf": [
{
"type": "string",
"format": "binary"
},
{
"type": "null"
}
],
"title": "Img File",
"description": "首帧参考图"
}
},
"type": "object",
"required": [
"prompt"
],
"title": "Body_submit_iv_submit_api_302_veo_video_async_submit_post"
},
"Body_submit_task_api_302_mj_video_async_submit_post": {
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"description": "生成视频的提示词"
},
"img_file": {
"anyOf": [
{
"type": "string",
"format": "binary"
},
{
"type": "null"
}
],
"title": "Img File",
"description": "首帧参考图文件"
}
},
"type": "object",
"required": [
"prompt"
],
"title": "Body_submit_task_api_302_mj_video_async_submit_post"
},
"Body_submit_task_api_comfy_async_submit_task_post": {
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"description": "工作流节点数据"
}
},
"type": "object",
"required": [
"prompt"
],
"title": "Body_submit_task_api_comfy_async_submit_task_post"
},
"Body_submit_task_api_union_video_async_generate_video_post": {
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"description": "生图的提示词"
},
"img_file": {
"type": "string",
"format": "binary",
"title": "Img File",
"description": "首帧图片"
},
"model": {
"type": "string",
"title": "Model",
"description": "生图的模型",
"default": "302/seedance_i2v"
},
"duration": {
"type": "integer",
"title": "Duration",
"description": "视频时长",
"default": 5
}
},
"type": "object",
"required": [
"prompt"
],
"title": "Body_submit_task_api_union_video_async_generate_video_post"
},
"Body_submit_video_task_api_mj_video_async_submit_post": {
"properties": {
"img_file": {
"anyOf": [
{
"type": "string",
"format": "binary"
},
{
"type": "null"
}
],
"title": "Img File"
}
},
"type": "object",
"title": "Body_submit_video_task_api_mj_video_async_submit_post"
},
"Body_sync_execute_workflow_api_comfy_sync_execute_workflow_post": {
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"description": "工作流json字符穿"
}
},
"type": "object",
"required": [
"prompt"
],
"title": "Body_sync_execute_workflow_api_comfy_sync_execute_workflow_post"
},
"Body_sync_gen_image_api_union_img_sync_generate_image_post": {
"properties": {
"model": {
"type": "string",
"title": "Model",
"description": "生图的模型默认.mj",
"default": "302/midjourney-v7-t2i"
},
"prompt": {
"type": "string",
"title": "Prompt",
"description": "生图的提示词"
},
"img_file": {
"type": "string",
"format": "binary",
"title": "Img File",
"description": "参考图"
},
"aspect_ratio": {
"type": "string",
"title": "Aspect Ratio",
"description": "图片的尺寸",
"default": "9:16"
}
},
"type": "object",
"required": [
"prompt"
],
"title": "Body_sync_gen_image_api_union_img_sync_generate_image_post"
},
"Body_sync_gen_video_api_302_mj_video_sync_generate_video_post": {
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"description": "生成视频的提示词"
},
"img_file": {
"type": "string",
"format": "binary",
"title": "Img File",
"description": "首帧参考图文件"
},
"timeout": {
"type": "integer",
"title": "Timeout",
"description": "超时时间",
"default": 300
},
"interval": {
"type": "integer",
"title": "Interval",
"description": "轮询间隔",
"default": 3
}
},
"type": "object",
"required": [
"prompt",
"img_file"
],
"title": "Body_sync_gen_video_api_302_mj_video_sync_generate_video_post"
},
"Body_sync_generate_video_v2_api_302_jm_sync_generate_video_post": {
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"description": "生成视频的提示词"
},
"img_file": {
"type": "string",
"format": "binary",
"title": "Img File",
"description": "生成视频的图片"
},
"duration": {
"type": "string",
"title": "Duration",
"description": "视频时长(秒)",
"default": "5"
},
"max_wait_time": {
"type": "integer",
"title": "Max Wait Time",
"description": "最大等待时间(秒)",
"default": 300
},
"poll_interval": {
"type": "integer",
"title": "Poll Interval",
"description": "轮询间隔(秒)",
"default": 5
},
"model_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Model Type",
"description": "模型类型, 支持 lite pro",
"default": "lite"
}
},
"type": "object",
"required": [
"prompt",
"img_file"
],
"title": "Body_sync_generate_video_v2_api_302_jm_sync_generate_video_post"
},
"Body_sync_generate_video_v2_api_jm_sync_generate_video_post": {
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"description": "生成视频的提示词"
},
"img_file": {
"type": "string",
"format": "binary",
"title": "Img File",
"description": "生成视频的图片"
},
"duration": {
"type": "string",
"title": "Duration",
"description": "视频时长(秒)",
"default": "5"
},
"max_wait_time": {
"type": "integer",
"title": "Max Wait Time",
"description": "最大等待时间(秒)",
"default": 300
},
"poll_interval": {
"type": "integer",
"title": "Poll Interval",
"description": "轮询间隔(秒)",
"default": 5
},
"model_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Model Type",
"description": "模型类型, 支持 lite pro",
"default": "lite"
}
},
"type": "object",
"required": [
"prompt",
"img_file"
],
"title": "Body_sync_generate_video_v2_api_jm_sync_generate_video_post"
},
"Body_sync_img_2video_api_302_veo_video_sync_generate_video_post": {
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"description": "生成视频的提示词"
},
"img_file": {
"anyOf": [
{
"type": "string",
"format": "binary"
},
{
"type": "null"
}
],
"title": "Img File",
"description": "首帧参考图,可选"
},
"max_wait_time": {
"type": "integer",
"title": "Max Wait Time",
"description": "最大等待时间,单位秒",
"default": 500
},
"interval": {
"type": "integer",
"title": "Interval",
"description": "轮询间隔,单位秒",
"default": 5
}
},
"type": "object",
"required": [
"prompt"
],
"title": "Body_sync_img_2video_api_302_veo_video_sync_generate_video_post"
},
"Body_sync_submit_task_api_mj_video_sync_gen_post": {
"properties": {
"img_file": {
"anyOf": [
{
"type": "string",
"format": "binary"
},
{
"type": "null"
}
],
"title": "Img File"
}
},
"type": "object",
"title": "Body_sync_submit_task_api_mj_video_sync_gen_post"
},
"Body_upload_file_api_file_upload_post": {
"properties": {
"file": {
"type": "string",
"format": "binary",
"title": "File"
}
},
"type": "object",
"required": [
"file"
],
"title": "Body_upload_file_api_file_upload_post"
},
"Body_upload_file_to_hedra_api_302_hedra_v3_file_upload_post": {
"properties": {
"local_file": {
"type": "string",
"format": "binary",
"title": "Local File",
"description": "待上传的文件,支持音频,图片"
},
"purpose": {
"type": "string",
"title": "Purpose",
"description": "上传文件的用途: 支持\"image\" \"audio\" \"video\" \"voice\"",
"default": "image"
}
},
"type": "object",
"required": [
"local_file"
],
"title": "Body_upload_file_to_hedra_api_302_hedra_v3_file_upload_post"
},
"Body_upload_material_file_api_302_hl_router_sync_file_upload_post": {
"properties": {
"audio_file": {
"type": "string",
"format": "binary",
"title": "Audio File",
"description": "音频文件"
},
"purpose": {
"type": "string",
"title": "Purpose",
"description": "意图,默认voice_clone",
"default": "voice_clone"
}
},
"type": "object",
"required": [
"audio_file"
],
"title": "Body_upload_material_file_api_302_hl_router_sync_file_upload_post"
},
"Body_upload_s3_api_file_upload_s3_post": {
"properties": {
"file": {
"type": "string",
"format": "binary",
"title": "File"
}
},
"type": "object",
"required": [
"file"
],
"title": "Body_upload_s3_api_file_upload_s3_post"
},
"Body_voice_clone_api_302_hl_router_sync_voice_clone_post": {
"properties": {
"text": {
"type": "string",
"title": "Text",
"description": "复刻的文本"
},
"model": {
"type": "string",
"title": "Model",
"description": "支持的模型有:speech-02-hd,speech-02-turbo,speech-01-hd,speech-01-turbo",
"default": "speech-02-hd"
},
"need_noise_reduction": {
"type": "boolean",
"title": "Need Noise Reduction",
"description": "是否开启降噪",
"default": true
},
"voice_id": {
"type": "string",
"title": "Voice Id",
"description": "音色克隆voice_id"
},
"prefix": {
"type": "string",
"title": "Prefix",
"description": "音色voice_id前缀",
"default": "BoWong-"
},
"audio_file": {
"type": "string",
"format": "binary",
"title": "Audio File",
"description": "参考音频文件"
}
},
"type": "object",
"required": [
"text"
],
"title": "Body_voice_clone_api_302_hl_router_sync_voice_clone_post"
},
"FileUploadResponse": {
"properties": {
"status": {
"type": "boolean",
"title": "Status",
"description": "上传状态"
},
"msg": {
"type": "string",
"title": "Msg",
"description": "响应消息"
},
"data": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Data",
"description": "文件URL"
}
},
"type": "object",
"required": [
"status",
"msg"
],
"title": "FileUploadResponse",
"description": "文件上传响应模型"
},
"HTTPValidationError": {
"properties": {
"detail": {
"items": {
"$ref": "#/components/schemas/ValidationError"
},
"type": "array",
"title": "Detail"
}
},
"type": "object",
"title": "HTTPValidationError"
},
"TaskRequest": {
"properties": {
"task_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Task Type",
"description": "任务类型如: tea, chop, lady, vlog",
"default": ""
},
"prompt": {
"type": "string",
"title": "Prompt",
"description": "生图的提示词"
},
"img_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Img Url",
"description": "参考图",
"default": ""
},
"ar": {
"type": "string",
"title": "Ar",
"description": "生成图片,视频的分辨率",
"default": "9:16"
}
},
"type": "object",
"required": [
"prompt"
],
"title": "TaskRequest"
},
"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"
}
}
}
}