{
    "tags": [
        "VideoGeneration"
    ],
    "summary": "创建万相 3.0 视频任务(官方格式",
    "responses": {
        "200": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "required": [
                            "output",
                            "request_id"
                        ],
                        "properties": {
                            "output": {
                                "type": "object",
                                "required": [
                                    "task_id",
                                    "task_status"
                                ],
                                "properties": {
                                    "task_id": {
                                        "type": "string",
                                        "description": "任务 ID，有效期为 24 小时。"
                                    },
                                    "task_status": {
                                        "enum": [
                                            "PENDING",
                                            "RUNNING",
                                            "SUCCEEDED",
                                            "FAILED",
                                            "CANCELED",
                                            "UNKNOWN"
                                        ],
                                        "type": "string"
                                    }
                                }
                            },
                            "request_id": {
                                "type": "string",
                                "description": "请求唯一标识。"
                            }
                        }
                    }
                }
            },
            "description": "任务创建成功。"
        },
        "400": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "required": [
                            "code",
                            "message",
                            "request_id"
                        ],
                        "properties": {
                            "code": {
                                "type": "string",
                                "description": "错误码。"
                            },
                            "message": {
                                "type": "string",
                                "description": "错误详情。"
                            },
                            "request_id": {
                                "type": "string",
                                "description": "请求唯一标识。"
                            }
                        }
                    }
                }
            },
            "description": "请求参数错误。"
        },
        "401": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "required": [
                            "code",
                            "message",
                            "request_id"
                        ],
                        "properties": {
                            "code": {
                                "type": "string"
                            },
                            "message": {
                                "type": "string"
                            },
                            "request_id": {
                                "type": "string"
                            }
                        }
                    }
                }
            },
            "description": "API Key 缺失或无效。"
        },
        "default": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "properties": {
                            "code": {
                                "type": "string"
                            },
                            "message": {
                                "type": "string"
                            },
                            "request_id": {
                                "type": "string"
                            }
                        }
                    }
                }
            },
            "description": "其他错误。"
        }
    },
    "parameters": [],
    "description": "### 创建万相 3.0 视频任务(官方格式\n创建异步视频生成任务。`input.prompt` 和 `input.media` 至少填写一个。\n`reference_*`、`file`、`link` 类型不能与 `first_frame`、`last_frame` 类型混用。\n官方文档链接：",
    "requestBody": {
        "content": {
            "application/json": {
                "schema": {
                    "type": "object",
                    "title": "创建万相 3.0 视频任务(官方格式",
                    "$schema": "",
                    "required": [
                        "model",
                        "input"
                    ],
                    "properties": {
                        "input": {
                            "type": "object",
                            "anyOf": [
                                {
                                    "required": [
                                        "prompt"
                                    ]
                                },
                                {
                                    "required": [
                                        "media"
                                    ]
                                }
                            ],
                            "properties": {
                                "media": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "required": [
                                            "type",
                                            "url"
                                        ],
                                        "properties": {
                                            "url": {
                                                "type": "string",
                                                "examples": [
                                                    ""
                                                ],
                                                "description": "公网 HTTP(S) URL、OSS 临时 URL；图片还可传入\n`data:{MIME_type};base64,{base64_data}` 格式的数据。"
                                            },
                                            "type": {
                                                "enum": [
                                                    "first_frame",
                                                    "last_frame",
                                                    "reference_image",
                                                    "reference_video",
                                                    "reference_audio",
                                                    "file",
                                                    "link"
                                                ],
                                                "type": "string",
                                                "description": "媒体素材类型。"
                                            }
                                        }
                                    },
                                    "minItems": 1,
                                    "description": "媒体素材列表。图片最多 10 张；视频最多 5 段且总时长不超过 15 秒；\n音频最多 5 段且总时长不超过 15 秒；文件或网页链接最多 1 个且二者互斥；\n首帧、尾帧各最多 1 张。各类素材的组合限制需由调用方遵守。"
                                },
                                "prompt": {
                                    "type": "string",
                                    "maxLength": 20000,
                                    "description": "描述期望生成的视频内容，支持中英文。全能参考模式下可使用“图1”、\n“视频1”、“音频1”等称呼引用 media 中同类素材的出现顺序。"
                                }
                            },
                            "description": "输入信息。prompt 和 media 至少填写一个。",
                            "minProperties": 1
                        },
                        "model": {
                            "enum": [
                                "wan3.0-video-prime",
                                "wan3.0-video"
                            ],
                            "type": "string",
                            "description": "模型名称。"
                        },
                        "parameters": {
                            "type": "object",
                            "properties": {
                                "seed": {
                                    "type": "integer",
                                    "maximum": 2147483647,
                                    "minimum": 0,
                                    "description": "用于复现生成结果的随机种子。"
                                },
                                "audio": {
                                    "type": "boolean",
                                    "default": true,
                                    "description": "输出视频是否包含音轨。"
                                },
                                "ratio": {
                                    "enum": [
                                        "adaptive",
                                        "16:9",
                                        "4:3",
                                        "1:1",
                                        "3:4",
                                        "9:16"
                                    ],
                                    "type": "string",
                                    "default": "adaptive",
                                    "description": "输出视频宽高比。"
                                },
                                "duration": {
                                    "type": "integer",
                                    "default": 5,
                                    "description": "输出时长（秒）。`-1` 表示智能时长；无视频输入时可取 2～30；\n有视频输入时，输入视频总时长与输出视频时长之和不得超过 30 秒。"
                                },
                                "watermark": {
                                    "type": "boolean",
                                    "default": false,
                                    "description": "是否添加水印标识。"
                                },
                                "resolution": {
                                    "enum": [
                                        "1080P",
                                        "720P",
                                        "480P"
                                    ],
                                    "type": "string",
                                    "default": "1080P",
                                    "description": "输出分辨率档位。"
                                },
                                "prompt_extend": {
                                    "type": "boolean",
                                    "default": true,
                                    "description": "是否启用提示词智能改写。"
                                }
                            },
                            "description": "视频生成参数。"
                        }
                    },
                    "x-apifox-id": "505913152"
                }
            }
        },
        "required": true
    }
}