HappyHorse and the Wan video generation API, with public paths following the official DashScope protocol.
HappyHorse supports happyhorse-1.0, happyhorse-1.0-i2v, happyhorse-1.0-t2v, happyhorse-1.0-r2v, and happyhorse-1.0-video-edit; Wan supports wan-3.0, wan-3.0-480p, and wan-3.0-1080p. Among them, happyhorse-1.0 is an aggregated model and must be distinguished via mode into t2v, i2v, r2v, and video_edit. The three Wan models are fixed at 720P, 480P, and 1080P respectively, and support 2 to 30 seconds plus up to 10 image, 5 video, and 5 audio references.
The public API keeps the official endpoint format; channel-specific prefixes are only concatenated internally when the gateway requests a specific upstream channel. Clients do not need to pass X-DashScope-Async explicitly; it is handled by the gateway or the official channel adapter layer.
Provides the public request skeleton, task query structure, and recommended validation template for HappyHorse and Wan video generation formats; public paths follow the official DashScope endpoint format.
model (string, required): The external model name for HappyHorse or Wan. Wan supports wan-3.0, wan-3.0-480p, and wan-3.0-1080p; the HappyHorse aggregated model happyhorse-1.0 must be used together with mode.
mode (string, optional): Aggregated model mode; common values are t2v, i2v, r2v, and video_edit. You can omit this for fixed submodels.
input.prompt (string, required): Prompt for video generation or editing.
input.media (array[object], optional): Multimedia input. Supports first_frame, last_frame, reference_image, reference_video, and reference_audio; Wan supports up to 10 images, 5 videos, and 5 audio files.
parameters.duration (integer, optional): Generation duration, in seconds.
parameters.resolution (string, optional): Output resolution. The three Wan models are fixed at 720P, 480P, and 1080P respectively; common values for HappyHorse are 720P and 1080P.
parameters.ratio (string, optional): Output aspect ratio, commonly used for text-to-video and reference-to-video.
parameters.watermark (boolean, optional): Whether to add a watermark.
parameters.seed (integer, optional): Random seed.
Common model/mode differences:
HappyHorse 聚合模型: Supports model happyhorse-1.0; the aggregated model uses mode to distinguish the final model.
HappyHorse 文生视频: Supports model happyhorse-1.0-t2v; official-format text-to-video.
HappyHorse 首帧图生视频: Supports model happyhorse-1.0-i2v; official-format first-frame image-to-video.
HappyHorse 参考生视频: Supports model happyhorse-1.0-r2v; official-format multi-reference image-to-video.
HappyHorse 视频编辑: Supports model happyhorse-1.0-video-edit; official-format video editing.
Wan 3.0 720P: Supported model wan-3.0; Wan 3.0 official-format multimodal reference video generation.
Wan 3.0 480P: Supported model wan-3.0-480p; Wan 3.0 official-format call fixed at 480P.
Wan 3.0 1080P: Supported model wan-3.0-1080p; Wan 3.0 official-format call fixed at 1080P.
POST
/
api
/
v1
/
services
/
aigc
/
video-generation
/
video-synthesis
curl --request POST \ --url https://api.aiid.edu.kg/api/v1/services/aigc/video-generation/video-synthesis \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "happyhorse-1.0", "mode": "t2v", "input": { "prompt": "A white horse running through a neon city street, cinematic" }, "parameters": { "resolution": "720P", "ratio": "16:9", "duration": 5 }}'
HappyHorse or Wan public model name. Wan supports wan-3.0, wan-3.0-480p, and wan-3.0-1080p; the HappyHorse aggregated model happyhorse-1.0 must be used with mode.
Multimedia input. Supports first_frame, last_frame, reference_image, reference_video, and reference_audio; Wan supports up to 10 images, 5 videos, and 5 audio files.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OverseasAPI","description":"Overseas API documentation","colors":{"primary":"#6d28d9","light":"#f5f3ff","dark":"#2e1065"},"logo":{"light":"https://mintcdn.com/btc-de295b31/dNi9LBWUBzALFywP/public/assets/logo.webp?fit=max\u0026auto=format\u0026n=dNi9LBWUBzALFywP\u0026q=85\u0026s=bac78dc112e5baf91eafeb0fffd5fd7d","dark":"https://mintcdn.com/btc-de295b31/dNi9LBWUBzALFywP/public/assets/logo.webp?fit=max\u0026auto=format\u0026n=dNi9LBWUBzALFywP\u0026q=85\u0026s=bac78dc112e5baf91eafeb0fffd5fd7d"},"favicon":{"light":"https://mintcdn.com/btc-de295b31/dNi9LBWUBzALFywP/public/assets/favicon.ico?fit=max\u0026auto=format\u0026n=dNi9LBWUBzALFywP\u0026q=85\u0026s=3a7f47070b4df3f9f490ff43d87e6281","dark":"https://mintcdn.com/btc-de295b31/dNi9LBWUBzALFywP/public/assets/favicon.ico?fit=max\u0026auto=format\u0026n=dNi9LBWUBzALFywP\u0026q=85\u0026s=3a7f47070b4df3f9f490ff43d87e6281"},"api":{"params":{"expanded":"all"}},"contextual":{"options":["copy"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","footer":{"socials":{"telegram":"https://t.me/overseas_api"}},"navbar":{"links":[{"href":"mailto:support@aiid.edu.kg","label":"Support"},{"href":"https://aiid.edu.kg/pricing","label":"Pricing"}],"primary":{"type":"button","label":"Console","href":"https://aiid.edu.kg/console"}},"href":"api-reference/en/conventions"},{"language":"cn","footer":{"socials":{"telegram":"https://t.me/overseas_api"}},"navbar":{"links":[{"href":"mailto:support@aiid.edu.kg","label":"支持"},{"href":"https://aiid.edu.kg/pricing","label":"价格"}],"primary":{"type":"button","label":"控制台","href":"https://aiid.edu.kg/console"}},"href":"api-reference/cn/conventions"},{"language":"zh-Hant","footer":{"socials":{"telegram":"https://t.me/overseas_api"}},"navbar":{"links":[{"href":"mailto:support@aiid.edu.kg","label":"支援"},{"href":"https://aiid.edu.kg/pricing","label":"價格"}],"primary":{"type":"button","label":"控制台","href":"https://aiid.edu.kg/console"}},"href":"api-reference/zh-tw/conventions"},{"language":"fr","footer":{"socials":{"telegram":"https://t.me/overseas_api"}},"navbar":{"links":[{"href":"mailto:support@aiid.edu.kg","label":"Support"},{"href":"https://aiid.edu.kg/pricing","label":"Tarifs"}],"primary":{"type":"button","label":"Console","href":"https://aiid.edu.kg/console"}},"href":"api-reference/fr/conventions"},{"language":"ja","footer":{"socials":{"telegram":"https://t.me/overseas_api"}},"navbar":{"links":[{"href":"mailto:support@aiid.edu.kg","label":"サポート"},{"href":"https://aiid.edu.kg/pricing","label":"料金"}],"primary":{"type":"button","label":"コンソール","href":"https://aiid.edu.kg/console"}},"href":"api-reference/ja/conventions"},{"language":"ru","footer":{"socials":{"telegram":"https://t.me/overseas_api"}},"navbar":{"links":[{"href":"mailto:support@aiid.edu.kg","label":"Поддержка"},{"href":"https://aiid.edu.kg/pricing","label":"Тарифы"}],"primary":{"type":"button","label":"Консоль","href":"https://aiid.edu.kg/console"}},"href":"api-reference/ru/conventions"},{"language":"vi","footer":{"socials":{"telegram":"https://t.me/overseas_api"}},"navbar":{"links":[{"href":"mailto:support@aiid.edu.kg","label":"Hỗ trợ"},{"href":"https://aiid.edu.kg/pricing","label":"Bảng giá"}],"primary":{"type":"button","label":"Bảng điều khiển","href":"https://aiid.edu.kg/console"}},"href":"api-reference/vi/conventions"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"btc-de295b31","hasAudioNarration":false,"actualSubdomain":"btc-de295b31","customDomains":["docs.aiid.edu.kg"],"gitSource":{"type":"github","owner":"btcfoxman","repo":"new-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adcd70fa22308d93b4ed191","collectionId":"a508850c-f314-4580-b926-7540fa8a2d66","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adcd70fa22308d93b4ed191"},"entitlements":{},"buildId":"6adcd70fa22308d93b4ed191","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"cn","tag":"API 参考","count":32},{"language":"en","tag":"API Reference","count":32},{"language":"fr","tag":"Référence API","count":32},{"language":"ja","tag":"API リファレンス","count":32},{"language":"ru","tag":"Справочник API","count":32},{"language":"vi","tag":"Tài liệu API","count":32},{"language":"zh-Hant","tag":"API 參考","count":32},{"language":"cn","tag":"开发文档","count":15},{"language":"en","tag":"Guides","count":15},{"language":"fr","tag":"Guides","count":15},{"language":"ja","tag":"ガイド","count":15},{"language":"ru","tag":"Руководства","count":15},{"language":"vi","tag":"Hướng dẫn","count":15},{"language":"zh-Hant","tag":"開發文檔","count":15},{"language":"cn","tag":"Skills","count":7},{"language":"en","tag":"Skills","count":7},{"language":"fr","tag":"Skills","count":7},{"language":"ja","tag":"Skills","count":7},{"language":"ru","tag":"Начало работы","count":7},{"language":"ru","tag":"Skills","count":7},{"language":"vi","tag":"Bắt đầu","count":7},{"language":"vi","tag":"Skills","count":7},{"language":"zh-Hant","tag":"Skills","count":7},{"language":"cn","tag":"集成与工具","count":6},{"language":"en","tag":"Tools","count":6},{"language":"fr","tag":"Outils","count":6},{"language":"ja","tag":"ツール","count":6},{"language":"ru","tag":"Инструменты","count":6},{"language":"vi","tag":"Công cụ","count":6},{"language":"zh-Hant","tag":"整合與工具","count":6},{"language":"cn","tag":"视频生成Vidu格式","count":5},{"language":"en","tag":"Video generation Vidu","count":5},{"language":"fr","tag":"Génération vidéo Vidu","count":5},{"language":"ja","tag":"Video generation Vidu","count":5},{"language":"ru","tag":"Генерация видео Vidu","count":5},{"language":"vi","tag":"Tạo video Vidu","count":5},{"language":"zh-Hant","tag":"影片生成 Vidu 格式","count":5},{"language":"cn","tag":"概览","count":4},{"language":"cn","tag":"视频生成Kling格式","count":4},{"language":"cn","tag":"开发指南","count":4},{"language":"cn","tag":"开始使用","count":4},{"language":"en","tag":"Overview","count":4},{"language":"en","tag":"Video generation Kling format","count":4},{"language":"en","tag":"Developer Guide","count":4},{"language":"en","tag":"Get started","count":4},{"language":"fr","tag":"Aperçu","count":4},{"language":"fr","tag":"Format de génération vidéo Kling","count":4},{"language":"fr","tag":"Guide développeur","count":4},{"language":"fr","tag":"Bien démarrer","count":4},{"language":"ja","tag":"概要","count":4},{"language":"ja","tag":"動画生成Kling形式","count":4},{"language":"ja","tag":"開発ガイド","count":4},{"language":"ja","tag":"はじめに","count":4},{"language":"ru","tag":"Обзор","count":4},{"language":"ru","tag":"ФорматKling генерации видео","count":4},{"language":"ru","tag":"Руководство разработчика","count":4},{"language":"vi","tag":"Tổng quan","count":4},{"language":"vi","tag":"Định dạngKling tạo video","count":4},{"language":"vi","tag":"Hướng dẫn phát triển","count":4},{"language":"zh-Hant","tag":"概覽","count":4},{"language":"zh-Hant","tag":"影片生成Kling格式","count":4},{"language":"zh-Hant","tag":"開發指南","count":4},{"language":"zh-Hant","tag":"開始使用","count":4},{"language":"cn","tag":"视频生成Sora兼容格式","count":3},{"language":"en","tag":"Video generation Sora compatible formats","count":3},{"language":"fr","tag":"Formats compatibles avec la génération de vidéosSora","count":3},{"language":"ja","tag":"動画生成Sora対応形式","count":3},{"language":"ru","tag":"Совместимый формат для Sora генерации видео","count":3},{"language":"vi","tag":"Định dạng tương thích Sora cho tạo video","count":3},{"language":"zh-Hant","tag":"影片生成Sora相容格式","count":3}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"html{font-size:15px}#api-playground-input,#body-content,#content-area,.api-section,.mdx-content,.request-example,.response-example{font-size:.9rem}.api-section pre,.request-example pre,.response-example pre,code{font-size:.85em}#page-title,.api-section h1,.api-section h2,.api-section h3{letter-spacing:-.01em}"}],"page":{"pagePath":"api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan","slug":"/api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan","pageMetadata":{"title":"Create video (HappyHorse and Wan)","openapi":"api-reference/en/openapi.json POST /api/v1/services/aigc/video-generation/video-synthesis","generated":true,"description":"This series supports OpenAI video generation formats (see the link [Video generation Sora compatible formats](/api-reference/en/video-generation-sora-compatible-format/create-video)).\n\nHappyHorse and the Wan video generation API, with public paths following the official DashScope protocol.\n\nHappyHorse supports `happyhorse-1.0`, `happyhorse-1.0-i2v`, `happyhorse-1.0-t2v`, `happyhorse-1.0-r2v`, and `happyhorse-1.0-video-edit`; Wan supports `wan-3.0`, `wan-3.0-480p`, and `wan-3.0-1080p`. Among them, `happyhorse-1.0` is an aggregated model and must be distinguished via `mode` into `t2v`, `i2v`, `r2v`, and `video_edit`. The three Wan models are fixed at 720P, 480P, and 1080P respectively, and support 2 to 30 seconds plus up to 10 image, 5 video, and 5 audio references.\n\nThe public API keeps the official endpoint format; channel-specific prefixes are only concatenated internally when the gateway requests a specific upstream channel. Clients do not need to pass `X-DashScope-Async` explicitly; it is handled by the gateway or the official channel adapter layer.\n\nProvides the public request skeleton, task query structure, and recommended validation template for HappyHorse and Wan video generation formats; public paths follow the official DashScope endpoint format.\n\nSupported models:\nhappyhorse-1.0, happyhorse-1.0-t2v, happyhorse-1.0-i2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit, wan-3.0, wan-3.0-480p, wan-3.0-1080p\n\nUnified request fields:\n- `model` (string, required): The external model name for HappyHorse or Wan. Wan supports `wan-3.0`, `wan-3.0-480p`, and `wan-3.0-1080p`; the HappyHorse aggregated model `happyhorse-1.0` must be used together with `mode`.\n- `mode` (string, optional): Aggregated model mode; common values are `t2v`, `i2v`, `r2v`, and `video_edit`. You can omit this for fixed submodels.\n- `input.prompt` (string, required): Prompt for video generation or editing.\n- `input.media` (array[object], optional): Multimedia input. Supports `first_frame`, `last_frame`, `reference_image`, `reference_video`, and `reference_audio`; Wan supports up to 10 images, 5 videos, and 5 audio files.\n- `parameters.duration` (integer, optional): Generation duration, in seconds.\n- `parameters.resolution` (string, optional): Output resolution. The three Wan models are fixed at `720P`, `480P`, and `1080P` respectively; common values for HappyHorse are `720P` and `1080P`.\n- `parameters.ratio` (string, optional): Output aspect ratio, commonly used for text-to-video and reference-to-video.\n- `parameters.watermark` (boolean, optional): Whether to add a watermark.\n- `parameters.seed` (integer, optional): Random seed.\n\nCommon model/mode differences:\n- `HappyHorse 聚合模型`: Supports model happyhorse-1.0; the aggregated model uses mode to distinguish the final model.\n- `HappyHorse 文生视频`: Supports model happyhorse-1.0-t2v; official-format text-to-video.\n- `HappyHorse 首帧图生视频`: Supports model happyhorse-1.0-i2v; official-format first-frame image-to-video.\n- `HappyHorse 参考生视频`: Supports model happyhorse-1.0-r2v; official-format multi-reference image-to-video.\n- `HappyHorse 视频编辑`: Supports model happyhorse-1.0-video-edit; official-format video editing.\n- `Wan 3.0 720P`: Supported model wan-3.0; Wan 3.0 official-format multimodal reference video generation.\n- `Wan 3.0 480P`: Supported model wan-3.0-480p; Wan 3.0 official-format call fixed at 480P.\n- `Wan 3.0 1080P`: Supported model wan-3.0-1080p; Wan 3.0 official-format call fixed at 1080P.","href":"/api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"This series supports OpenAI video generation formats (see the link \", _jsx(_components.a, {\n href: \"/api-reference/en/video-generation-sora-compatible-format/create-video\",\n children: \"Video generation Sora compatible formats\"\n }), \").\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"HappyHorse and the Wan video generation API, with public paths following the official DashScope protocol.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"HappyHorse supports \", _jsx(_components.code, {\n children: \"happyhorse-1.0\"\n }), \", \", _jsx(_components.code, {\n children: \"happyhorse-1.0-i2v\"\n }), \", \", _jsx(_components.code, {\n children: \"happyhorse-1.0-t2v\"\n }), \", \", _jsx(_components.code, {\n children: \"happyhorse-1.0-r2v\"\n }), \", and \", _jsx(_components.code, {\n children: \"happyhorse-1.0-video-edit\"\n }), \"; Wan supports \", _jsx(_components.code, {\n children: \"wan-3.0\"\n }), \", \", _jsx(_components.code, {\n children: \"wan-3.0-480p\"\n }), \", and \", _jsx(_components.code, {\n children: \"wan-3.0-1080p\"\n }), \". Among them, \", _jsx(_components.code, {\n children: \"happyhorse-1.0\"\n }), \" is an aggregated model and must be distinguished via \", _jsx(_components.code, {\n children: \"mode\"\n }), \" into \", _jsx(_components.code, {\n children: \"t2v\"\n }), \", \", _jsx(_components.code, {\n children: \"i2v\"\n }), \", \", _jsx(_components.code, {\n children: \"r2v\"\n }), \", and \", _jsx(_components.code, {\n children: \"video_edit\"\n }), \". The three Wan models are fixed at 720P, 480P, and 1080P respectively, and support 2 to 30 seconds plus up to 10 image, 5 video, and 5 audio references.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"The public API keeps the official endpoint format; channel-specific prefixes are only concatenated internally when the gateway requests a specific upstream channel. Clients do not need to pass \", _jsx(_components.code, {\n children: \"X-DashScope-Async\"\n }), \" explicitly; it is handled by the gateway or the official channel adapter layer.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Provides the public request skeleton, task query structure, and recommended validation template for HappyHorse and Wan video generation formats; public paths follow the official DashScope endpoint format.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Supported models:\\nhappyhorse-1.0, happyhorse-1.0-t2v, happyhorse-1.0-i2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit, wan-3.0, wan-3.0-480p, wan-3.0-1080p\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Unified request fields:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"model\"\n }), \" (string, required): The external model name for HappyHorse or Wan. Wan supports \", _jsx(_components.code, {\n children: \"wan-3.0\"\n }), \", \", _jsx(_components.code, {\n children: \"wan-3.0-480p\"\n }), \", and \", _jsx(_components.code, {\n children: \"wan-3.0-1080p\"\n }), \"; the HappyHorse aggregated model \", _jsx(_components.code, {\n children: \"happyhorse-1.0\"\n }), \" must be used together with \", _jsx(_components.code, {\n children: \"mode\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"mode\"\n }), \" (string, optional): Aggregated model mode; common values are \", _jsx(_components.code, {\n children: \"t2v\"\n }), \", \", _jsx(_components.code, {\n children: \"i2v\"\n }), \", \", _jsx(_components.code, {\n children: \"r2v\"\n }), \", and \", _jsx(_components.code, {\n children: \"video_edit\"\n }), \". You can omit this for fixed submodels.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"input.prompt\"\n }), \" (string, required): Prompt for video generation or editing.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"input.media\"\n }), \" (array[object], optional): Multimedia input. Supports \", _jsx(_components.code, {\n children: \"first_frame\"\n }), \", \", _jsx(_components.code, {\n children: \"last_frame\"\n }), \", \", _jsx(_components.code, {\n children: \"reference_image\"\n }), \", \", _jsx(_components.code, {\n children: \"reference_video\"\n }), \", and \", _jsx(_components.code, {\n children: \"reference_audio\"\n }), \"; Wan supports up to 10 images, 5 videos, and 5 audio files.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"parameters.duration\"\n }), \" (integer, optional): Generation duration, in seconds.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"parameters.resolution\"\n }), \" (string, optional): Output resolution. The three Wan models are fixed at \", _jsx(_components.code, {\n children: \"720P\"\n }), \", \", _jsx(_components.code, {\n children: \"480P\"\n }), \", and \", _jsx(_components.code, {\n children: \"1080P\"\n }), \" respectively; common values for HappyHorse are \", _jsx(_components.code, {\n children: \"720P\"\n }), \" and \", _jsx(_components.code, {\n children: \"1080P\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"parameters.ratio\"\n }), \" (string, optional): Output aspect ratio, commonly used for text-to-video and reference-to-video.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"parameters.watermark\"\n }), \" (boolean, optional): Whether to add a watermark.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"parameters.seed\"\n }), \" (integer, optional): Random seed.\"]\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Common model/mode differences:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"HappyHorse 聚合模型\"\n }), \": Supports model happyhorse-1.0; the aggregated model uses mode to distinguish the final model.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"HappyHorse 文生视频\"\n }), \": Supports model happyhorse-1.0-t2v; official-format text-to-video.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"HappyHorse 首帧图生视频\"\n }), \": Supports model happyhorse-1.0-i2v; official-format first-frame image-to-video.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"HappyHorse 参考生视频\"\n }), \": Supports model happyhorse-1.0-r2v; official-format multi-reference image-to-video.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"HappyHorse 视频编辑\"\n }), \": Supports model happyhorse-1.0-video-edit; official-format video editing.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"Wan 3.0 720P\"\n }), \": Supported model wan-3.0; Wan 3.0 official-format multimodal reference video generation.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"Wan 3.0 480P\"\n }), \": Supported model wan-3.0-480p; Wan 3.0 official-format call fixed at 480P.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"Wan 3.0 1080P\"\n }), \": Supported model wan-3.0-1080p; Wan 3.0 official-format call fixed at 1080P.\"]\n }), \"\\n\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create video (HappyHorse and Wan)","openapi":"api-reference/en/openapi.json POST /api/v1/services/aigc/video-generation/video-synthesis","generated":true,"description":"This series supports OpenAI video generation formats (see the link [Video generation Sora compatible formats](/api-reference/en/video-generation-sora-compatible-format/create-video)).\n\nHappyHorse and the Wan video generation API, with public paths following the official DashScope protocol.\n\nHappyHorse supports `happyhorse-1.0`, `happyhorse-1.0-i2v`, `happyhorse-1.0-t2v`, `happyhorse-1.0-r2v`, and `happyhorse-1.0-video-edit`; Wan supports `wan-3.0`, `wan-3.0-480p`, and `wan-3.0-1080p`. Among them, `happyhorse-1.0` is an aggregated model and must be distinguished via `mode` into `t2v`, `i2v`, `r2v`, and `video_edit`. The three Wan models are fixed at 720P, 480P, and 1080P respectively, and support 2 to 30 seconds plus up to 10 image, 5 video, and 5 audio references.\n\nThe public API keeps the official endpoint format; channel-specific prefixes are only concatenated internally when the gateway requests a specific upstream channel. Clients do not need to pass `X-DashScope-Async` explicitly; it is handled by the gateway or the official channel adapter layer.\n\nProvides the public request skeleton, task query structure, and recommended validation template for HappyHorse and Wan video generation formats; public paths follow the official DashScope endpoint format.\n\nSupported models:\nhappyhorse-1.0, happyhorse-1.0-t2v, happyhorse-1.0-i2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit, wan-3.0, wan-3.0-480p, wan-3.0-1080p\n\nUnified request fields:\n- `model` (string, required): The external model name for HappyHorse or Wan. Wan supports `wan-3.0`, `wan-3.0-480p`, and `wan-3.0-1080p`; the HappyHorse aggregated model `happyhorse-1.0` must be used together with `mode`.\n- `mode` (string, optional): Aggregated model mode; common values are `t2v`, `i2v`, `r2v`, and `video_edit`. You can omit this for fixed submodels.\n- `input.prompt` (string, required): Prompt for video generation or editing.\n- `input.media` (array[object], optional): Multimedia input. Supports `first_frame`, `last_frame`, `reference_image`, `reference_video`, and `reference_audio`; Wan supports up to 10 images, 5 videos, and 5 audio files.\n- `parameters.duration` (integer, optional): Generation duration, in seconds.\n- `parameters.resolution` (string, optional): Output resolution. The three Wan models are fixed at `720P`, `480P`, and `1080P` respectively; common values for HappyHorse are `720P` and `1080P`.\n- `parameters.ratio` (string, optional): Output aspect ratio, commonly used for text-to-video and reference-to-video.\n- `parameters.watermark` (boolean, optional): Whether to add a watermark.\n- `parameters.seed` (integer, optional): Random seed.\n\nCommon model/mode differences:\n- `HappyHorse 聚合模型`: Supports model happyhorse-1.0; the aggregated model uses mode to distinguish the final model.\n- `HappyHorse 文生视频`: Supports model happyhorse-1.0-t2v; official-format text-to-video.\n- `HappyHorse 首帧图生视频`: Supports model happyhorse-1.0-i2v; official-format first-frame image-to-video.\n- `HappyHorse 参考生视频`: Supports model happyhorse-1.0-r2v; official-format multi-reference image-to-video.\n- `HappyHorse 视频编辑`: Supports model happyhorse-1.0-video-edit; official-format video editing.\n- `Wan 3.0 720P`: Supported model wan-3.0; Wan 3.0 official-format multimodal reference video generation.\n- `Wan 3.0 480P`: Supported model wan-3.0-480p; Wan 3.0 official-format call fixed at 480P.\n- `Wan 3.0 1080P`: Supported model wan-3.0-1080p; Wan 3.0 official-format call fixed at 1080P.","href":"/api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create video (HappyHorse and Wan)","description":"This series supports OpenAI video generation formats (see the link [Video generation Sora compatible formats](/api-reference/en/video-generation-sora-compatible-format/create-video)).\n\nHappyHorse and the Wan video generation API, with public paths following the official DashScope protocol.\n\nHappyHorse supports `happyhorse-1.0`, `happyhorse-1.0-i2v`, `happyhorse-1.0-t2v`, `happyhorse-1.0-r2v`, and `happyhorse-1.0-video-edit`; Wan supports `wan-3.0`, `wan-3.0-480p`, and `wan-3.0-1080p`. Among them, `happyhorse-1.0` is an aggregated model and must be distinguished via `mode` into `t2v`, `i2v`, `r2v`, and `video_edit`. The three Wan models are fixed at 720P, 480P, and 1080P respectively, and support 2 to 30 seconds plus up to 10 image, 5 video, and 5 audio references.\n\nThe public API keeps the official endpoint format; channel-specific prefixes are only concatenated internally when the gateway requests a specific upstream channel. Clients do not need to pass `X-DashScope-Async` explicitly; it is handled by the gateway or the official channel adapter layer.\n\nProvides the public request skeleton, task query structure, and recommended validation template for HappyHorse and Wan video generation formats; public paths follow the official DashScope endpoint format.\n\nSupported models:\nhappyhorse-1.0, happyhorse-1.0-t2v, happyhorse-1.0-i2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit, wan-3.0, wan-3.0-480p, wan-3.0-1080p\n\nUnified request fields:\n- `model` (string, required): The external model name for HappyHorse or Wan. Wan supports `wan-3.0`, `wan-3.0-480p`, and `wan-3.0-1080p`; the HappyHorse aggregated model `happyhorse-1.0` must be used together with `mode`.\n- `mode` (string, optional): Aggregated model mode; common values are `t2v`, `i2v`, `r2v`, and `video_edit`. You can omit this for fixed submodels.\n- `input.prompt` (string, required): Prompt for video generation or editing.\n- `input.media` (array[object], optional): Multimedia input. Supports `first_frame`, `last_frame`, `reference_image`, `reference_video`, and `reference_audio`; Wan supports up to 10 images, 5 videos, and 5 audio files.\n- `parameters.duration` (integer, optional): Generation duration, in seconds.\n- `parameters.resolution` (string, optional): Output resolution. The three Wan models are fixed at `720P`, `480P`, and `1080P` respectively; common values for HappyHorse are `720P` and `1080P`.\n- `parameters.ratio` (string, optional): Output aspect ratio, commonly used for text-to-video and reference-to-video.\n- `parameters.watermark` (boolean, optional): Whether to add a watermark.\n- `parameters.seed` (integer, optional): Random seed.\n\nCommon model/mode differences:\n- `HappyHorse 聚合模型`: Supports model happyhorse-1.0; the aggregated model uses mode to distinguish the final model.\n- `HappyHorse 文生视频`: Supports model happyhorse-1.0-t2v; official-format text-to-video.\n- `HappyHorse 首帧图生视频`: Supports model happyhorse-1.0-i2v; official-format first-frame image-to-video.\n- `HappyHorse 参考生视频`: Supports model happyhorse-1.0-r2v; official-format multi-reference image-to-video.\n- `HappyHorse 视频编辑`: Supports model happyhorse-1.0-video-edit; official-format video editing.\n- `Wan 3.0 720P`: Supported model wan-3.0; Wan 3.0 official-format multimodal reference video generation.\n- `Wan 3.0 480P`: Supported model wan-3.0-480p; Wan 3.0 official-format call fixed at 480P.\n- `Wan 3.0 1080P`: Supported model wan-3.0-1080p; Wan 3.0 official-format call fixed at 1080P.","operationId":"create__happyhorse_wan_task","tags":["Video generationHappyHorse and Wan"],"requestBody":"230dbd0a-9d51-4a19-b3e6-cc8f75b4db1a","responses":{"200":"9fb0ef78-6f69-4805-84fa-ff5bf6e2a8a2"},"security":["fb284d5f-0276-4e2a-9254-c17eaf2fe42c"],"x-mint":{"href":"/api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan"},"method":"post","type":"path","servers":["96249d24-7648-4dcd-a630-a1a9cdfe7c23"],"path":"/api/v1/services/aigc/video-generation/video-synthesis","baseUrlOptions":["https://api.aiid.edu.kg"],"title":"Create video (HappyHorse and Wan)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","input"],"properties":{"model":{"type":"string","enum":["happyhorse-1.0","happyhorse-1.0-t2v","happyhorse-1.0-i2v","happyhorse-1.0-r2v","happyhorse-1.0-video-edit","wan-3.0","wan-3.0-480p","wan-3.0-1080p"],"example":"happyhorse-1.0-t2v","description":"HappyHorse or Wan public model name. Wan supports `wan-3.0`, `wan-3.0-480p`, and `wan-3.0-1080p`; the HappyHorse aggregated model `happyhorse-1.0` must be used with `mode`.","isRequired":true,"uniqueKey":"model","typeLabel":"enum\u003cstring>"},"input":{"type":"object","required":["prompt"],"properties":{"prompt":{"type":"string","example":"A white horse running through a neon city street, cinematic","description":"Prompt for video generation or editing.","isRequired":true,"uniqueKey":"input.prompt","typeLabel":"string"},"media":{"type":"array","items":{"type":"object","required":["type","url"],"properties":{"type":{"type":"string","enum":["first_frame","last_frame","reference_image","reference_video","reference_audio","video","audio"],"isRequired":true,"uniqueKey":"input.media.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"input.media.items.[INDEX].url","typeLabel":"string\u003curi>"}},"uniqueKey":"input.media.items.[INDEX]","typeLabel":"object"},"description":"Multimedia input. Supports `first_frame`, `last_frame`, `reference_image`, `reference_video`, and `reference_audio`; Wan supports up to 10 images, 5 videos, and 5 audio files.","uniqueKey":"input.media","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"input","typeLabel":"object"},"mode":{"type":"string","enum":["t2v","i2v","r2v","video_edit"],"description":"Aggregated model mode. Common values are `t2v`, `i2v`, `r2v`, and `video_edit`. The fixed submodel is optional.","uniqueKey":"mode","typeLabel":"enum\u003cstring>"},"parameters":{"type":"object","properties":{"resolution":{"type":"string","enum":["480P","720P","1080P"],"example":"720P","description":"Output resolution. The three Wan models are fixed at `720P`, `480P`, and `1080P` respectively; the common values for HappyHorse are `720P` and `1080P`.","uniqueKey":"parameters.resolution","typeLabel":"enum\u003cstring>"},"ratio":{"type":"string","example":"16:9","description":"Output aspect ratio, commonly used for text-to-video and reference-to-video.","uniqueKey":"parameters.ratio","typeLabel":"string"},"duration":{"type":"integer","example":5,"description":"Generation duration in seconds.","uniqueKey":"parameters.duration","typeLabel":"integer"},"watermark":{"type":"boolean","description":"Whether to add a watermark.","uniqueKey":"parameters.watermark","typeLabel":"boolean"},"seed":{"type":"integer","description":"Random seed.","uniqueKey":"parameters.seed","typeLabel":"integer"}},"uniqueKey":"parameters","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"happyhorse_native_aggregate_t2v":{"title":"happyhorse_native_aggregate_t2v","value":{"model":"happyhorse-1.0","mode":"t2v","input":{"prompt":"A white horse running through a neon city street, cinematic"},"parameters":{"resolution":"720P","ratio":"16:9","duration":5}}},"happyhorse_native_t2v":{"title":"happyhorse_native_t2v","value":{"model":"happyhorse-1.0-t2v","input":{"prompt":"A white horse running through a neon city street, cinematic"},"parameters":{"resolution":"720P","ratio":"16:9","duration":5}}},"happyhorse_native_i2v":{"title":"happyhorse_native_i2v","value":{"model":"happyhorse-1.0-i2v","input":{"prompt":"The subject walks forward naturally","media":[{"type":"first_frame","url":"https://example.com/first-frame.jpg"}]},"parameters":{"resolution":"720P","duration":5}}},"happyhorse_native_r2v":{"title":"happyhorse_native_r2v","value":{"model":"happyhorse-1.0-r2v","input":{"prompt":"Keep the character and product consistent in a cinematic shot","media":[{"type":"reference_image","url":"https://example.com/ref-1.jpg"},{"type":"reference_image","url":"https://example.com/ref-2.jpg"}]},"parameters":{"resolution":"720P","ratio":"16:9","duration":5}}},"happyhorse_native_video_edit":{"title":"happyhorse_native_video_edit","value":{"model":"happyhorse-1.0-video-edit","input":{"prompt":"Change the jacket to a striped sweater","media":[{"type":"video","url":"https://example.com/input.mp4"},{"type":"reference_image","url":"https://example.com/reference.jpg"}]},"parameters":{"resolution":"720P"}}},"wan_3_0_native":{"title":"wan_3_0_native","value":{"model":"wan-3.0","input":{"prompt":"Keep the character consistent across all references","media":[{"type":"reference_image","url":"https://example.com/reference.jpg"},{"type":"reference_audio","url":"https://example.com/reference.mp3"}]},"parameters":{"resolution":"720P","ratio":"16:9","duration":10}}},"wan_3_0_480p_native":{"title":"wan_3_0_480p_native","value":{"model":"wan-3.0-480p","input":{"prompt":"Create a smooth transition","media":[{"type":"first_frame","url":"https://example.com/first.jpg"},{"type":"last_frame","url":"https://example.com/last.jpg"}]},"parameters":{"resolution":"480P","ratio":"16:9","duration":10}}},"wan_3_0_1080p_native":{"title":"wan_3_0_1080p_native","value":{"model":"wan-3.0-1080p","input":{"prompt":"Generate a cinematic reference video","media":[{"type":"reference_video","url":"https://example.com/reference.mp4"}]},"parameters":{"resolution":"1080P","ratio":"16:9","duration":10}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"9fb0ef78-6f69-4805-84fa-ff5bf6e2a8a2":{"description":"Task created successfully","content":{"application/json":{"schema":{"type":"object","required":["id"],"properties":{"id":{"type":"string","example":"task_xxx","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"output":{"type":"object","properties":{"task_id":{"type":"string","description":"The task ID returned when creating a task, used to query the task.","uniqueKey":"output.task_id","typeLabel":"string"},"task_status":{"type":"string","description":"Task status, common values `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`.","uniqueKey":"output.task_status","typeLabel":"string"},"video_url":{"type":"string","description":"The URL of the generated video after the task succeeds.","uniqueKey":"output.video_url","typeLabel":"string"}},"uniqueKey":"output","typeLabel":"object"},"usage":{"type":"object","properties":{"duration":{"type":"string","description":"Generation duration in seconds.","uniqueKey":"usage.duration","typeLabel":"string"},"SR":{"type":"string","description":"Output resolution levels.","uniqueKey":"usage.SR","typeLabel":"string"}},"uniqueKey":"usage","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"task_xxx","output":{"task_id":"\u003cstring>","task_status":"\u003cstring>","video_url":"\u003cstring>"},"usage":{"duration":"\u003cstring>","SR":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"fb284d5f-0276-4e2a-9254-c17eaf2fe42c":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Use Bearer Token authentication.\nFormat: `Authorization: Bearer sk-xxxxxx`","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"96249d24-7648-4dcd-a630-a1a9cdfe7c23":{"url":"https://api.aiid.edu.kg"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Use Bearer Token authentication.\nFormat: `Authorization: Bearer sk-xxxxxx`","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Use Bearer Token authentication.\nFormat: `Authorization: Bearer sk-xxxxxx`","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-reference/en/openapi.json"},"subdomain":"btc-de295b31","siteName":"OverseasAPI","title":"Create video (HappyHorse and Wan) - OverseasAPI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan","matchLevel":0},"cn":{"href":"/api-reference/cn/conventions","matchLevel":4},"zh-Hant":{"href":"/api-reference/zh-tw/conventions","matchLevel":4},"fr":{"href":"/api-reference/fr/conventions","matchLevel":4},"ja":{"href":"/api-reference/ja/conventions","matchLevel":4},"ru":{"href":"/api-reference/ru/conventions","matchLevel":4},"vi":{"href":"/api-reference/vi/conventions","matchLevel":4}}},"lastModified":"2026-10-23T20:35:03.487Z","originalFileLocation":"api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"This series supports OpenAI video generation formats (see the link Video generation Sora compatible formats). HappyHorse and the Wan video generation API, with public paths following the official DashScope protocol. HappyHorse supports happyhorse-1.0, happyhorse-1.0-i2v, happyhorse-1.0-t2v, happyhorse-1.0-r2v, and happyhorse-1.0-video-edit; Wan supports wan-3.0, wan-3.0-480p, and wan-3.0-1080p. Among them, happyhorse-1.0 is an aggregated model and must be distinguished via mode into t2v, i2v, r2v, and video_edit. The three Wan models are fixed at 720P, 480P, and 1080P respectively, and support 2 to 30 seconds plus up to 10 image, 5 video, and 5 audio references. The public API keeps the official endpoint format; channel-specific prefixes are only concatenated internally when the gateway requests a specific upstream channel. Clients do not need to pass X-DashScope-Async explicitly; it is handled by the gateway or the official channel adapter layer. Provides the public request skeleton, task query structure, and recommended validation template for HappyHorse and Wan video generation formats; public paths follow the official DashScope endpoint format. Supported models: happyhorse-1.0, happyhorse-1.0-t2v, happyhorse-1.0-i2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit, wan-3.0, wan-3.0-480p, wan-3.0-1080p Unified request fields: - model (string, required): The external model name for HappyHorse or Wan. Wan supports wan-3.0, wan-3.0-480p, and wan-3.0-1080p; the HappyHorse aggregated model happyhorse-1.0 must be used together with mode. - mode (string, optional): Aggregated model mode; common values are t2v, i2v, r2v, and video_edit. You can omit this for fixed submodels. - input.prompt (string, required): Prompt for video generation or editing. - input.media (array[object], optional): Multimedia input. Supports first_frame, last_frame, reference_image, reference_video, and reference_audio; Wan supports up to 10 images, 5 videos, and 5 audio files. - parameters.duration (integer, optional): Generation duration, in seconds. - parameters.resolution (string, optional): Output resolution. The three Wan models are fixed at 720P, 480P, and 1080P respectively; common values for HappyHorse are 720P and 1080P. - parameters.ratio (string, optional): Output aspect ratio, commonly used for text-to-video and reference-to-video. - parameters.watermark (boolean, optional): Whether to add a watermark. - parameters.seed (integer, optional): Random seed. Common model/mode differences: - HappyHorse 聚合模型: Supports model happyhorse-1.0; the aggregated model uses mode to distinguish the final model. - HappyHorse 文生视频: Supports model happyhorse-1.0-t2v; official-format text-to-video. - HappyHorse 首帧图生视频: Supports model happyhorse-1.0-i2v; official-format first-frame image-to-video. - HappyHorse 参考生视频: Supports model happyhorse-1.0-r2v; official-format multi-reference image-to-video. - HappyHorse 视频编辑: Supports model happyhorse-1.0-video-edit; official-format video editing. - Wan 3.0 720P: Supported model wan-3.0; Wan 3.0 official-format multimodal reference video generation. - Wan 3.0 480P: Supported model wan-3.0-480p; Wan 3.0 official-format call fixed at 480P. - Wan 3.0 1080P: Supported model wan-3.0-1080p; Wan 3.0 official-format call fixed at 1080P.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OverseasAPI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/btc-de295b31/IplwZem2it_4bFJe/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/btc-de295b31/IplwZem2it_4bFJe/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/btc-de295b31/IplwZem2it_4bFJe/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/btc-de295b31/IplwZem2it_4bFJe/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/btc-de295b31/IplwZem2it_4bFJe/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/btc-de295b31/IplwZem2it_4bFJe/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/btc-de295b31/IplwZem2it_4bFJe/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/btc-de295b31/IplwZem2it_4bFJe/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/btc-de295b31/IplwZem2it_4bFJe/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create video (HappyHorse and Wan) - OverseasAPI\">\u003cmeta data-mint-head property=\"og:description\" content=\"This series supports OpenAI video generation formats (see the link Video generation Sora compatible formats). HappyHorse and the Wan video generation API, with public paths following the official DashScope protocol. HappyHorse supports happyhorse-1.0, happyhorse-1.0-i2v, happyhorse-1.0-t2v, happyhorse-1.0-r2v, and happyhorse-1.0-video-edit; Wan supports wan-3.0, wan-3.0-480p, and wan-3.0-1080p. Among them, happyhorse-1.0 is an aggregated model and must be distinguished via mode into t2v, i2v, r2v, and video_edit. The three Wan models are fixed at 720P, 480P, and 1080P respectively, and support 2 to 30 seconds plus up to 10 image, 5 video, and 5 audio references. The public API keeps the official endpoint format; channel-specific prefixes are only concatenated internally when the gateway requests a specific upstream channel. Clients do not need to pass X-DashScope-Async explicitly; it is handled by the gateway or the official channel adapter layer. Provides the public request skeleton, task query structure, and recommended validation template for HappyHorse and Wan video generation formats; public paths follow the official DashScope endpoint format. Supported models: happyhorse-1.0, happyhorse-1.0-t2v, happyhorse-1.0-i2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit, wan-3.0, wan-3.0-480p, wan-3.0-1080p Unified request fields: - model (string, required): The external model name for HappyHorse or Wan. Wan supports wan-3.0, wan-3.0-480p, and wan-3.0-1080p; the HappyHorse aggregated model happyhorse-1.0 must be used together with mode. - mode (string, optional): Aggregated model mode; common values are t2v, i2v, r2v, and video_edit. You can omit this for fixed submodels. - input.prompt (string, required): Prompt for video generation or editing. - input.media (array[object], optional): Multimedia input. Supports first_frame, last_frame, reference_image, reference_video, and reference_audio; Wan supports up to 10 images, 5 videos, and 5 audio files. - parameters.duration (integer, optional): Generation duration, in seconds. - parameters.resolution (string, optional): Output resolution. The three Wan models are fixed at 720P, 480P, and 1080P respectively; common values for HappyHorse are 720P and 1080P. - parameters.ratio (string, optional): Output aspect ratio, commonly used for text-to-video and reference-to-video. - parameters.watermark (boolean, optional): Whether to add a watermark. - parameters.seed (integer, optional): Random seed. Common model/mode differences: - HappyHorse 聚合模型: Supports model happyhorse-1.0; the aggregated model uses mode to distinguish the final model. - HappyHorse 文生视频: Supports model happyhorse-1.0-t2v; official-format text-to-video. - HappyHorse 首帧图生视频: Supports model happyhorse-1.0-i2v; official-format first-frame image-to-video. - HappyHorse 参考生视频: Supports model happyhorse-1.0-r2v; official-format multi-reference image-to-video. - HappyHorse 视频编辑: Supports model happyhorse-1.0-video-edit; official-format video editing. - Wan 3.0 720P: Supported model wan-3.0; Wan 3.0 official-format multimodal reference video generation. - Wan 3.0 480P: Supported model wan-3.0-480p; Wan 3.0 official-format call fixed at 480P. - Wan 3.0 1080P: Supported model wan-3.0-1080p; Wan 3.0 official-format call fixed at 1080P.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OverseasAPI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.aiid.edu.kg/api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://btc-de295b31.mintlify.app/_mintlify/api/og/v2?division=Video+generationHappyHorse+and+Wan\u0026amp;title=Create+video+%28HappyHorse+and+Wan%29\u0026amp;description=This+series+supports+OpenAI+video+generation+formats+%28see+the+link+%5BVideo+generation+Sora+compatible+formats%5D%28%2Fapi-reference%2Fen%2Fvideo-generation-sora-compatible\u0026amp;theme=4acb683881b01fff206da5f1\u0026amp;signature=d9148f5c53be2551c608e6c09e7e73c7c240df5bd9d5cb9c65a1c114357e6156\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create video (HappyHorse and Wan) - OverseasAPI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This series supports OpenAI video generation formats (see the link Video generation Sora compatible formats). HappyHorse and the Wan video generation API, with public paths following the official DashScope protocol. HappyHorse supports happyhorse-1.0, happyhorse-1.0-i2v, happyhorse-1.0-t2v, happyhorse-1.0-r2v, and happyhorse-1.0-video-edit; Wan supports wan-3.0, wan-3.0-480p, and wan-3.0-1080p. Among them, happyhorse-1.0 is an aggregated model and must be distinguished via mode into t2v, i2v, r2v, and video_edit. The three Wan models are fixed at 720P, 480P, and 1080P respectively, and support 2 to 30 seconds plus up to 10 image, 5 video, and 5 audio references. The public API keeps the official endpoint format; channel-specific prefixes are only concatenated internally when the gateway requests a specific upstream channel. Clients do not need to pass X-DashScope-Async explicitly; it is handled by the gateway or the official channel adapter layer. Provides the public request skeleton, task query structure, and recommended validation template for HappyHorse and Wan video generation formats; public paths follow the official DashScope endpoint format. Supported models: happyhorse-1.0, happyhorse-1.0-t2v, happyhorse-1.0-i2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit, wan-3.0, wan-3.0-480p, wan-3.0-1080p Unified request fields: - model (string, required): The external model name for HappyHorse or Wan. Wan supports wan-3.0, wan-3.0-480p, and wan-3.0-1080p; the HappyHorse aggregated model happyhorse-1.0 must be used together with mode. - mode (string, optional): Aggregated model mode; common values are t2v, i2v, r2v, and video_edit. You can omit this for fixed submodels. - input.prompt (string, required): Prompt for video generation or editing. - input.media (array[object], optional): Multimedia input. Supports first_frame, last_frame, reference_image, reference_video, and reference_audio; Wan supports up to 10 images, 5 videos, and 5 audio files. - parameters.duration (integer, optional): Generation duration, in seconds. - parameters.resolution (string, optional): Output resolution. The three Wan models are fixed at 720P, 480P, and 1080P respectively; common values for HappyHorse are 720P and 1080P. - parameters.ratio (string, optional): Output aspect ratio, commonly used for text-to-video and reference-to-video. - parameters.watermark (boolean, optional): Whether to add a watermark. - parameters.seed (integer, optional): Random seed. Common model/mode differences: - HappyHorse 聚合模型: Supports model happyhorse-1.0; the aggregated model uses mode to distinguish the final model. - HappyHorse 文生视频: Supports model happyhorse-1.0-t2v; official-format text-to-video. - HappyHorse 首帧图生视频: Supports model happyhorse-1.0-i2v; official-format first-frame image-to-video. - HappyHorse 参考生视频: Supports model happyhorse-1.0-r2v; official-format multi-reference image-to-video. - HappyHorse 视频编辑: Supports model happyhorse-1.0-video-edit; official-format video editing. - Wan 3.0 720P: Supported model wan-3.0; Wan 3.0 official-format multimodal reference video generation. - Wan 3.0 480P: Supported model wan-3.0-480p; Wan 3.0 official-format call fixed at 480P. - Wan 3.0 1080P: Supported model wan-3.0-1080p; Wan 3.0 official-format call fixed at 1080P.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://btc-de295b31.mintlify.app/_mintlify/api/og/v2?division=Video+generationHappyHorse+and+Wan\u0026amp;title=Create+video+%28HappyHorse+and+Wan%29\u0026amp;description=This+series+supports+OpenAI+video+generation+formats+%28see+the+link+%5BVideo+generation+Sora+compatible+formats%5D%28%2Fapi-reference%2Fen%2Fvideo-generation-sora-compatible\u0026amp;theme=4acb683881b01fff206da5f1\u0026amp;signature=d9148f5c53be2551c608e6c09e7e73c7c240df5bd9d5cb9c65a1c114357e6156\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/btc-de295b31/IplwZem2it_4bFJe/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OverseasAPI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6d28d9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.aiid.edu.kg/api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.aiid.edu.kg/#organization\",\"name\":\"OverseasAPI\",\"url\":\"https://docs.aiid.edu.kg\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/btc-de295b31/dNi9LBWUBzALFywP/public/assets/logo.webp?fit=max\u0026auto=format\u0026n=dNi9LBWUBzALFywP\u0026q=85\u0026s=bac78dc112e5baf91eafeb0fffd5fd7d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.aiid.edu.kg#website\",\"name\":\"OverseasAPI\",\"url\":\"https://docs.aiid.edu.kg\",\"publisher\":{\"@id\":\"https://docs.aiid.edu.kg/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.aiid.edu.kg/api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan#webpage\",\"url\":\"https://docs.aiid.edu.kg/api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan\",\"name\":\"Create video (HappyHorse and Wan)\",\"description\":\"This series supports OpenAI video generation formats (see the link Video generation Sora compatible formats). HappyHorse and the Wan video generation API, with public paths following the official DashScope protocol. HappyHorse supports happyhorse-1.0, happyhorse-1.0-i2v, happyhorse-1.0-t2v, happyhorse-1.0-r2v, and happyhorse-1.0-video-edit; Wan supports wan-3.0, wan-3.0-480p, and wan-3.0-1080p. Among them, happyhorse-1.0 is an aggregated model and must be distinguished via mode into t2v, i2v, r2v, and video_edit. The three Wan models are fixed at 720P, 480P, and 1080P respectively, and support 2 to 30 seconds plus up to 10 image, 5 video, and 5 audio references. The public API keeps the official endpoint format; channel-specific prefixes are only concatenated internally when the gateway requests a specific upstream channel. Clients do not need to pass X-DashScope-Async explicitly; it is handled by the gateway or the official channel adapter layer. Provides the public request skeleton, task query structure, and recommended validation template for HappyHorse and Wan video generation formats; public paths follow the official DashScope endpoint format. Supported models: happyhorse-1.0, happyhorse-1.0-t2v, happyhorse-1.0-i2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit, wan-3.0, wan-3.0-480p, wan-3.0-1080p Unified request fields: - model (string, required): The external model name for HappyHorse or Wan. Wan supports wan-3.0, wan-3.0-480p, and wan-3.0-1080p; the HappyHorse aggregated model happyhorse-1.0 must be used together with mode. - mode (string, optional): Aggregated model mode; common values are t2v, i2v, r2v, and video_edit. You can omit this for fixed submodels. - input.prompt (string, required): Prompt for video generation or editing. - input.media (array[object], optional): Multimedia input. Supports first_frame, last_frame, reference_image, reference_video, and reference_audio; Wan supports up to 10 images, 5 videos, and 5 audio files. - parameters.duration (integer, optional): Generation duration, in seconds. - parameters.resolution (string, optional): Output resolution. The three Wan models are fixed at 720P, 480P, and 1080P respectively; common values for HappyHorse are 720P and 1080P. - parameters.ratio (string, optional): Output aspect ratio, commonly used for text-to-video and reference-to-video. - parameters.watermark (boolean, optional): Whether to add a watermark. - parameters.seed (integer, optional): Random seed. Common model/mode differences: - HappyHorse 聚合模型: Supports model happyhorse-1.0; the aggregated model uses mode to distinguish the final model. - HappyHorse 文生视频: Supports model happyhorse-1.0-t2v; official-format text-to-video. - HappyHorse 首帧图生视频: Supports model happyhorse-1.0-i2v; official-format first-frame image-to-video. - HappyHorse 参考生视频: Supports model happyhorse-1.0-r2v; official-format multi-reference image-to-video. - HappyHorse 视频编辑: Supports model happyhorse-1.0-video-edit; official-format video editing. - Wan 3.0 720P: Supported model wan-3.0; Wan 3.0 official-format multimodal reference video generation. - Wan 3.0 480P: Supported model wan-3.0-480p; Wan 3.0 official-format call fixed at 480P. - Wan 3.0 1080P: Supported model wan-3.0-1080p; Wan 3.0 official-format call fixed at 1080P.\",\"dateModified\":\"2026-10-23T20:35:03.487Z\",\"isPartOf\":{\"@id\":\"https://docs.aiid.edu.kg#website\"},\"breadcrumb\":{\"@id\":\"https://docs.aiid.edu.kg/api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.aiid.edu.kg/api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"OverseasAPI\",\"item\":\"https://docs.aiid.edu.kg\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create video (HappyHorse and Wan)\",\"item\":\"https://docs.aiid.edu.kg/api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.aiid.edu.kg/api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan#apireference\",\"headline\":\"Create video (HappyHorse and Wan)\",\"name\":\"Create video (HappyHorse and Wan)\",\"description\":\"This series supports OpenAI video generation formats (see the link Video generation Sora compatible formats). HappyHorse and the Wan video generation API, with public paths following the official DashScope protocol. HappyHorse supports happyhorse-1.0, happyhorse-1.0-i2v, happyhorse-1.0-t2v, happyhorse-1.0-r2v, and happyhorse-1.0-video-edit; Wan supports wan-3.0, wan-3.0-480p, and wan-3.0-1080p. Among them, happyhorse-1.0 is an aggregated model and must be distinguished via mode into t2v, i2v, r2v, and video_edit. The three Wan models are fixed at 720P, 480P, and 1080P respectively, and support 2 to 30 seconds plus up to 10 image, 5 video, and 5 audio references. The public API keeps the official endpoint format; channel-specific prefixes are only concatenated internally when the gateway requests a specific upstream channel. Clients do not need to pass X-DashScope-Async explicitly; it is handled by the gateway or the official channel adapter layer. Provides the public request skeleton, task query structure, and recommended validation template for HappyHorse and Wan video generation formats; public paths follow the official DashScope endpoint format. Supported models: happyhorse-1.0, happyhorse-1.0-t2v, happyhorse-1.0-i2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit, wan-3.0, wan-3.0-480p, wan-3.0-1080p Unified request fields: - model (string, required): The external model name for HappyHorse or Wan. Wan supports wan-3.0, wan-3.0-480p, and wan-3.0-1080p; the HappyHorse aggregated model happyhorse-1.0 must be used together with mode. - mode (string, optional): Aggregated model mode; common values are t2v, i2v, r2v, and video_edit. You can omit this for fixed submodels. - input.prompt (string, required): Prompt for video generation or editing. - input.media (array[object], optional): Multimedia input. Supports first_frame, last_frame, reference_image, reference_video, and reference_audio; Wan supports up to 10 images, 5 videos, and 5 audio files. - parameters.duration (integer, optional): Generation duration, in seconds. - parameters.resolution (string, optional): Output resolution. The three Wan models are fixed at 720P, 480P, and 1080P respectively; common values for HappyHorse are 720P and 1080P. - parameters.ratio (string, optional): Output aspect ratio, commonly used for text-to-video and reference-to-video. - parameters.watermark (boolean, optional): Whether to add a watermark. - parameters.seed (integer, optional): Random seed. Common model/mode differences: - HappyHorse 聚合模型: Supports model happyhorse-1.0; the aggregated model uses mode to distinguish the final model. - HappyHorse 文生视频: Supports model happyhorse-1.0-t2v; official-format text-to-video. - HappyHorse 首帧图生视频: Supports model happyhorse-1.0-i2v; official-format first-frame image-to-video. - HappyHorse 参考生视频: Supports model happyhorse-1.0-r2v; official-format multi-reference image-to-video. - HappyHorse 视频编辑: Supports model happyhorse-1.0-video-edit; official-format video editing. - Wan 3.0 720P: Supported model wan-3.0; Wan 3.0 official-format multimodal reference video generation. - Wan 3.0 480P: Supported model wan-3.0-480p; Wan 3.0 official-format call fixed at 480P. - Wan 3.0 1080P: Supported model wan-3.0-1080p; Wan 3.0 official-format call fixed at 1080P.\",\"url\":\"https://docs.aiid.edu.kg/api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan\",\"mainEntityOfPage\":{\"@id\":\"https://docs.aiid.edu.kg/api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan#webpage\"},\"dateModified\":\"2026-10-23T20:35:03.487Z\",\"publisher\":{\"@id\":\"https://docs.aiid.edu.kg/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.aiid.edu.kg#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OverseasAPI\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"OverseasAPI","nav":{"global":null,"languages":[{"language":"en","footer":{"socials":{"telegram":"https://t.me/overseas_api"}},"navbar":{"links":[{"href":"mailto:support@aiid.edu.kg","label":"Support"},{"href":"https://aiid.edu.kg/pricing","label":"Pricing"}],"primary":{"type":"button","label":"Console","href":"https://aiid.edu.kg/console"}},"tabs":[{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Calling Conventions","href":"/api-reference/en/conventions"},{"title":"Quickstart","href":"/api-reference/en/quickstart"},{"title":"Online Debugging","href":"/api-reference/en/online-debug"},{"title":"AI-Generated Integration Code","href":"/api-reference/en/ai-codegen"}]},{"group":"Gemini Format for Image Generation","pages":[{"title":"Gemini Images (Nano Banana)","openapi":"api-reference/en/openapi.json POST /v1beta/models/{model}:generateContent","href":"/api-reference/en/image-generation-gemini-format/gemini-images-nano-banana"}]},{"group":"Image generationOpenAI DALL-E format","pages":[{"title":"Edit images (OpenAI Dall-E compatible)","openapi":"api-reference/en/openapi.json POST /v1/images/edits","href":"/api-reference/en/image-generation-openai-dall-e-format/edit-images-openai-dall-e-compatible"},{"title":"Generate images (compatible with OpenAI Dall-E)","openapi":"api-reference/en/openapi.json POST /v1/images/generations","href":"/api-reference/en/image-generation-openai-dall-e-format/generate-images-compatible-with-openai-dall-e"}]},{"group":"List models","pages":[{"title":"List models","openapi":"api-reference/en/openapi.json GET /v1/models","href":"/api-reference/en/list-models/list-models"},{"title":"Get Gemini Format","openapi":"api-reference/en/openapi.json GET /v1beta/models","href":"/api-reference/en/list-models/get-gemini-format"}]},{"group":"Music generation task format","pages":[{"title":"Query a music task by ID","openapi":"api-reference/en/openapi.json GET /suno/fetch/{task_id}","href":"/api-reference/en/music-generation-task-format/query-a-music-task-by-id"},{"title":"Create a music or sound generation task","openapi":"api-reference/en/openapi.json POST /suno/submit/music","href":"/api-reference/en/music-generation-task-format/create-a-music-or-sound-generation-task"}]},{"group":"OpenAI Format (Responses)","pages":[{"title":"Create response (OpenAI Responses API)","openapi":"api-reference/en/openapi.json POST /v1/responses","href":"/api-reference/en/openai-format-responses/create-response"},{"title":"Query responses (OpenAI Responses API)","openapi":"api-reference/en/openapi.json GET /v1/responses/{response_id}","href":"/api-reference/en/openai-format-responses/query-responses-openai-responses-api"}]},{"group":"OpenAI format (Chat)","pages":[{"title":"Create chat session","openapi":"api-reference/en/openapi.json POST /v1/chat/completions","href":"/api-reference/en/openai-format-chat/create-chat-session"}]},{"group":"Video generation Kling format","pages":[{"title":"Kling Image-to-Video","openapi":"api-reference/en/openapi.json POST /image-to-video/kling-4.0","href":"/api-reference/en/video-generation-kling-format/create-kling-image-to-video"},{"title":"Kling Text-to-Video","openapi":"api-reference/en/openapi.json POST /text-to-video/kling-4.0","href":"/api-reference/en/video-generation-kling-format/create-kling-text-to-video"},{"title":"Kling All-in-One Reference","openapi":"api-reference/en/openapi.json POST /omni-video/kling-4.0","href":"/api-reference/en/video-generation-kling-format/kling-all-in-one-reference"},{"title":"Batch Query Kling Tasks","openapi":"api-reference/en/openapi.json GET /tasks","href":"/api-reference/en/video-generation-kling-format/batch-query-kling-tasks"}]},{"group":"Video generation Omni and Veo formats","pages":[{"title":"Create video (Omni and Veo formats)","openapi":"api-reference/en/openapi.json POST /v1beta/models/{model}:predictLongRunning","href":"/api-reference/en/video-generation-omni-and-veo-formats/create-video-omni-and-veo-formats"},{"title":"Query tasks (Omni and Veo formats)","openapi":"api-reference/en/openapi.json GET /v1beta/{operation_name}","href":"/api-reference/en/video-generation-omni-and-veo-formats/query-tasks-omni-and-veo-formats"}]},{"group":"Video generation Seedance","pages":[{"title":"Create video (Seedance)","openapi":"api-reference/en/openapi.json POST /api/v3/contents/generations/tasks","href":"/api-reference/en/video-generation-seedance/create-video-seedance"},{"title":"Query task (Seedance)","openapi":"api-reference/en/openapi.json GET /api/v3/contents/generations/tasks/{task_id}","href":"/api-reference/en/video-generation-seedance/get-task-seedance"}]},{"group":"Video generation Sora compatible formats","pages":[{"title":"Create video","openapi":"api-reference/en/openapi.json POST /v1/videos","href":"/api-reference/en/video-generation-sora-compatible-formats/create-video"},{"title":"Get video task status","openapi":"api-reference/en/openapi.json GET /v1/videos/{task_id}","href":"/api-reference/en/video-generation-sora-compatible-formats/get-video-task-status"},{"title":"Get video content","openapi":"api-reference/en/openapi.json GET /v1/videos/{task_id}/content","href":"/api-reference/en/video-generation-sora-compatible-formats/get-video-content"}]},{"group":"Video generation Vidu","pages":[{"title":"Create image-to-video (Vidu)","openapi":"api-reference/en/openapi.json POST /ent/v2/img2video","href":"/api-reference/en/video-generation-vidu/create-image-to-video-vidu"},{"title":"Create reference-generated video(Vidu)","openapi":"api-reference/en/openapi.json POST /ent/v2/reference2video","href":"/api-reference/en/video-generation-vidu/create-reference-generated-videovidu"},{"title":"Create a start-and-end frame video(Vidu)","openapi":"api-reference/en/openapi.json POST /ent/v2/start-end2video","href":"/api-reference/en/video-generation-vidu/create-a-start-and-end-frame-videovidu"},{"title":"Query tasks(Vidu)","openapi":"api-reference/en/openapi.json GET /ent/v2/tasks/{task_id}/creations","href":"/api-reference/en/video-generation-vidu/query-tasksvidu"},{"title":"Create text-to-video (Vidu)","openapi":"api-reference/en/openapi.json POST /ent/v2/text2video","description":"This series supports OpenAI video generation formats (see the link [Video generation Sora compatible formats](/api-reference/en/video-generation-sora-compatible-format/create-video)).\n\nVidu official video generation API; the public path follows the Vidu official specification.\n\n`viduq3-turbo`, `viduq2`, and `vidu2.0` support text-to-video, image-to-video, first-and-last-frame video generation, or reference-to-video according to their respective capabilities. They can also be accessed through the `/v1/videos` Sora compatible format.\n\nVidu Q4: `vidu-q4` is fixed at 720p, and `vidu-q4-540p` is fixed at 540p. Supports generating videos from 3 to 16 seconds. At least 1 image is required, with up to 15 reference images supported. Reference generation can include up to 3 MP3 audio clips, each 3 to 12 seconds long and up to 50 MB. Pure text-to-video, specified first and last frames, and reference videos are not supported. Multiple images are used as joint references and do not indicate first or last frame positions. Tasks can be created via `POST /v1/videos`, `POST /api/v3/contents/generations/tasks`, or the Vidu formats `POST /ent/v2/img2video` and `POST /ent/v2/reference2video`. For the unified endpoint, `mode=reference_images` is recommended; use `mode=reference_material` when including audio. Reference audio can use `audio_urls`. The Seedance format can also use the `audio_url` field of the standard `content`; the `audio` Boolean field controls audio generation and is used separately from the reference audio URL list. The resolution must match the model name.\n\nProvides the public request skeleton, task query structure, and recommended validation template for the Vidu official video generation format, while the public path retains the Vidu official endpoint format.\n\nSupported models:\nviduq3-turbo, viduq2, vidu2.0\n\nUnified request fields:\n- `model` (string, required): Public model name for Vidu. Vidu Q4 supports only image-to-video and reference-to-video with images; Q3/Q2/V2 retain their respective capabilities.\n- `prompt` (string, optional): Video generation prompt; required for text-to-video, and passed as needed for image-to-video, start-and-end-frame, and reference-based video generation.\n- `images` (array[string], optional): Image input. Single-image image-to-video uses 1 image; Vidu Q4 reference generation uses 1–15 images, which are used as joint references. For older models, use first-and-last-frame images and reference image counts according to their respective capabilities.\n- `videos` (array[string], optional): Video subject input is available only according to the capabilities of older models; Vidu Q4 does not support reference videos.\n- `subjects` (array[object], optional): Subject-library format input for reference-based video generation; may include fields such as subject name, image, video, or voice timbre.\n- `duration` (integer, optional): Video duration, in seconds. `viduq3-turbo` commonly uses 5 seconds; set it according to the official range.\n- `resolution` (string, optional): Output resolution, common values are `540p`, `720p`, and `1080p`.\n- `aspect_ratio` (string, optional): Output aspect ratio, commonly used for text-to-video/reference-based video generation, such as `16:9`, `9:16`, and `1:1`.\n- `seed` (integer, optional): Random seed.\n- `movement_amplitude` (string, optional): Motion intensity, common values are `auto`, `small`, `medium`, and `large`.\n- `audio` (boolean, optional): Whether to enable direct audio-video output.\n- `audio_urls` (array[string], optional): Reference audio for Vidu Q4. Supports up to 3 MP3 files, each 3–12 seconds and no larger than 50 MB; separate from the `audio` Boolean switch.\n- `off_peak` (boolean, optional): Whether to use staggered generation.\n- `watermark` (boolean, optional): Whether to add a watermark.\n\nCommon model/mode differences:\n- `Vidu 文生视频`: Supports the viduq3-turbo, viduq2, and vidu2.0 models; official-format text-to-video.\n- `Vidu 图生视频`: Supports the viduq3-turbo, viduq2, and vidu2.0 models; official-format single-image image-to-video.\n- `Vidu 首尾帧生视频`: Supports the viduq3-turbo, viduq2, and vidu2.0 models; official-format first-and-last-frame video generation using two images.\n- `Vidu 参考生视频`: Supports the viduq3-turbo, viduq2, and vidu2.0 models; official-format multi-reference image-to-video.","href":"/api-reference/en/video-generation-vidu/create-text-to-video-vidu"}]},{"group":"Video generationHappyHorse and Wan","pages":[{"title":"Create video (HappyHorse and Wan)","openapi":"api-reference/en/openapi.json POST /api/v1/services/aigc/video-generation/video-synthesis","href":"/api-reference/en/video-generationhappyhorse-and-wan/create-video-happyhorse-and-wan"},{"title":"Query task(HappyHorse and Wan)","openapi":"api-reference/en/openapi.json GET /api/v1/tasks/{task_id}","description":"This series supports OpenAI video generation formats (see the link [Video generation Sora compatible formats](/api-reference/en/video-generation-sora-compatible-format/create-video)).\n\nHappyHorse and the Wan video generation API, with public paths following the official DashScope protocol.\n\nHappyHorse supports `happyhorse-1.0`, `happyhorse-1.0-i2v`, `happyhorse-1.0-t2v`, `happyhorse-1.0-r2v`, and `happyhorse-1.0-video-edit`; Wan supports `wan-3.0`, `wan-3.0-480p`, and `wan-3.0-1080p`. Among them, `happyhorse-1.0` is an aggregated model and must be distinguished via `mode` into `t2v`, `i2v`, `r2v`, and `video_edit`. The three Wan models are fixed at 720P, 480P, and 1080P respectively, and support 2 to 30 seconds plus up to 10 image, 5 video, and 5 audio references.\n\nThe public API keeps the official endpoint format; channel-specific prefixes are only concatenated internally when the gateway requests a specific upstream channel. Clients do not need to pass `X-DashScope-Async` explicitly; it is handled by the gateway or the official channel adapter layer.\n\nProvides the public request skeleton, task query structure, and recommended validation template for HappyHorse and Wan video generation formats; public paths follow the official DashScope endpoint format.\n\nSupported models:\nhappyhorse-1.0, happyhorse-1.0-t2v, happyhorse-1.0-i2v, happyhorse-1.0-r2v, happyhorse-1.0-video-edit, wan-3.0, wan-3.0-480p, wan-3.0-1080p\n\nUnified request fields:\n- `model` (string, required): The external model name for HappyHorse or Wan. Wan supports `wan-3.0`, `wan-3.0-480p`, and `wan-3.0-1080p`; the HappyHorse aggregated model `happyhorse-1.0` must be used together with `mode`.\n- `mode` (string, optional): Aggregated model mode; common values are `t2v`, `i2v`, `r2v`, and `video_edit`. You can omit this for fixed submodels.\n- `input.prompt` (string, required): Prompt for video generation or editing.\n- `input.media` (array[object], optional): Multimedia input. Supports `first_frame`, `last_frame`, `reference_image`, `reference_video`, and `reference_audio`; Wan supports up to 10 images, 5 videos, and 5 audio files.\n- `parameters.duration` (integer, optional): Generation duration, in seconds.\n- `parameters.resolution` (string, optional): Output resolution. The three Wan models are fixed at `720P`, `480P`, and `1080P` respectively; common values for HappyHorse are `720P` and `1080P`.\n- `parameters.ratio` (string, optional): Output aspect ratio, commonly used for text-to-video and reference-to-video.\n- `parameters.watermark` (boolean, optional): Whether to add a watermark.\n- `parameters.seed` (integer, optional): Random seed.\n\nCommon model/mode differences:\n- `HappyHorse 聚合模型`: Supports model happyhorse-1.0; the aggregated model uses mode to distinguish the final model.\n- `HappyHorse 文生视频`: Supports model happyhorse-1.0-t2v; official-format text-to-video.\n- `HappyHorse 首帧图生视频`: Supports model happyhorse-1.0-i2v; official-format first-frame image-to-video.\n- `HappyHorse 参考生视频`: Supports model happyhorse-1.0-r2v; official-format multi-reference image-to-video.\n- `HappyHorse 视频编辑`: Supports model happyhorse-1.0-video-edit; official-format video editing.\n- `Wan 3.0 720P`: Supported model wan-3.0; Wan 3.0 official-format multimodal reference video generation.\n- `Wan 3.0 480P`: Supported model wan-3.0-480p; Wan 3.0 official-format call fixed at 480P.\n- `Wan 3.0 1080P`: Supported model wan-3.0-1080p; Wan 3.0 official-format call fixed at 1080P.","href":"/api-reference/en/video-generationhappyhorse-and-wan/query-taskhappyhorse-and-wan"}]}]},{"tab":"Skills","pages":[{"title":"Skills","href":"/en/skills/overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/en/overview"}]}]},{"language":"cn","footer":{"socials":{"telegram":"https://t.me/overseas_api"}},"navbar":{"links":[{"href":"mailto:support@aiid.edu.kg","label":"支持"},{"href":"https://aiid.edu.kg/pricing","label":"价格"}],"primary":{"type":"button","label":"控制台","href":"https://aiid.edu.kg/console"}},"pages":[{"title":"cn","href":"/api-reference/cn/conventions"}]},{"language":"zh-Hant","footer":{"socials":{"telegram":"https://t.me/overseas_api"}},"navbar":{"links":[{"href":"mailto:support@aiid.edu.kg","label":"支援"},{"href":"https://aiid.edu.kg/pricing","label":"價格"}],"primary":{"type":"button","label":"控制台","href":"https://aiid.edu.kg/console"}},"pages":[{"title":"zh-Hant","href":"/api-reference/zh-tw/conventions"}]},{"language":"fr","footer":{"socials":{"telegram":"https://t.me/overseas_api"}},"navbar":{"links":[{"href":"mailto:support@aiid.edu.kg","label":"Support"},{"href":"https://aiid.edu.kg/pricing","label":"Tarifs"}],"primary":{"type":"button","label":"Console","href":"https://aiid.edu.kg/console"}},"pages":[{"title":"fr","href":"/api-reference/fr/conventions"}]},{"language":"ja","footer":{"socials":{"telegram":"https://t.me/overseas_api"}},"navbar":{"links":[{"href":"mailto:support@aiid.edu.kg","label":"サポート"},{"href":"https://aiid.edu.kg/pricing","label":"料金"}],"primary":{"type":"button","label":"コンソール","href":"https://aiid.edu.kg/console"}},"pages":[{"title":"ja","href":"/api-reference/ja/conventions"}]},{"language":"ru","footer":{"socials":{"telegram":"https://t.me/overseas_api"}},"navbar":{"links":[{"href":"mailto:support@aiid.edu.kg","label":"Поддержка"},{"href":"https://aiid.edu.kg/pricing","label":"Тарифы"}],"primary":{"type":"button","label":"Консоль","href":"https://aiid.edu.kg/console"}},"pages":[{"title":"ru","href":"/api-reference/ru/conventions"}]},{"language":"vi","footer":{"socials":{"telegram":"https://t.me/overseas_api"}},"navbar":{"links":[{"href":"mailto:support@aiid.edu.kg","label":"Hỗ trợ"},{"href":"https://aiid.edu.kg/pricing","label":"Bảng giá"}],"primary":{"type":"button","label":"Bảng điều khiển","href":"https://aiid.edu.kg/console"}},"pages":[{"title":"vi","href":"/api-reference/vi/conventions"}]}]},"basePath":"","title":"Create video (HappyHorse and Wan) - OverseasAPI","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}