{
    "tags": [
        "qwen_wan3"
    ],
    "summary": "创建万相 3.0 视频任务",
    "responses": {
        "200": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "required": [
                            "id",
                            "object",
                            "status"
                        ],
                        "properties": {
                            "id": {
                                "type": "string",
                                "description": "上游 task_id。"
                            },
                            "size": {
                                "type": "string"
                            },
                            "error": {
                                "type": "object",
                                "properties": {
                                    "code": {
                                        "type": "string"
                                    },
                                    "message": {
                                        "type": "string"
                                    }
                                }
                            },
                            "model": {
                                "type": "string"
                            },
                            "object": {
                                "type": "string",
                                "examples": [
                                    "video"
                                ]
                            },
                            "status": {
                                "enum": [
                                    "queued",
                                    "in_progress",
                                    "completed",
                                    "failed"
                                ],
                                "type": "string"
                            },
                            "seconds": {
                                "type": "string",
                                "description": "创建时回显时长；智能时长为 auto。"
                            },
                            "progress": {
                                "type": "integer",
                                "format": "int64",
                                "description": "成功时为 100。"
                            },
                            "video_url": {
                                "type": "string",
                                "description": "仅 completed 时返回，有效期 24 小时。"
                            },
                            "created_at": {
                                "type": "integer",
                                "format": "int64",
                                "description": "Unix 秒。"
                            }
                        }
                    }
                }
            },
            "description": "任务已提交"
        },
        "400": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "properties": {
                            "error": {
                                "type": "object",
                                "properties": {
                                    "code": {
                                        "type": "string"
                                    },
                                    "type": {
                                        "type": "string"
                                    },
                                    "param": {
                                        "type": "string"
                                    },
                                    "message": {
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "description": "请求错误"
        },
        "401": {
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "properties": {
                            "error": {
                                "type": "object",
                                "properties": {
                                    "code": {
                                        "type": "string"
                                    },
                                    "type": {
                                        "type": "string"
                                    },
                                    "param": {
                                        "type": "string"
                                    },
                                    "message": {
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "description": "未授权"
        }
    },
    "parameters": [],
    "description": "### 创建万相 3.0 视频任务\n统一支持文生视频、图生视频（首帧 / 首尾帧）和参考生视频。\nprompt 与媒体素材至少提供其一。\n\n模式推断（未传 mode 且未传官方 media 时）：\n- 有视频 / 音频 / file / link：参考生视频\n- 正好 1 或 2 张图：图生视频（第 1 张为首帧，第 2 张为尾帧）\n- 其他：参考生视频\n\nreference_* / file / link 与 first_frame / last_frame 互斥，不能混用。",
    "requestBody": {
        "content": {
            "application/json": {
                "schema": {
                    "type": "object",
                    "title": "创建万相 3.0 视频任务",
                    "$schema": "",
                    "required": [
                        "model",
                        "prompt"
                    ],
                    "properties": {
                        "file": {
                            "type": "string",
                            "description": "参考文件 URL。不可与 link 同时传。也可用 fileUrl。"
                        },
                        "link": {
                            "type": "string",
                            "description": "公开网页 URL。不可与 file 同时传。也可用 linkUrl。"
                        },
                        "mode": {
                            "enum": [
                                "image-to-video",
                                "reference-to-video"
                            ],
                            "type": "string",
                            "description": "未传 media 时生效。自动推导用什么mode"
                        },
                        "seed": {
                            "type": "integer",
                            "description": "随机种子，大于 0 时传给上游。范围 0 到 2147483647。"
                        },
                        "audio": {
                            "type": "boolean",
                            "default": true,
                            "description": "输出是否含音轨，默认 true。"
                        },
                        "media": {
                            "type": "array",
                            "items": {
                                "type": "object",
                                "required": [
                                    "type",
                                    "url"
                                ],
                                "properties": {
                                    "url": {
                                        "type": "string",
                                        "description": "公网 URL、OSS 临时 URL 或图像 Base64 data URI。"
                                    },
                                    "type": {
                                        "enum": [
                                            "first_frame",
                                            "last_frame",
                                            "reference_image",
                                            "reference_video",
                                            "reference_audio",
                                            "file",
                                            "link"
                                        ],
                                        "type": "string"
                                    }
                                }
                            },
                            "description": "官方格式媒体数组。传入后不再按 image_urls 等字段推断。reference_* / file / link 与 first_frame / last_frame / video_urls/ audio_urls / file / link 互斥。"
                        },
                        "model": {
                            "enum": [
                                "wan3.0-video",
                                "wan3.0-video-prime"
                            ],
                            "type": "string",
                            "examples": [
                                "wan3.0-video"
                            ]
                        },
                        "prompt": {
                            "type": "string",
                            "description": "文本提示词，中英文均可，最长 20000 字符。参考模式下可用「图1」「视频1」指代 media 顺序。"
                        },
                        "duration": {
                            "type": "integer",
                            "examples": [
                                5
                            ],
                            "description": "也支持字段名称 seconds。"
                        },
                        "watermark": {
                            "type": "boolean",
                            "default": false,
                            "description": "是否加水印，默认 false。"
                        },
                        "audio_urls": {
                            "type": "array",
                            "items": {
                                "type": "string"
                            },
                            "maxItems": 5,
                            "description": "参考音频。最多 5 段。也可用 audioUrls、input_audio、audio_url。"
                        },
                        "image_urls": {
                            "type": "array",
                            "items": {
                                "type": "string"
                            },
                            "maxItems": 10,
                            "description": "图片列表。也可用 imageUrls、images、input_reference、first_frame_url、last_frame_url。"
                        },
                        "resolution": {
                            "enum": [
                                "480P",
                                "720P",
                                "1080P"
                            ],
                            "type": "string",
                            "default": "1080P",
                            "description": "未识别时默认 1080P。"
                        },
                        "video_urls": {
                            "type": "array",
                            "items": {
                                "type": "string"
                            },
                            "maxItems": 5,
                            "description": "参考视频。最多 5 段，总时长不超过 15 秒。也可用 videoUrls、input_video、video_url。"
                        },
                        "aspect_ratio": {
                            "enum": [
                                "adaptive",
                                "16:9",
                                "4:3",
                                "1:1",
                                "3:4",
                                "9:16"
                            ],
                            "type": "string",
                            "default": "adaptive",
                            "description": "也可用从 size 推导。无法识别时为 adaptive。"
                        },
                        "prompt_extend": {
                            "type": "boolean",
                            "default": true,
                            "description": "是否智能改写 prompt，默认 true。"
                        }
                    },
                    "description": "prompt 与媒体素材至少提供其一。也可直接传官方 input / parameters。",
                    "x-apifox-id": "505897644"
                }
            }
        },
        "required": true
    }
}